# suprilkumar/pm-system2 architecture

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

- Interactive diagram: https://gitdiagram.com/suprilkumar/pm-system2
- Repository: https://github.com/suprilkumar/pm-system2

## Overview

This is a Next.js personal workspace with two principal domains: note-taking and personal finance. Users sign in, then manage notes, folders, sharing and trash, or record transactions, organize categories and review dashboards and reports. Route handlers authenticate requests, validate input and delegate domain operations to query modules backed by Prisma. The tree also shows public-note and share-link entry points, settings and profile features. UI-to-API wiring and several unsampled routes are not evidenced in the excerpts, so those connections are omitted.

Main entry points: [`src/core/api/handler.js`](https://github.com/suprilkumar/pm-system2/blob/main/src/core/api/handler.js) (API auth wrapper), [`src/core/api/response.js`](https://github.com/suprilkumar/pm-system2/blob/main/src/core/api/response.js) (API responses), [`src/core/db/client.js`](https://github.com/suprilkumar/pm-system2/blob/main/src/core/db/client.js) (PostgreSQL database), [`src/modules/finance/lib/queries.js`](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/queries.js) (Finance queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and auth"]
  node_workspace_ui["Workspace UI<br/>[AppShell.jsx]"]
  node_app_nav["App navigation<br/>[apps.js]"]
  node_auth_api["Auth API<br/>[route.js]"]
  node_profile_api["Profile API<br/>[route.js]"]
end

subgraph group_notes["Notes"]
  node_notes_ui["Notes workspace"]
  node_notes_api["Notes and folders API"]
  node_folder_api["Folder API<br/>[route.js]"]
  node_share_api["Note sharing API<br/>[route.js]"]
  node_public_note_api["Public note API<br/>[route.js]"]
  node_share_link_api["Share link API<br/>[route.js]"]
  node_note_queries["Note and folder queries<br/>[queries.js]"]
  node_note_validation["Note validation<br/>[validation.js]"]
  node_note_editor["Editor utilities<br/>[editor.js]"]
  node_share_email["Share email<br/>[email.js]"]
end

subgraph group_finance["Finance"]
  node_finance_ui["Finance workspace"]
  node_finance_api["Finance transactions API<br/>[route.js]"]
  node_finance_category_api["Category API<br/>[route.js]"]
  node_finance_dashboard_api["Finance dashboard API<br/>[route.js]"]
  node_finance_monthly_api["Monthly overview API<br/>[route.js]"]
  node_finance_reports_api["Finance reports API<br/>[route.js]"]
  node_finance_queries["Finance queries<br/>[queries.js]"]
  node_finance_validation["Transaction validation<br/>[validation.js]"]
  node_finance_dates["Date ranges<br/>[dates.js]"]
  node_finance_seed["Finance seed data<br/>[seed.js]"]
end

subgraph group_platform["Platform services"]
  node_auth_service["Auth service<br/>[server.js]"]
  node_api_auth["API auth wrapper<br/>[handler.js]"]
  node_session["Current session<br/>[session.js]"]
  node_api_response["API responses<br/>[response.js]"]
  node_database[("PostgreSQL database<br/>[client.js]")]
end

node_user(("User"))

node_user -.->|"uses"| node_workspace_ui
node_workspace_ui -->|"configures navigation"| node_app_nav
node_auth_api -.->|"handles auth"| node_auth_service
node_auth_service -->|"uses Prisma"| node_database
node_api_auth -->|"gets user"| node_session
node_api_auth -->|"returns errors"| node_api_response
node_session -->|"reads session"| node_auth_service
node_notes_api -->|"authenticates"| node_api_auth
node_notes_api -->|"formats response"| node_api_response
node_notes_api -->|"reads and writes"| node_note_queries
node_notes_api -->|"validates input"| node_note_validation
node_folder_api -->|"authenticates"| node_api_auth
node_folder_api -->|"formats response"| node_api_response
node_folder_api -->|"reads and writes"| node_note_queries
node_note_queries -->|"queries"| node_database
node_share_api -->|"authenticates"| node_api_auth
node_share_api -->|"formats response"| node_api_response
node_share_api -->|"reads and writes"| node_database
node_share_api -->|"sends email"| node_share_email
node_share_link_api -->|"reads share"| node_database
node_note_editor -.->|"supports editing"| node_notes_ui
node_finance_api -->|"authenticates"| node_api_auth
node_finance_api -->|"formats response"| node_api_response
node_finance_api -->|"reads and writes"| node_finance_queries
node_finance_api -->|"validates input"| node_finance_validation
node_finance_category_api -->|"authenticates"| node_api_auth
node_finance_category_api -->|"reads and writes"| node_finance_queries
node_finance_dashboard_api -->|"authenticates"| node_api_auth
node_finance_dashboard_api -->|"loads metrics"| node_finance_queries
node_finance_monthly_api -->|"authenticates"| node_api_auth
node_finance_monthly_api -->|"queries monthly data"| node_database
node_finance_reports_api -->|"authenticates"| node_api_auth
node_finance_reports_api -->|"returns cached data"| node_api_response
node_finance_reports_api -->|"aggregates data"| node_finance_queries
node_finance_reports_api -->|"resolves range"| node_finance_dates
node_finance_queries -->|"queries"| node_database

click node_workspace_ui "https://github.com/suprilkumar/pm-system2/blob/main/src/components/layout/AppShell.jsx"
click node_app_nav "https://github.com/suprilkumar/pm-system2/blob/main/src/core/config/apps.js"
click node_auth_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/auth/%5B...all%5D/route.js"
click node_auth_service "https://github.com/suprilkumar/pm-system2/blob/main/src/core/auth/server.js"
click node_api_auth "https://github.com/suprilkumar/pm-system2/blob/main/src/core/api/handler.js"
click node_session "https://github.com/suprilkumar/pm-system2/blob/main/src/core/auth/session.js"
click node_api_response "https://github.com/suprilkumar/pm-system2/blob/main/src/core/api/response.js"
click node_database "https://github.com/suprilkumar/pm-system2/blob/main/src/core/db/client.js"
click node_notes_ui "https://github.com/suprilkumar/pm-system2/tree/main/src/modules/notes/components"
click node_notes_api "https://github.com/suprilkumar/pm-system2/tree/main/src/app/api/notes"
click node_folder_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/folders/route.js"
click node_share_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/notes/share/route.js"
click node_public_note_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/public/notes/%5Bslug%5D/route.js"
click node_share_link_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/shares/%5Btoken%5D/route.js"
click node_note_queries "https://github.com/suprilkumar/pm-system2/blob/main/src/modules/notes/lib/queries.js"
click node_note_validation "https://github.com/suprilkumar/pm-system2/blob/main/src/modules/notes/lib/validation.js"
click node_note_editor "https://github.com/suprilkumar/pm-system2/blob/main/src/modules/notes/lib/editor.js"
click node_share_email "https://github.com/suprilkumar/pm-system2/blob/main/src/modules/notes/lib/email.js"
click node_finance_ui "https://github.com/suprilkumar/pm-system2/tree/main/src/modules/finance/components"
click node_finance_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/transactions/route.js"
click node_finance_category_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/categories/route.js"
click node_finance_dashboard_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/dashboard/route.js"
click node_finance_monthly_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/monthly/route.js"
click node_finance_reports_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/reports/route.js"
click node_finance_queries "https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/queries.js"
click node_finance_validation "https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/validation.js"
click node_finance_dates "https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/dates.js"
click node_finance_seed "https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/seed.js"
click node_profile_api "https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/user/profile/route.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_workspace_ui,node_app_nav,node_auth_api,node_profile_api,node_user toneBlue
class node_notes_ui,node_notes_api,node_folder_api,node_share_api,node_public_note_api,node_share_link_api,node_note_queries,node_note_validation,node_note_editor,node_share_email toneAmber
class node_finance_ui,node_finance_api,node_finance_category_api,node_finance_dashboard_api,node_finance_monthly_api,node_finance_reports_api,node_finance_queries,node_finance_validation,node_finance_dates,node_finance_seed toneMint
class node_auth_service,node_api_auth,node_session,node_api_response,node_database toneRose
```

## Components

### Workspace and auth

- [Workspace UI](https://github.com/suprilkumar/pm-system2/blob/main/src/components/layout/AppShell.jsx): `src/components/layout/AppShell.jsx`
- [App navigation](https://github.com/suprilkumar/pm-system2/blob/main/src/core/config/apps.js): `src/core/config/apps.js`
- [Auth API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/auth/%5B...all%5D/route.js): `src/app/api/auth/[...all]/route.js`
- [Profile API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/user/profile/route.js): `src/app/api/user/profile/route.js`

### Notes

- [Notes workspace](https://github.com/suprilkumar/pm-system2/tree/main/src/modules/notes/components): `src/modules/notes/components`
- [Notes and folders API](https://github.com/suprilkumar/pm-system2/tree/main/src/app/api/notes): `src/app/api/notes`
- [Folder API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/folders/route.js): `src/app/api/folders/route.js`
- [Note sharing API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/notes/share/route.js): `src/app/api/notes/share/route.js`
- [Public note API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/public/notes/%5Bslug%5D/route.js): `src/app/api/public/notes/[slug]/route.js`
- [Share link API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/shares/%5Btoken%5D/route.js): `src/app/api/shares/[token]/route.js`
- [Note and folder queries](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/notes/lib/queries.js): `src/modules/notes/lib/queries.js`
- [Note validation](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/notes/lib/validation.js): `src/modules/notes/lib/validation.js`
- [Editor utilities](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/notes/lib/editor.js): `src/modules/notes/lib/editor.js`
- [Share email](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/notes/lib/email.js): `src/modules/notes/lib/email.js`

### Finance

- [Finance workspace](https://github.com/suprilkumar/pm-system2/tree/main/src/modules/finance/components): `src/modules/finance/components`
- [Finance transactions API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/transactions/route.js): `src/app/api/finance/transactions/route.js`
- [Category API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/categories/route.js): `src/app/api/finance/categories/route.js`
- [Finance dashboard API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/dashboard/route.js): `src/app/api/finance/dashboard/route.js`
- [Monthly overview API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/monthly/route.js): `src/app/api/finance/monthly/route.js`
- [Finance reports API](https://github.com/suprilkumar/pm-system2/blob/main/src/app/api/finance/reports/route.js): `src/app/api/finance/reports/route.js`
- [Finance queries](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/queries.js): `src/modules/finance/lib/queries.js`
- [Transaction validation](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/validation.js): `src/modules/finance/lib/validation.js`
- [Date ranges](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/dates.js): `src/modules/finance/lib/dates.js`
- [Finance seed data](https://github.com/suprilkumar/pm-system2/blob/main/src/modules/finance/lib/seed.js): `src/modules/finance/lib/seed.js`

### Platform services

- [Auth service](https://github.com/suprilkumar/pm-system2/blob/main/src/core/auth/server.js): `src/core/auth/server.js`
- [API auth wrapper](https://github.com/suprilkumar/pm-system2/blob/main/src/core/api/handler.js): `src/core/api/handler.js`
- [Current session](https://github.com/suprilkumar/pm-system2/blob/main/src/core/auth/session.js): `src/core/auth/session.js`
- [API responses](https://github.com/suprilkumar/pm-system2/blob/main/src/core/api/response.js): `src/core/api/response.js`
- [PostgreSQL database](https://github.com/suprilkumar/pm-system2/blob/main/src/core/db/client.js): `src/core/db/client.js`

### Other components

- **User**

## Connections

- User → Workspace UI: uses
- Workspace UI → App navigation: configures navigation (evidence: `src/core/config/apps.js`)
- Auth API → Auth service: handles auth
- Auth service → PostgreSQL database: uses Prisma (evidence: `src/core/auth/server.js`)
- API auth wrapper → Current session: gets user (evidence: `src/core/api/handler.js`)
- API auth wrapper → API responses: returns errors (evidence: `src/core/api/handler.js`)
- Current session → Auth service: reads session (evidence: `src/core/auth/session.js`)
- Notes and folders API → API auth wrapper: authenticates (evidence: `src/app/api/notes/route.js`)
- Notes and folders API → API responses: formats response (evidence: `src/app/api/notes/route.js`)
- Notes and folders API → Note and folder queries: reads and writes (evidence: `src/app/api/notes/route.js`)
- Notes and folders API → Note validation: validates input (evidence: `src/app/api/notes/route.js`)
- Folder API → API auth wrapper: authenticates (evidence: `src/app/api/folders/route.js`)
- Folder API → API responses: formats response (evidence: `src/app/api/folders/route.js`)
- Folder API → Note and folder queries: reads and writes (evidence: `src/app/api/folders/route.js`)
- Note and folder queries → PostgreSQL database: queries (evidence: `src/modules/notes/lib/queries.js`)
- Note sharing API → API auth wrapper: authenticates (evidence: `src/app/api/notes/share/route.js`)
- Note sharing API → API responses: formats response (evidence: `src/app/api/notes/share/route.js`)
- Note sharing API → PostgreSQL database: reads and writes (evidence: `src/app/api/notes/share/route.js`)
- Note sharing API → Share email: sends email (evidence: `src/app/api/notes/share/route.js`)
- Share link API → PostgreSQL database: reads share (evidence: `src/app/api/shares/[token]/route.js`)
- Editor utilities → Notes workspace: supports editing
- Finance transactions API → API auth wrapper: authenticates (evidence: `src/app/api/finance/transactions/route.js`)
- Finance transactions API → API responses: formats response (evidence: `src/app/api/finance/transactions/route.js`)
- Finance transactions API → Finance queries: reads and writes (evidence: `src/app/api/finance/transactions/route.js`)
- Finance transactions API → Transaction validation: validates input (evidence: `src/app/api/finance/transactions/route.js`)
- Category API → API auth wrapper: authenticates (evidence: `src/app/api/finance/categories/route.js`)
- Category API → Finance queries: reads and writes (evidence: `src/app/api/finance/categories/route.js`)
- Finance dashboard API → API auth wrapper: authenticates (evidence: `src/app/api/finance/dashboard/route.js`)
- Finance dashboard API → Finance queries: loads metrics (evidence: `src/app/api/finance/dashboard/route.js`)
- Monthly overview API → API auth wrapper: authenticates (evidence: `src/app/api/finance/monthly/route.js`)
- Monthly overview API → PostgreSQL database: queries monthly data (evidence: `src/app/api/finance/monthly/route.js`)
- Finance reports API → API auth wrapper: authenticates (evidence: `src/app/api/finance/reports/route.js`)
- Finance reports API → API responses: returns cached data (evidence: `src/app/api/finance/reports/route.js`)
- Finance reports API → Finance queries: aggregates data (evidence: `src/app/api/finance/reports/route.js`)
- Finance reports API → Date ranges: resolves range (evidence: `src/app/api/finance/reports/route.js`)
- Finance queries → PostgreSQL database: queries (evidence: `src/modules/finance/lib/queries.js`)
