# aruncse-dev/management-system architecture

> Architecture diagram of the GitHub repository aruncse-dev/management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aruncse-dev/management-system
- Repository: https://github.com/aruncse-dev/management-system

## Overview

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: [`packages/apps/fintracker/src/pages`](https://github.com/aruncse-dev/management-system/tree/main/packages/apps/fintracker/src/pages) (Finance Workspace), [`packages/shared/auth/src/next-handlers.ts`](https://github.com/aruncse-dev/management-system/blob/main/packages/shared/auth/src/next-handlers.ts) (Session and OAuth), [`packages/shared/db/src/neon.ts`](https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/neon.ts) (Neon Database), [`packages/apps/fintracker/src/pages/api`](https://github.com/aruncse-dev/management-system/tree/main/packages/apps/fintracker/src/pages/api) (Finance API Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fintracker["FinTracker"]
  node_fin_ui["Finance Workspace"]
  node_fin_budget["Budgets<br/>[budget.tsx]"]
  node_fin_transactions["Transactions<br/>[transactions.tsx]"]
  node_fin_investments["Investments<br/>[investments.tsx]"]
  node_fin_loans["Loans<br/>[loans.tsx]"]
  node_fin_savings["Savings<br/>[savings.tsx]"]
  node_fin_gold["Gold<br/>[gold.tsx]"]
  node_fin_api["Finance API Client<br/>[api.ts]"]
  node_fin_routes["Finance API Routes"]
end

subgraph group_vault["Vault"]
  node_vault_ui["Vault Workspace"]
  node_vault_records["Vault Records<br/>[vaultRecords.ts]"]
end

subgraph group_staff["Staff"]
  node_staff_ui["Staff Workspace"]
  node_staff_attendance["Attendance<br/>[attendance.tsx]"]
  node_staff_api["Staff API<br/>[api.ts]"]
end

subgraph group_admin["Platform Admin"]
  node_admin_ui["Admin Console"]
  node_admin_routes["Admin API Routes"]
end

subgraph group_shared["Shared Platform"]
  node_vault_schema["Vault Schema<br/>[vault.ts]"]
  node_auth["Session and OAuth<br/>[next-handlers.ts]"]
  node_db[("Neon Database<br/>[neon.ts]")]
  node_org_auth_db["Users and Organizations<br/>[authUsers.ts]"]
end

node_user(("User"))
node_google(("Google OAuth"))
node_neon[("Neon Postgres")]

node_user -->|"uses"| node_fin_ui
node_fin_ui -->|"requests data"| node_fin_api
node_fin_api -->|"calls API"| node_fin_routes
node_fin_routes -->|"uses backend"| node_db
node_user -->|"uses"| node_vault_ui
node_vault_ui -.->|"stores records"| node_vault_records
node_vault_records -.->|"uses schema"| node_vault_schema
node_user -->|"uses"| node_staff_ui
node_staff_ui -->|"requests data"| node_staff_api
node_staff_ui -->|"tracks attendance"| node_staff_attendance
node_user -->|"uses"| node_admin_ui
node_admin_ui -->|"manages organizations"| node_admin_routes
node_admin_routes -->|"uses backend"| node_db
node_fin_routes -.->|"checks sessions"| node_auth
node_staff_api -.->|"checks sessions"| node_auth
node_admin_routes -.->|"checks admin sessions"| node_auth
node_auth -->|"verifies credentials"| node_google
node_db -->|"connects to"| node_neon
node_fin_ui -->|"includes"| node_fin_budget
node_fin_ui -->|"includes"| node_fin_transactions
node_fin_ui -->|"includes"| node_fin_investments
node_fin_ui -->|"includes"| node_fin_loans
node_fin_ui -->|"includes"| node_fin_savings
node_fin_ui -->|"includes"| node_fin_gold
node_org_auth_db -->|"queries"| node_db

click node_fin_ui "https://github.com/aruncse-dev/management-system/tree/main/packages/apps/fintracker/src/pages"
click node_fin_budget "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/budget.tsx"
click node_fin_transactions "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/transactions.tsx"
click node_fin_investments "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/investments.tsx"
click node_fin_loans "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/loans.tsx"
click node_fin_savings "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/savings.tsx"
click node_fin_gold "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/gold.tsx"
click node_fin_api "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/api.ts"
click node_fin_routes "https://github.com/aruncse-dev/management-system/tree/main/packages/apps/fintracker/src/pages/api"
click node_vault_ui "https://github.com/aruncse-dev/management-system/tree/main/packages/apps/vault/src/pages"
click node_vault_records "https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/vaultRecords.ts"
click node_vault_schema "https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/schema/vault.ts"
click node_staff_ui "https://github.com/aruncse-dev/management-system/tree/main/packages/apps/staff/src/pages"
click node_staff_attendance "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/staff/src/pages/attendance.tsx"
click node_staff_api "https://github.com/aruncse-dev/management-system/blob/main/packages/apps/staff/src/api.ts"
click node_admin_ui "https://github.com/aruncse-dev/management-system/tree/main/packages/apps/admin/src/pages/admin"
click node_admin_routes "https://github.com/aruncse-dev/management-system/tree/main/packages/apps/admin/src/pages/api/admin"
click node_auth "https://github.com/aruncse-dev/management-system/blob/main/packages/shared/auth/src/next-handlers.ts"
click node_db "https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/neon.ts"
click node_org_auth_db "https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/authUsers.ts"

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_fin_ui,node_fin_budget,node_fin_transactions,node_fin_investments,node_fin_loans,node_fin_savings,node_fin_gold,node_fin_api,node_fin_routes,node_user toneBlue
class node_vault_ui,node_vault_records,node_neon toneAmber
class node_staff_ui,node_staff_attendance,node_staff_api toneMint
class node_admin_ui,node_admin_routes toneRose
class node_vault_schema,node_auth,node_db,node_org_auth_db,node_google toneIndigo
```

## Components

### FinTracker

- [Finance Workspace](https://github.com/aruncse-dev/management-system/tree/main/packages/apps/fintracker/src/pages): `packages/apps/fintracker/src/pages`
- [Budgets](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/budget.tsx): `packages/apps/fintracker/src/pages/budget.tsx`
- [Transactions](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/transactions.tsx): `packages/apps/fintracker/src/pages/transactions.tsx`
- [Investments](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/investments.tsx): `packages/apps/fintracker/src/pages/investments.tsx`
- [Loans](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/loans.tsx): `packages/apps/fintracker/src/pages/loans.tsx`
- [Savings](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/savings.tsx): `packages/apps/fintracker/src/pages/savings.tsx`
- [Gold](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/pages/gold.tsx): `packages/apps/fintracker/src/pages/gold.tsx`
- [Finance API Client](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/fintracker/src/api.ts): `packages/apps/fintracker/src/api.ts`
- [Finance API Routes](https://github.com/aruncse-dev/management-system/tree/main/packages/apps/fintracker/src/pages/api): `packages/apps/fintracker/src/pages/api`

### Vault

- [Vault Workspace](https://github.com/aruncse-dev/management-system/tree/main/packages/apps/vault/src/pages): `packages/apps/vault/src/pages`
- [Vault Records](https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/vaultRecords.ts): `packages/shared/db/src/vaultRecords.ts`

### Staff

- [Staff Workspace](https://github.com/aruncse-dev/management-system/tree/main/packages/apps/staff/src/pages): `packages/apps/staff/src/pages`
- [Attendance](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/staff/src/pages/attendance.tsx): `packages/apps/staff/src/pages/attendance.tsx`
- [Staff API](https://github.com/aruncse-dev/management-system/blob/main/packages/apps/staff/src/api.ts): `packages/apps/staff/src/api.ts`

### Platform Admin

- [Admin Console](https://github.com/aruncse-dev/management-system/tree/main/packages/apps/admin/src/pages/admin): `packages/apps/admin/src/pages/admin`
- [Admin API Routes](https://github.com/aruncse-dev/management-system/tree/main/packages/apps/admin/src/pages/api/admin): `packages/apps/admin/src/pages/api/admin`

### Shared Platform

- [Vault Schema](https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/schema/vault.ts): `packages/shared/db/src/schema/vault.ts`
- [Session and OAuth](https://github.com/aruncse-dev/management-system/blob/main/packages/shared/auth/src/next-handlers.ts): `packages/shared/auth/src/next-handlers.ts`
- [Neon Database](https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/neon.ts): `packages/shared/db/src/neon.ts`
- [Users and Organizations](https://github.com/aruncse-dev/management-system/blob/main/packages/shared/db/src/authUsers.ts): `packages/shared/db/src/authUsers.ts`

### Other components

- **User**
- **Google OAuth**
- **Neon Postgres**

## Connections

- 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 (evidence: `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 (evidence: `packages/shared/db/src/authUsers.ts`)
