How aruncse-dev/management-system works
This monorepo provides FinTracker financial tracking, Vault secure-record storage, Staff attendance, and a platform-admin console. Users sign in, use an app’s domain pages, and interact with its API; the documented backend uses shared packages and Neon Postgres. The graph retains the major product areas and key internal layers. Most app routes and domain implementations were not sampled, so their detailed calls and data flow are not asserted.
Main entry points: pages Finance Workspace · next-handlers.ts Session and OAuth · neon.ts Neon Database · api Finance API Routes
Components 23
FinTracker
- Finance Workspace
packages/apps/fintracker/src/pages - Budgets
packages/apps/fintracker/src/pages/budget.tsx - Transactions
packages/apps/fintracker/src/pages/transactions.tsx - Investments
packages/apps/fintracker/src/pages/investments.tsx - Loans
packages/apps/fintracker/src/pages/loans.tsx - Savings
packages/apps/fintracker/src/pages/savings.tsx - Gold
packages/apps/fintracker/src/pages/gold.tsx - Finance API Client
packages/apps/fintracker/src/api.ts - Finance API Routes
packages/apps/fintracker/src/pages/api
Vault
- Vault Workspace
packages/apps/vault/src/pages - Vault Records
packages/shared/db/src/vaultRecords.ts
Staff
- Staff Workspace
packages/apps/staff/src/pages - Attendance
packages/apps/staff/src/pages/attendance.tsx - Staff API
packages/apps/staff/src/api.ts
Platform Admin
- Admin Console
packages/apps/admin/src/pages/admin - Admin API Routes
packages/apps/admin/src/pages/api/admin
Shared Platform
- Vault Schema
packages/shared/db/src/schema/vault.ts - Session and OAuth
packages/shared/auth/src/next-handlers.ts - Neon Database
packages/shared/db/src/neon.ts - Users and Organizations
packages/shared/db/src/authUsers.ts
Other components
- User
- Google OAuth
- Neon Postgres
Connections 25
- User → Finance Workspace: uses
- Finance Workspace → Finance API Client: requests data
- Finance API Client → Finance API Routes: calls API
- Finance API Routes → Neon Database: uses backend
- User → Vault Workspace: uses
- Vault Workspace → Vault Records: stores records
- Vault Records → Vault Schema: uses schema
- User → Staff Workspace: uses
- Staff Workspace → Staff API: requests data
- Staff Workspace → Attendance: tracks attendance
- User → Admin Console: uses
- Admin Console → Admin API Routes: manages organizations
- Admin API Routes → Neon Database: uses backend
- Finance API Routes → Session and OAuth: checks sessions
- Staff API → Session and OAuth: checks sessions
- Admin API Routes → Session and OAuth: checks admin sessions
- Session and OAuth → Google OAuth: verifies credentials
packages/shared/auth/src/next-handlers.ts - Neon Database → Neon Postgres: connects to
- Finance Workspace → Budgets: includes
- Finance Workspace → Transactions: includes
- Finance Workspace → Investments: includes
- Finance Workspace → Loans: includes
- Finance Workspace → Savings: includes
- Finance Workspace → Gold: includes
- Users and Organizations → Neon Database: queries
packages/shared/db/src/authUsers.ts