# crxtian01/conssytem architecture

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

- Interactive diagram: https://gitdiagram.com/crxtian01/conssytem
- Repository: https://github.com/crxtian01/conssytem

## Overview

ConstructMS is a construction-management workspace with a distinct RA 12009 bidding workflow, serving admins/engineers, assistants, contractors, and clients. Its documented capabilities span project progress and S-curves, bids from draft through award, inventory, attendance, site logs, expenses, documents, reports, and role-based approvals. Sampled code shows API handlers delegating to stores and dashboard services, plus dashboard rendering components. The UI-to-API wiring for most unsampled modules is not shown, so those relationships are omitted rather than inferred.

Main entry points: [`src/lib/roles.ts`](https://github.com/crxtian01/conssytem/blob/main/src/lib/roles.ts) (Role Permissions), [`src/lib/auth.ts`](https://github.com/crxtian01/conssytem/blob/main/src/lib/auth.ts) (Authentication), [`src/lib/bidding-store.ts`](https://github.com/crxtian01/conssytem/blob/main/src/lib/bidding-store.ts) (Bid Records), [`src/lib/db.ts`](https://github.com/crxtian01/conssytem/blob/main/src/lib/db.ts) (Database Access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Identity and Access"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_roles["Role Permissions<br/>[roles.ts]"]
  node_auth_routes["Auth Routes"]
end

subgraph group_operations["Construction Operations"]
  node_module_api["Module API<br/>[route.ts]"]
  node_module_store[("Project Records<br/>[module-store.ts]")]
  node_project_modules["Project Operations<br/>[ProjectsClient.tsx]"]
  node_materials["Materials and Requests"]
  node_expenses["Expense Approvals<br/>[ExpensesClient.tsx]"]
  node_field_modules["Field Work Modules"]
end

subgraph group_procurement["Bidding and Procurement"]
  node_bidding_ui["Bidding Workspace"]
  node_bidding_api["Bidding API<br/>[route.ts]"]
  node_bidding_store[("Bid Records<br/>[bidding-store.ts]")]
end

subgraph group_insight["Dashboard and Reporting"]
  node_dashboard["Executive Dashboard"]
  node_dashboard_api["Dashboard API<br/>[route.ts]"]
  node_dashboard_service["Dashboard Aggregation"]
  node_dashboard_charts["KPI and S-Curve Charts"]
  node_dashboard_types["Dashboard Data Types<br/>[database.types.ts]"]
end

subgraph group_platform["Services and Persistence"]
  node_email["Email Notifications<br/>[email.ts]"]
  node_db["Database Access<br/>[db.ts]"]
  node_supabase[("Supabase")]
end

node_admin(("Admin / Engineer"))
node_assistant(("Assistant"))
node_contractor(("Contractor"))
node_client(("Client"))

node_admin -->|"reviews KPIs"| node_dashboard
node_admin -->|"issues and awards"| node_bidding_ui
node_assistant -->|"records site work"| node_field_modules
node_contractor -->|"submits proposals"| node_bidding_ui
node_client -->|"views progress"| node_project_modules
node_auth -->|"queries profiles"| node_db
node_auth -->|"normalizes roles"| node_roles
node_auth_routes -->|"manages sessions"| node_supabase
node_module_api -->|"requires sign-in"| node_auth
node_module_api -->|"checks permissions"| node_roles
node_module_api -->|"reads and writes"| node_module_store
node_module_api -->|"sends task notices"| node_email
node_project_modules -->|"uses role rules"| node_roles
node_materials -->|"uses role rules"| node_roles
node_expenses -->|"uses role rules"| node_roles
node_bidding_ui -->|"uses bid utilities"| node_bidding_store
node_bidding_ui -->|"checks roles"| node_roles
node_bidding_api -->|"requires sign-in"| node_auth
node_bidding_api -->|"reads and updates"| node_bidding_store
node_bidding_store -->|"converts awarded bid"| node_module_store
node_dashboard -->|"renders charts"| node_dashboard_charts
node_dashboard_api -->|"requires sign-in"| node_auth
node_dashboard_api -->|"requests payload"| node_dashboard_service
node_dashboard_service -->|"reads operations data"| node_module_store
node_dashboard_service -->|"reads bid data"| node_bidding_store
node_dashboard_service -->|"queries analytics"| node_db
node_dashboard_charts -->|"uses chart types"| node_dashboard_types
node_db -->|"creates clients"| node_supabase
node_module_store -->|"mirrors records"| node_db
node_bidding_store -->|"syncs bid data"| node_db
node_email -.->|"sends via Resend"| node_supabase

click node_auth "https://github.com/crxtian01/conssytem/blob/main/src/lib/auth.ts"
click node_roles "https://github.com/crxtian01/conssytem/blob/main/src/lib/roles.ts"
click node_auth_routes "https://github.com/crxtian01/conssytem/tree/main/src/app/auth"
click node_module_api "https://github.com/crxtian01/conssytem/blob/main/src/app/api/modules/%5Bmodule%5D/route.ts"
click node_module_store "https://github.com/crxtian01/conssytem/blob/main/src/lib/module-store.ts"
click node_project_modules "https://github.com/crxtian01/conssytem/blob/main/src/components/modules/ProjectsClient.tsx"
click node_materials "https://github.com/crxtian01/conssytem/blob/main/src/components/modules/MaterialsClient.tsx"
click node_expenses "https://github.com/crxtian01/conssytem/blob/main/src/components/modules/ExpensesClient.tsx"
click node_field_modules "https://github.com/crxtian01/conssytem/tree/main/src/components/modules"
click node_bidding_ui "https://github.com/crxtian01/conssytem/blob/main/src/components/bidding/BiddingWorkspace.tsx"
click node_bidding_api "https://github.com/crxtian01/conssytem/blob/main/src/app/api/bidding/route.ts"
click node_bidding_store "https://github.com/crxtian01/conssytem/blob/main/src/lib/bidding-store.ts"
click node_dashboard "https://github.com/crxtian01/conssytem/blob/main/src/components/dashboard/admin/AdminEngineerDashboard.tsx"
click node_dashboard_api "https://github.com/crxtian01/conssytem/blob/main/src/app/api/dashboard/admin/route.ts"
click node_dashboard_service "https://github.com/crxtian01/conssytem/blob/main/src/lib/admin-dashboard-service.ts"
click node_dashboard_charts "https://github.com/crxtian01/conssytem/blob/main/src/components/dashboard/admin/AdminDashboardCharts.tsx"
click node_dashboard_types "https://github.com/crxtian01/conssytem/blob/main/src/types/database.types.ts"
click node_email "https://github.com/crxtian01/conssytem/blob/main/src/lib/email.ts"
click node_db "https://github.com/crxtian01/conssytem/blob/main/src/lib/db.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_auth,node_roles,node_auth_routes,node_client toneBlue
class node_module_api,node_module_store,node_project_modules,node_materials,node_expenses,node_field_modules toneAmber
class node_bidding_ui,node_bidding_api,node_bidding_store toneMint
class node_dashboard,node_dashboard_api,node_dashboard_service,node_dashboard_charts,node_dashboard_types toneRose
class node_email,node_db,node_supabase,node_admin,node_assistant,node_contractor toneIndigo
```

## Components

### Identity and Access

- [Authentication](https://github.com/crxtian01/conssytem/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Role Permissions](https://github.com/crxtian01/conssytem/blob/main/src/lib/roles.ts): `src/lib/roles.ts`
- [Auth Routes](https://github.com/crxtian01/conssytem/tree/main/src/app/auth): `src/app/auth`

### Construction Operations

- [Module API](https://github.com/crxtian01/conssytem/blob/main/src/app/api/modules/%5Bmodule%5D/route.ts): `src/app/api/modules/[module]/route.ts`
- [Project Records](https://github.com/crxtian01/conssytem/blob/main/src/lib/module-store.ts): `src/lib/module-store.ts`
- [Project Operations](https://github.com/crxtian01/conssytem/blob/main/src/components/modules/ProjectsClient.tsx): `src/components/modules/ProjectsClient.tsx`
- [Materials and Requests](https://github.com/crxtian01/conssytem/blob/main/src/components/modules/MaterialsClient.tsx): `src/components/modules/MaterialsClient.tsx`
- [Expense Approvals](https://github.com/crxtian01/conssytem/blob/main/src/components/modules/ExpensesClient.tsx): `src/components/modules/ExpensesClient.tsx`
- [Field Work Modules](https://github.com/crxtian01/conssytem/tree/main/src/components/modules): `src/components/modules`

### Bidding and Procurement

- [Bidding Workspace](https://github.com/crxtian01/conssytem/blob/main/src/components/bidding/BiddingWorkspace.tsx): `src/components/bidding/BiddingWorkspace.tsx`
- [Bidding API](https://github.com/crxtian01/conssytem/blob/main/src/app/api/bidding/route.ts): `src/app/api/bidding/route.ts`
- [Bid Records](https://github.com/crxtian01/conssytem/blob/main/src/lib/bidding-store.ts): `src/lib/bidding-store.ts`

### Dashboard and Reporting

- [Executive Dashboard](https://github.com/crxtian01/conssytem/blob/main/src/components/dashboard/admin/AdminEngineerDashboard.tsx): `src/components/dashboard/admin/AdminEngineerDashboard.tsx`
- [Dashboard API](https://github.com/crxtian01/conssytem/blob/main/src/app/api/dashboard/admin/route.ts): `src/app/api/dashboard/admin/route.ts`
- [Dashboard Aggregation](https://github.com/crxtian01/conssytem/blob/main/src/lib/admin-dashboard-service.ts): `src/lib/admin-dashboard-service.ts`
- [KPI and S-Curve Charts](https://github.com/crxtian01/conssytem/blob/main/src/components/dashboard/admin/AdminDashboardCharts.tsx): `src/components/dashboard/admin/AdminDashboardCharts.tsx`
- [Dashboard Data Types](https://github.com/crxtian01/conssytem/blob/main/src/types/database.types.ts): `src/types/database.types.ts`

### Services and Persistence

- [Email Notifications](https://github.com/crxtian01/conssytem/blob/main/src/lib/email.ts): `src/lib/email.ts`
- [Database Access](https://github.com/crxtian01/conssytem/blob/main/src/lib/db.ts): `src/lib/db.ts`
- **Supabase**

### Other components

- **Admin / Engineer**
- **Assistant**
- **Contractor**
- **Client**

## Connections

- Admin / Engineer → Executive Dashboard: reviews KPIs
- Admin / Engineer → Bidding Workspace: issues and awards
- Assistant → Field Work Modules: records site work
- Contractor → Bidding Workspace: submits proposals
- Client → Project Operations: views progress
- Authentication → Database Access: queries profiles (evidence: `src/lib/auth.ts`)
- Authentication → Role Permissions: normalizes roles (evidence: `src/lib/auth.ts`)
- Auth Routes → Supabase: manages sessions (evidence: `src/app/auth/callback/route.ts`)
- Module API → Authentication: requires sign-in (evidence: `src/app/api/modules/[module]/route.ts`)
- Module API → Role Permissions: checks permissions (evidence: `src/app/api/modules/[module]/route.ts`)
- Module API → Project Records: reads and writes (evidence: `src/app/api/modules/[module]/route.ts`)
- Module API → Email Notifications: sends task notices (evidence: `src/app/api/modules/[module]/route.ts`)
- Project Operations → Role Permissions: uses role rules (evidence: `src/components/modules/ProjectsClient.tsx`)
- Materials and Requests → Role Permissions: uses role rules (evidence: `src/components/modules/MaterialsClient.tsx`)
- Expense Approvals → Role Permissions: uses role rules (evidence: `src/components/modules/ExpensesClient.tsx`)
- Bidding Workspace → Bid Records: uses bid utilities (evidence: `src/components/bidding/BiddingWorkspace.tsx`)
- Bidding Workspace → Role Permissions: checks roles (evidence: `src/components/bidding/BiddingWorkspace.tsx`)
- Bidding API → Authentication: requires sign-in (evidence: `src/app/api/bidding/route.ts`)
- Bidding API → Bid Records: reads and updates (evidence: `src/app/api/bidding/route.ts`)
- Bid Records → Project Records: converts awarded bid (evidence: `src/lib/bidding-store.ts`)
- Executive Dashboard → KPI and S-Curve Charts: renders charts (evidence: `src/components/dashboard/admin/AdminEngineerDashboard.tsx`)
- Dashboard API → Authentication: requires sign-in (evidence: `src/app/api/dashboard/admin/route.ts`)
- Dashboard API → Dashboard Aggregation: requests payload (evidence: `src/app/api/dashboard/admin/route.ts`)
- Dashboard Aggregation → Project Records: reads operations data (evidence: `src/lib/admin-dashboard-service.ts`)
- Dashboard Aggregation → Bid Records: reads bid data (evidence: `src/lib/admin-dashboard-service.ts`)
- Dashboard Aggregation → Database Access: queries analytics (evidence: `src/lib/admin-dashboard-service.ts`)
- KPI and S-Curve Charts → Dashboard Data Types: uses chart types (evidence: `src/components/dashboard/admin/AdminDashboardCharts.tsx`)
- Database Access → Supabase: creates clients (evidence: `src/lib/db.ts`)
- Project Records → Database Access: mirrors records (evidence: `src/lib/module-store.ts`)
- Bid Records → Database Access: syncs bid data (evidence: `src/lib/bidding-store.ts`)
- Email Notifications → Supabase: sends via Resend
