# jeypydc02-ui/sia-final-project architecture

> Architecture diagram of the GitHub repository jeypydc02-ui/sia-final-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jeypydc02-ui/sia-final-project
- Repository: https://github.com/jeypydc02-ui/sia-final-project

## Overview

FinTrack Stark is a finance-records and bill-management application. Users sign in, view their dashboard, manage bills and budgets, submit income or expenses for review, and track payments, comments, notifications, and history. Admins manage users and roles; reviewers decide pending submissions. The browser client calls the Express API, whose domain controllers use MongoDB-backed models. A separate reminder worker scans shared bill data and writes alerts. Several screen and route implementations were not sampled, so those branches reflect only documented or indexed wiring.

Main entry points: [`apps/server/src/controllers`](https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/server/src/controllers) (Finance workflows), [`apps/client/src/App.jsx`](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/App.jsx) (Client router), [`apps/server/src/controllers/authController.js`](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/controllers/authController.js) (Authentication workflow), [`services/reminder/src/reminderJob.js`](https://github.com/jeypydc02-ui/sia-final-project/blob/main/services/reminder/src/reminderJob.js) (Bill reminder sweep)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser client"]
  node_client_app["Client router<br/>[App.jsx]"]
  node_navigation["Navigation config<br/>[nav.js]"]
  node_finance_screens["Finance screens"]
  node_review_screens["Review screens<br/>[ReviewApproval.jsx]"]
  node_admin_screens["Admin and reports<br/>[UserManagement.jsx]"]
  node_client_api["API client<br/>[api.js]"]
end

subgraph group_api["API and workflows"]
  node_server["HTTP server<br/>[server.js]"]
  node_routes["API route modules"]
  node_auth_route["Authentication route<br/>[auth.js]"]
  node_auth_controller["Authentication workflow<br/>[authController.js]"]
  node_finance_controllers["Finance workflows"]
  node_user_controller["User administration<br/>[userController.js]"]
end

subgraph group_data["Persistence and services"]
  node_transaction_model["Transactions<br/>[Transaction.js]"]
  node_bill_model["Bills<br/>[Bill.js]"]
  node_budget_model["Budgets<br/>[Budget.js]"]
  node_support_models["Comments and alerts"]
  node_user_model["User accounts<br/>[User.js]"]
  node_session_service["Session service<br/>[sessions.js]"]
  node_session_model["Persisted sessions<br/>[Session.js]"]
  node_audit_service["Audit and notifications<br/>[audit.js]"]
  node_audit_model["Audit records<br/>[AuditLog.js]"]
  node_date_utils["Calendar date rules<br/>[dates.js]"]
  node_validation["Input validation<br/>[validate.js]"]
  node_db[("MongoDB connection<br/>[db.js]")]
end

subgraph group_worker["Reminder worker"]
  node_reminder_entry["Reminder service entry<br/>[index.js]"]
  node_reminder_job["Bill reminder sweep<br/>[reminderJob.js]"]
end

node_user(("Finance user"))

node_user -->|"uses"| node_client_app
node_client_app -->|"uses routes"| node_navigation
node_client_app -->|"renders"| node_finance_screens
node_client_app -->|"renders"| node_review_screens
node_client_app -->|"renders"| node_admin_screens
node_client_app -->|"calls"| node_client_api
node_client_api -.->|"HTTP requests"| node_server
node_server -->|"connects"| node_db
node_server -->|"mounts"| node_routes
node_server -->|"mounts"| node_auth_route
node_auth_route -->|"routes to"| node_auth_controller
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"manages sessions"| node_session_service
node_auth_controller -->|"logs events"| node_audit_service
node_auth_controller -->|"validates input"| node_validation
node_session_service -->|"persists sessions"| node_session_model
node_finance_controllers -->|"uses transactions"| node_transaction_model
node_finance_controllers -->|"uses bills"| node_bill_model
node_finance_controllers -->|"uses budgets"| node_budget_model
node_finance_controllers -->|"uses comments"| node_support_models
node_finance_controllers -->|"records actions"| node_audit_service
node_finance_controllers -->|"uses dates"| node_date_utils
node_finance_controllers -->|"validates input"| node_validation
node_user_controller -->|"manages accounts"| node_user_model
node_user_controller -.->|"cleans user records"| node_finance_controllers
node_user_controller -->|"refreshes sessions"| node_session_service
node_user_controller -->|"logs changes"| node_audit_service
node_audit_service -->|"writes audit entries"| node_audit_model
node_audit_service -->|"writes notifications"| node_support_models
node_reminder_entry -->|"connects"| node_db
node_reminder_entry -->|"runs sweep"| node_reminder_job
node_reminder_job -->|"scans and updates"| node_bill_model
node_reminder_job -->|"inserts alerts"| node_support_models
node_reminder_job -->|"records sweep"| node_audit_model
node_reminder_job -->|"calculates due dates"| node_date_utils

click node_client_app "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/App.jsx"
click node_navigation "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/lib/nav.js"
click node_finance_screens "https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/client/src/screens"
click node_review_screens "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/screens/ReviewApproval.jsx"
click node_admin_screens "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/screens/UserManagement.jsx"
click node_client_api "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/lib/api.js"
click node_server "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/server.js"
click node_routes "https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/server/src/routes"
click node_auth_route "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/routes/auth.js"
click node_auth_controller "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/controllers/authController.js"
click node_finance_controllers "https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/server/src/controllers"
click node_user_controller "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/controllers/userController.js"
click node_transaction_model "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/Transaction.js"
click node_bill_model "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/Bill.js"
click node_budget_model "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/Budget.js"
click node_support_models "https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/server/src/models"
click node_user_model "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/User.js"
click node_session_service "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/services/sessions.js"
click node_session_model "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/Session.js"
click node_audit_service "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/services/audit.js"
click node_audit_model "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/AuditLog.js"
click node_date_utils "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/utils/dates.js"
click node_validation "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/utils/validate.js"
click node_db "https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/config/db.js"
click node_reminder_entry "https://github.com/jeypydc02-ui/sia-final-project/blob/main/services/reminder/index.js"
click node_reminder_job "https://github.com/jeypydc02-ui/sia-final-project/blob/main/services/reminder/src/reminderJob.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client_app,node_navigation,node_finance_screens,node_review_screens,node_admin_screens,node_client_api,node_user toneBlue
class node_server,node_routes,node_auth_route,node_auth_controller,node_finance_controllers,node_user_controller toneAmber
class node_transaction_model,node_bill_model,node_budget_model,node_support_models,node_user_model,node_session_service,node_session_model,node_audit_service,node_audit_model,node_date_utils,node_validation,node_db toneMint
class node_reminder_entry,node_reminder_job toneRose
```

## Components

### Browser client

- [Client router](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/App.jsx): `apps/client/src/App.jsx`
- [Navigation config](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/lib/nav.js): `apps/client/src/lib/nav.js`
- [Finance screens](https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/client/src/screens): `apps/client/src/screens`
- [Review screens](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/screens/ReviewApproval.jsx): `apps/client/src/screens/ReviewApproval.jsx`
- [Admin and reports](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/screens/UserManagement.jsx): `apps/client/src/screens/UserManagement.jsx`
- [API client](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/client/src/lib/api.js): `apps/client/src/lib/api.js`

### API and workflows

- [HTTP server](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/server.js): `apps/server/server.js`
- [API route modules](https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/server/src/routes): `apps/server/src/routes`
- [Authentication route](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/routes/auth.js): `apps/server/src/routes/auth.js`
- [Authentication workflow](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/controllers/authController.js): `apps/server/src/controllers/authController.js`
- [Finance workflows](https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/server/src/controllers): `apps/server/src/controllers`
- [User administration](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/controllers/userController.js): `apps/server/src/controllers/userController.js`

### Persistence and services

- [Transactions](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/Transaction.js): `apps/server/src/models/Transaction.js`
- [Bills](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/Bill.js): `apps/server/src/models/Bill.js`
- [Budgets](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/Budget.js): `apps/server/src/models/Budget.js`
- [Comments and alerts](https://github.com/jeypydc02-ui/sia-final-project/tree/main/apps/server/src/models): `apps/server/src/models`
- [User accounts](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/User.js): `apps/server/src/models/User.js`
- [Session service](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/services/sessions.js): `apps/server/src/services/sessions.js`
- [Persisted sessions](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/Session.js): `apps/server/src/models/Session.js`
- [Audit and notifications](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/services/audit.js): `apps/server/src/services/audit.js`
- [Audit records](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/models/AuditLog.js): `apps/server/src/models/AuditLog.js`
- [Calendar date rules](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/utils/dates.js): `apps/server/src/utils/dates.js`
- [Input validation](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/utils/validate.js): `apps/server/src/utils/validate.js`
- [MongoDB connection](https://github.com/jeypydc02-ui/sia-final-project/blob/main/apps/server/src/config/db.js): `apps/server/src/config/db.js`

### Reminder worker

- [Reminder service entry](https://github.com/jeypydc02-ui/sia-final-project/blob/main/services/reminder/index.js): `services/reminder/index.js`
- [Bill reminder sweep](https://github.com/jeypydc02-ui/sia-final-project/blob/main/services/reminder/src/reminderJob.js): `services/reminder/src/reminderJob.js`

### Other components

- **Finance user**

## Connections

- Finance user → Client router: uses
- Client router → Navigation config: uses routes (evidence: `apps/client/src/App.jsx`)
- Client router → Finance screens: renders (evidence: `apps/client/src/App.jsx`)
- Client router → Review screens: renders (evidence: `apps/client/src/App.jsx`)
- Client router → Admin and reports: renders (evidence: `apps/client/src/App.jsx`)
- Client router → API client: calls (evidence: `apps/client/src/App.jsx`)
- API client → HTTP server: HTTP requests
- HTTP server → MongoDB connection: connects (evidence: `apps/server/server.js`)
- HTTP server → API route modules: mounts (evidence: `apps/server/server.js`)
- HTTP server → Authentication route: mounts (evidence: `apps/server/server.js`)
- Authentication route → Authentication workflow: routes to (evidence: `apps/server/src/routes/auth.js`)
- Authentication workflow → User accounts: reads and writes (evidence: `apps/server/src/controllers/authController.js`)
- Authentication workflow → Session service: manages sessions (evidence: `apps/server/src/controllers/authController.js`)
- Authentication workflow → Audit and notifications: logs events (evidence: `apps/server/src/controllers/authController.js`)
- Authentication workflow → Input validation: validates input (evidence: `apps/server/src/controllers/authController.js`)
- Session service → Persisted sessions: persists sessions (evidence: `apps/server/src/services/sessions.js`)
- Finance workflows → Transactions: uses transactions (evidence: `apps/server/src/controllers/transactionController.js`)
- Finance workflows → Bills: uses bills (evidence: `apps/server/src/controllers/billController.js`)
- Finance workflows → Budgets: uses budgets (evidence: `apps/server/src/controllers/budgetController.js`)
- Finance workflows → Comments and alerts: uses comments (evidence: `apps/server/src/controllers/commentController.js`)
- Finance workflows → Audit and notifications: records actions (evidence: `apps/server/src/controllers/transactionController.js`)
- Finance workflows → Calendar date rules: uses dates (evidence: `apps/server/src/controllers/transactionController.js`)
- Finance workflows → Input validation: validates input (evidence: `apps/server/src/controllers/transactionController.js`)
- User administration → User accounts: manages accounts (evidence: `apps/server/src/controllers/userController.js`)
- User administration → Finance workflows: cleans user records
- User administration → Session service: refreshes sessions (evidence: `apps/server/src/controllers/userController.js`)
- User administration → Audit and notifications: logs changes (evidence: `apps/server/src/controllers/userController.js`)
- Audit and notifications → Audit records: writes audit entries (evidence: `apps/server/src/services/audit.js`)
- Audit and notifications → Comments and alerts: writes notifications (evidence: `apps/server/src/services/audit.js`)
- Reminder service entry → MongoDB connection: connects (evidence: `services/reminder/index.js`)
- Reminder service entry → Bill reminder sweep: runs sweep (evidence: `services/reminder/index.js`)
- Bill reminder sweep → Bills: scans and updates (evidence: `services/reminder/src/reminderJob.js`)
- Bill reminder sweep → Comments and alerts: inserts alerts (evidence: `services/reminder/src/reminderJob.js`)
- Bill reminder sweep → Audit records: records sweep (evidence: `services/reminder/src/reminderJob.js`)
- Bill reminder sweep → Calendar date rules: calculates due dates (evidence: `services/reminder/src/reminderJob.js`)
