How jeypydc02-ui/sia-final-project works
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: controllers Finance workflows · App.jsx Client router · authController.js Authentication workflow · reminderJob.js Bill reminder sweep
Components 27
Browser client
- Client router
apps/client/src/App.jsx - Navigation config
apps/client/src/lib/nav.js - Finance screens
apps/client/src/screens - Review screens
apps/client/src/screens/ReviewApproval.jsx - Admin and reports
apps/client/src/screens/UserManagement.jsx - API client
apps/client/src/lib/api.js
API and workflows
- HTTP server
apps/server/server.js - API route modules
apps/server/src/routes - Authentication route
apps/server/src/routes/auth.js - Authentication workflow
apps/server/src/controllers/authController.js - Finance workflows
apps/server/src/controllers - User administration
apps/server/src/controllers/userController.js
Persistence and services
- Transactions
apps/server/src/models/Transaction.js - Bills
apps/server/src/models/Bill.js - Budgets
apps/server/src/models/Budget.js - Comments and alerts
apps/server/src/models - User accounts
apps/server/src/models/User.js - Session service
apps/server/src/services/sessions.js - Persisted sessions
apps/server/src/models/Session.js - Audit and notifications
apps/server/src/services/audit.js - Audit records
apps/server/src/models/AuditLog.js - Calendar date rules
apps/server/src/utils/dates.js - Input validation
apps/server/src/utils/validate.js - MongoDB connection
apps/server/src/config/db.js
Reminder worker
- Reminder service entry
services/reminder/index.js - Bill reminder sweep
services/reminder/src/reminderJob.js
Other components
- Finance user
Connections 35
- Finance user → Client router: uses
- Client router → Navigation config: uses routes
apps/client/src/App.jsx - Client router → Finance screens: renders
apps/client/src/App.jsx - Client router → Review screens: renders
apps/client/src/App.jsx - Client router → Admin and reports: renders
apps/client/src/App.jsx - Client router → API client: calls
apps/client/src/App.jsx - API client → HTTP server: HTTP requests
- HTTP server → MongoDB connection: connects
apps/server/server.js - HTTP server → API route modules: mounts
apps/server/server.js - HTTP server → Authentication route: mounts
apps/server/server.js - Authentication route → Authentication workflow: routes to
apps/server/src/routes/auth.js - Authentication workflow → User accounts: reads and writes
apps/server/src/controllers/authController.js - Authentication workflow → Session service: manages sessions
apps/server/src/controllers/authController.js - Authentication workflow → Audit and notifications: logs events
apps/server/src/controllers/authController.js - Authentication workflow → Input validation: validates input
apps/server/src/controllers/authController.js - Session service → Persisted sessions: persists sessions
apps/server/src/services/sessions.js - Finance workflows → Transactions: uses transactions
apps/server/src/controllers/transactionController.js - Finance workflows → Bills: uses bills
apps/server/src/controllers/billController.js - Finance workflows → Budgets: uses budgets
apps/server/src/controllers/budgetController.js - Finance workflows → Comments and alerts: uses comments
apps/server/src/controllers/commentController.js - Finance workflows → Audit and notifications: records actions
apps/server/src/controllers/transactionController.js - Finance workflows → Calendar date rules: uses dates
apps/server/src/controllers/transactionController.js - Finance workflows → Input validation: validates input
apps/server/src/controllers/transactionController.js - User administration → User accounts: manages accounts
apps/server/src/controllers/userController.js - User administration → Finance workflows: cleans user records
- User administration → Session service: refreshes sessions
apps/server/src/controllers/userController.js - User administration → Audit and notifications: logs changes
apps/server/src/controllers/userController.js - Audit and notifications → Audit records: writes audit entries
apps/server/src/services/audit.js - Audit and notifications → Comments and alerts: writes notifications
apps/server/src/services/audit.js - Reminder service entry → MongoDB connection: connects
services/reminder/index.js - Reminder service entry → Bill reminder sweep: runs sweep
services/reminder/index.js - Bill reminder sweep → Bills: scans and updates
services/reminder/src/reminderJob.js - Bill reminder sweep → Comments and alerts: inserts alerts
services/reminder/src/reminderJob.js - Bill reminder sweep → Audit records: records sweep
services/reminder/src/reminderJob.js - Bill reminder sweep → Calendar date rules: calculates due dates
services/reminder/src/reminderJob.js