How suprilkumar/pm-system2 works
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: handler.js API auth wrapper · response.js API responses · client.js PostgreSQL database · queries.js Finance queries
Components 30
Workspace and auth
- Workspace UI
src/components/layout/AppShell.jsx - App navigation
src/core/config/apps.js - Auth API
src/app/api/auth/[...all]/route.js - Profile API
src/app/api/user/profile/route.js
Notes
- Notes workspace
src/modules/notes/components - Notes and folders API
src/app/api/notes - Folder API
src/app/api/folders/route.js - Note sharing API
src/app/api/notes/share/route.js - Public note API
src/app/api/public/notes/[slug]/route.js - Share link API
src/app/api/shares/[token]/route.js - Note and folder queries
src/modules/notes/lib/queries.js - Note validation
src/modules/notes/lib/validation.js - Editor utilities
src/modules/notes/lib/editor.js - Share email
src/modules/notes/lib/email.js
Finance
- Finance workspace
src/modules/finance/components - Finance transactions API
src/app/api/finance/transactions/route.js - Category API
src/app/api/finance/categories/route.js - Finance dashboard API
src/app/api/finance/dashboard/route.js - Monthly overview API
src/app/api/finance/monthly/route.js - Finance reports API
src/app/api/finance/reports/route.js - Finance queries
src/modules/finance/lib/queries.js - Transaction validation
src/modules/finance/lib/validation.js - Date ranges
src/modules/finance/lib/dates.js - Finance seed data
src/modules/finance/lib/seed.js
Platform services
- Auth service
src/core/auth/server.js - API auth wrapper
src/core/api/handler.js - Current session
src/core/auth/session.js - API responses
src/core/api/response.js - PostgreSQL database
src/core/db/client.js
Other components
- User
Connections 36
- User → Workspace UI: uses
- Workspace UI → App navigation: configures navigation
src/core/config/apps.js - Auth API → Auth service: handles auth
- Auth service → PostgreSQL database: uses Prisma
src/core/auth/server.js - API auth wrapper → Current session: gets user
src/core/api/handler.js - API auth wrapper → API responses: returns errors
src/core/api/handler.js - Current session → Auth service: reads session
src/core/auth/session.js - Notes and folders API → API auth wrapper: authenticates
src/app/api/notes/route.js - Notes and folders API → API responses: formats response
src/app/api/notes/route.js - Notes and folders API → Note and folder queries: reads and writes
src/app/api/notes/route.js - Notes and folders API → Note validation: validates input
src/app/api/notes/route.js - Folder API → API auth wrapper: authenticates
src/app/api/folders/route.js - Folder API → API responses: formats response
src/app/api/folders/route.js - Folder API → Note and folder queries: reads and writes
src/app/api/folders/route.js - Note and folder queries → PostgreSQL database: queries
src/modules/notes/lib/queries.js - Note sharing API → API auth wrapper: authenticates
src/app/api/notes/share/route.js - Note sharing API → API responses: formats response
src/app/api/notes/share/route.js - Note sharing API → PostgreSQL database: reads and writes
src/app/api/notes/share/route.js - Note sharing API → Share email: sends email
src/app/api/notes/share/route.js - Share link API → PostgreSQL database: reads share
src/app/api/shares/[token]/route.js - Editor utilities → Notes workspace: supports editing
- Finance transactions API → API auth wrapper: authenticates
src/app/api/finance/transactions/route.js - Finance transactions API → API responses: formats response
src/app/api/finance/transactions/route.js - Finance transactions API → Finance queries: reads and writes
src/app/api/finance/transactions/route.js - Finance transactions API → Transaction validation: validates input
src/app/api/finance/transactions/route.js - Category API → API auth wrapper: authenticates
src/app/api/finance/categories/route.js - Category API → Finance queries: reads and writes
src/app/api/finance/categories/route.js - Finance dashboard API → API auth wrapper: authenticates
src/app/api/finance/dashboard/route.js - Finance dashboard API → Finance queries: loads metrics
src/app/api/finance/dashboard/route.js - Monthly overview API → API auth wrapper: authenticates
src/app/api/finance/monthly/route.js - Monthly overview API → PostgreSQL database: queries monthly data
src/app/api/finance/monthly/route.js - Finance reports API → API auth wrapper: authenticates
src/app/api/finance/reports/route.js - Finance reports API → API responses: returns cached data
src/app/api/finance/reports/route.js - Finance reports API → Finance queries: aggregates data
src/app/api/finance/reports/route.js - Finance reports API → Date ranges: resolves range
src/app/api/finance/reports/route.js - Finance queries → PostgreSQL database: queries
src/modules/finance/lib/queries.js