# kayo2970/erp architecture

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

- Interactive diagram: https://gitdiagram.com/kayo2970/erp
- Repository: https://github.com/kayo2970/erp

## Overview

LEADS Next Gen is a private, role-gated internal operations ERP. Members use its dashboard to submit and manage work—such as tasks, events, designs, and spending requests—then approval policies route eligible changes through reviewers; roster, forms, passes, communications, and reporting support broader operations. The sampled routes show server-side session checks, collection persistence, approval coordination, and uploaded-file storage. README-described capabilities are included, but their unsampled implementation links are omitted or marked unverified rather than inferred.

Main entry points: [`leads-dashboard/src/lib/server-db.ts`](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/server-db.ts) (Collection database), [`leads-dashboard/src/app/dashboard/home/page.tsx`](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/home/page.tsx) (Operations dashboard), [`leads-dashboard/src/lib/approval-sync.ts`](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/approval-sync.ts) (Approval coordination), [`leads-dashboard/src/app/api/designs/route.ts`](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/designs/route.ts) (Design portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Member portal"]
  node_dashboard["Operations dashboard<br/>[page.tsx]"]
  node_members["Member directory<br/>[route.ts]"]
  node_guests["Guest directory<br/>[route.ts]"]
end

subgraph group_operations["Operations workflows"]
  node_tasks["Tasks desk<br/>[page.tsx]"]
  node_task_api["Task workflow API<br/>[route.ts]"]
  node_task_detail["Task decisions<br/>[route.ts]"]
  node_events["Events desk<br/>[page.tsx]"]
  node_event_api["Event workflow API<br/>[route.ts]"]
  node_designs["Design portal<br/>[route.ts]"]
  node_design_review["Design review<br/>[route.ts]"]
  node_ratings["Ratings and reports<br/>[page.tsx]"]
  node_reporting["Analytics reports<br/>[page.tsx]"]
  node_forms["Forms builder<br/>[page.tsx]"]
end

subgraph group_governance["Governance and finance"]
  node_approvals["Approvals desk<br/>[page.tsx]"]
  node_procurement["Procurement requests<br/>[route.ts]"]
  node_reimbursements["Reimbursements<br/>[page.tsx]"]
  node_budgets["Budget governance<br/>[page.tsx]"]
  node_policies["Group policies<br/>[route.ts]"]
end

subgraph group_engagement["Events and outreach"]
  node_event_passes["Event access passes<br/>[page.tsx]"]
  node_visiting_cards["Digital visiting cards<br/>[page.tsx]"]
  node_communications["Email and announcements<br/>[page.tsx]"]
end

subgraph group_platform["Shared services"]
  node_sessions["Session access<br/>[session.ts]"]
  node_permissions["Permission rules"]
  node_approval_sync["Approval coordination<br/>[approval-sync.ts]"]
  node_database[("Collection database<br/>[server-db.ts]")]
  node_file_store[("Uploaded files<br/>[file-storage.ts]")]
  node_backup["Backup and restore<br/>[page.tsx]"]
end

node_member(("Member or staff"))

node_member -->|"uses portal"| node_dashboard
node_dashboard -->|"opens"| node_tasks
node_dashboard -->|"opens"| node_events
node_dashboard -->|"opens"| node_approvals
node_dashboard -->|"opens"| node_forms
node_dashboard -->|"opens"| node_members
node_dashboard -->|"opens"| node_guests
node_dashboard -->|"opens"| node_event_passes
node_dashboard -->|"opens"| node_visiting_cards
node_dashboard -->|"opens"| node_communications
node_tasks -.->|"submits work"| node_task_api
node_task_api -->|"requires session"| node_sessions
node_task_api -->|"reads and writes"| node_database
node_task_api -->|"fans out approvals"| node_approval_sync
node_task_detail -->|"updates tasks"| node_database
node_task_detail -->|"closes approvals"| node_approval_sync
node_events -.->|"manages events"| node_event_api
node_event_api -->|"requires session"| node_sessions
node_event_api -->|"reads and writes"| node_database
node_event_api -->|"fans out approvals"| node_approval_sync
node_designs -.->|"reviews submissions"| node_design_review
node_designs -->|"stores designs"| node_database
node_designs -->|"stores uploads"| node_file_store
node_designs -->|"fans out approvals"| node_approval_sync
node_design_review -->|"updates designs"| node_database
node_design_review -->|"deletes replaced files"| node_file_store
node_procurement -->|"writes requests and tasks"| node_database
node_procurement -->|"requests approval"| node_approval_sync
node_policies -.->|"stores policies"| node_database
node_approvals -.->|"decides tasks"| node_task_detail
node_approvals -.->|"reviews designs"| node_design_review
node_reimbursements -.->|"tracks claims"| node_database
node_budgets -.->|"tracks funds"| node_database
node_ratings -.->|"records evaluations"| node_database
node_reporting -.->|"reads metrics"| node_database
node_forms -.->|"stores forms"| node_database
node_members -.->|"manages roster"| node_database
node_guests -.->|"manages guests"| node_database
node_event_passes -.->|"tracks access passes"| node_database
node_visiting_cards -.->|"stores card data"| node_database
node_communications -.->|"stores email state"| node_database
node_backup -.->|"backs up data"| node_database

click node_dashboard "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/home/page.tsx"
click node_tasks "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/tasks/page.tsx"
click node_task_api "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/tasks/route.ts"
click node_task_detail "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/tasks/%5Bid%5D/route.ts"
click node_events "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/events/page.tsx"
click node_event_api "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/events/route.ts"
click node_designs "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/designs/route.ts"
click node_design_review "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/designs/%5Bid%5D/route.ts"
click node_approvals "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/approvals/page.tsx"
click node_procurement "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/procurement-requests/route.ts"
click node_reimbursements "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/reimbursements/page.tsx"
click node_budgets "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/budget/page.tsx"
click node_ratings "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/ratings/page.tsx"
click node_reporting "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/reports/page.tsx"
click node_forms "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/forms/page.tsx"
click node_members "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/members/route.ts"
click node_guests "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/guests/route.ts"
click node_event_passes "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/event-passes/page.tsx"
click node_visiting_cards "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/visiting-card/page.tsx"
click node_communications "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/email/page.tsx"
click node_policies "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/group-policies/route.ts"
click node_sessions "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/session.ts"
click node_permissions "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/permissions-server.ts"
click node_approval_sync "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/approval-sync.ts"
click node_database "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/server-db.ts"
click node_file_store "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/file-storage.ts"
click node_backup "https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/backup/page.tsx"

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_dashboard,node_members,node_guests toneBlue
class node_tasks,node_task_api,node_task_detail,node_events,node_event_api,node_designs,node_design_review,node_ratings,node_reporting,node_forms toneAmber
class node_approvals,node_procurement,node_reimbursements,node_budgets,node_policies toneMint
class node_event_passes,node_visiting_cards,node_communications toneRose
class node_sessions,node_permissions,node_approval_sync,node_database,node_file_store,node_backup,node_member toneIndigo
```

## Components

### Member portal

- [Operations dashboard](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/home/page.tsx): `leads-dashboard/src/app/dashboard/home/page.tsx`
- [Member directory](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/members/route.ts): `leads-dashboard/src/app/api/members/route.ts`
- [Guest directory](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/guests/route.ts): `leads-dashboard/src/app/api/guests/route.ts`

### Operations workflows

- [Tasks desk](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/tasks/page.tsx): `leads-dashboard/src/app/dashboard/tasks/page.tsx`
- [Task workflow API](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/tasks/route.ts): `leads-dashboard/src/app/api/tasks/route.ts`
- [Task decisions](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/tasks/%5Bid%5D/route.ts): `leads-dashboard/src/app/api/tasks/[id]/route.ts`
- [Events desk](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/events/page.tsx): `leads-dashboard/src/app/dashboard/events/page.tsx`
- [Event workflow API](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/events/route.ts): `leads-dashboard/src/app/api/events/route.ts`
- [Design portal](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/designs/route.ts): `leads-dashboard/src/app/api/designs/route.ts`
- [Design review](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/designs/%5Bid%5D/route.ts): `leads-dashboard/src/app/api/designs/[id]/route.ts`
- [Ratings and reports](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/ratings/page.tsx): `leads-dashboard/src/app/dashboard/ratings/page.tsx`
- [Analytics reports](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/reports/page.tsx): `leads-dashboard/src/app/dashboard/reports/page.tsx`
- [Forms builder](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/forms/page.tsx): `leads-dashboard/src/app/dashboard/forms/page.tsx`

### Governance and finance

- [Approvals desk](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/approvals/page.tsx): `leads-dashboard/src/app/dashboard/approvals/page.tsx`
- [Procurement requests](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/procurement-requests/route.ts): `leads-dashboard/src/app/api/procurement-requests/route.ts`
- [Reimbursements](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/reimbursements/page.tsx): `leads-dashboard/src/app/dashboard/reimbursements/page.tsx`
- [Budget governance](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/budget/page.tsx): `leads-dashboard/src/app/dashboard/budget/page.tsx`
- [Group policies](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/api/group-policies/route.ts): `leads-dashboard/src/app/api/group-policies/route.ts`

### Events and outreach

- [Event access passes](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/event-passes/page.tsx): `leads-dashboard/src/app/dashboard/event-passes/page.tsx`
- [Digital visiting cards](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/visiting-card/page.tsx): `leads-dashboard/src/app/dashboard/visiting-card/page.tsx`
- [Email and announcements](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/email/page.tsx): `leads-dashboard/src/app/dashboard/email/page.tsx`

### Shared services

- [Session access](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/session.ts): `leads-dashboard/src/lib/session.ts`
- [Permission rules](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/permissions-server.ts): `leads-dashboard/src/lib/permissions-server.ts`
- [Approval coordination](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/approval-sync.ts): `leads-dashboard/src/lib/approval-sync.ts`
- [Collection database](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/server-db.ts): `leads-dashboard/src/lib/server-db.ts`
- [Uploaded files](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/lib/file-storage.ts): `leads-dashboard/src/lib/file-storage.ts`
- [Backup and restore](https://github.com/kayo2970/erp/blob/main/leads-dashboard/src/app/dashboard/backup/page.tsx): `leads-dashboard/src/app/dashboard/backup/page.tsx`

### Other components

- **Member or staff**

## Connections

- Member or staff → Operations dashboard: uses portal
- Operations dashboard → Tasks desk: opens
- Operations dashboard → Events desk: opens
- Operations dashboard → Approvals desk: opens
- Operations dashboard → Forms builder: opens
- Operations dashboard → Member directory: opens
- Operations dashboard → Guest directory: opens
- Operations dashboard → Event access passes: opens
- Operations dashboard → Digital visiting cards: opens
- Operations dashboard → Email and announcements: opens
- Tasks desk → Task workflow API: submits work
- Task workflow API → Session access: requires session (evidence: `leads-dashboard/src/app/api/tasks/route.ts`)
- Task workflow API → Collection database: reads and writes (evidence: `leads-dashboard/src/app/api/tasks/route.ts`)
- Task workflow API → Approval coordination: fans out approvals (evidence: `leads-dashboard/src/app/api/tasks/route.ts`)
- Task decisions → Collection database: updates tasks (evidence: `leads-dashboard/src/app/api/tasks/[id]/route.ts`)
- Task decisions → Approval coordination: closes approvals (evidence: `leads-dashboard/src/app/api/tasks/[id]/route.ts`)
- Events desk → Event workflow API: manages events
- Event workflow API → Session access: requires session (evidence: `leads-dashboard/src/app/api/events/route.ts`)
- Event workflow API → Collection database: reads and writes (evidence: `leads-dashboard/src/app/api/events/route.ts`)
- Event workflow API → Approval coordination: fans out approvals (evidence: `leads-dashboard/src/app/api/events/route.ts`)
- Design portal → Design review: reviews submissions
- Design portal → Collection database: stores designs (evidence: `leads-dashboard/src/app/api/designs/route.ts`)
- Design portal → Uploaded files: stores uploads (evidence: `leads-dashboard/src/app/api/designs/route.ts`)
- Design portal → Approval coordination: fans out approvals (evidence: `leads-dashboard/src/app/api/designs/route.ts`)
- Design review → Collection database: updates designs (evidence: `leads-dashboard/src/app/api/designs/[id]/route.ts`)
- Design review → Uploaded files: deletes replaced files (evidence: `leads-dashboard/src/app/api/designs/[id]/route.ts`)
- Procurement requests → Collection database: writes requests and tasks (evidence: `leads-dashboard/src/app/api/procurement-requests/route.ts`)
- Procurement requests → Approval coordination: requests approval (evidence: `leads-dashboard/src/app/api/procurement-requests/route.ts`)
- Group policies → Collection database: stores policies
- Approvals desk → Task decisions: decides tasks
- Approvals desk → Design review: reviews designs
- Reimbursements → Collection database: tracks claims
- Budget governance → Collection database: tracks funds
- Ratings and reports → Collection database: records evaluations
- Analytics reports → Collection database: reads metrics
- Forms builder → Collection database: stores forms
- Member directory → Collection database: manages roster
- Guest directory → Collection database: manages guests
- Event access passes → Collection database: tracks access passes
- Digital visiting cards → Collection database: stores card data
- Email and announcements → Collection database: stores email state
- Backup and restore → Collection database: backs up data
