# prabakaransara2325/colorshine-mes architecture

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

- Interactive diagram: https://gitdiagram.com/prabakaransara2325/colorshine-mes
- Repository: https://github.com/prabakaransara2325/colorshine-mes

## Overview

Colorshine MES is a web-based manufacturing execution system for plant operations, inventory, planning, quality, master data, and administration. Users enter through the browser shell, select a screen, and work through domain pages that call the API; the Express server dispatches requests to route handlers backed by PostgreSQL. The release README highlights TDC templates, historical records, and approval workflows. Backend route implementations beyond the excerpts were not inspected, so their internal behavior is summarized from the source index and documented capabilities.

Main entry points: [`backend/src/server.ts`](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/server.ts) (HTTP API Server), [`backend/src/db.ts`](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/db.ts) (PostgreSQL Access), [`frontend/src/lib/api.ts`](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/lib/api.ts) (API Client), [`frontend/src/App.tsx`](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/App.tsx) (App Routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web Client"]
  node_app["App Routing<br/>[App.tsx]"]
  node_shell["Navigation Shell<br/>[Shell.tsx]"]
  node_api_client["API Client<br/>[api.ts]"]
  node_master_ui["Master Data UI<br/>[GroupCodes.tsx]"]
  node_tdc_ui["TDC Workspace<br/>[TDCWizard.tsx]"]
  node_tdc_template_ui["TDC Templates"]
  node_auth_ui["Login &amp; Users<br/>[Login.tsx]"]
end

subgraph group_operations["Plant Operations"]
  node_masters["Reference Masters<br/>[masters.ts]"]
  node_grn["Goods Receipt<br/>[grn.ts]"]
  node_inventory["Inventory<br/>[inventory.ts]"]
  node_planning["Production Planning<br/>[planning.ts]"]
  node_reports["Operational Reports<br/>[reports.ts]"]
  node_sap_integration["SAP Inbound<br/>[integration.ts]"]
  node_dashboard["MES Dashboard<br/>[dashboard.ts]"]
end

subgraph group_quality["Quality &amp; TDC"]
  node_quality["RM Quality<br/>[quality.ts]"]
  node_tdc_routes["TDC Workflow<br/>[tdc.ts]"]
  node_tdc_email["TDC Email<br/>[tdcEmail.ts]"]
end

subgraph group_platform["API &amp; Platform"]
  node_server["HTTP API Server<br/>[server.ts]"]
  node_auth_routes["Authentication<br/>[auth.ts]"]
  node_auth_middleware["Session Authorization<br/>[auth.ts]"]
  node_security["Access Context<br/>[security.ts]"]
  node_admin_routes["User Administration<br/>[admin-users.ts]"]
  node_preferences["User Preferences"]
  node_db[("PostgreSQL Access<br/>[db.ts]")]
end

node_user(("MES User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_shell
node_app -->|"routes login"| node_auth_ui
node_app -->|"routes workflow"| node_tdc_ui
node_app -->|"routes templates"| node_tdc_template_ui
node_shell -->|"loads preferences"| node_api_client
node_master_ui -->|"requests master data"| node_api_client
node_tdc_ui -->|"calls API"| node_api_client
node_tdc_template_ui -->|"calls API"| node_api_client
node_auth_ui -.->|"uses session API"| node_api_client
node_api_client -.->|"sends HTTP requests"| node_server
node_server -->|"mounts auth routes"| node_auth_routes
node_server -->|"mounts admin routes"| node_admin_routes
node_server -->|"mounts preferences"| node_preferences
node_server -->|"mounts SAP routes"| node_sap_integration
node_server -->|"mounts GRN routes"| node_grn
node_server -->|"mounts inventory"| node_inventory
node_server -->|"mounts planning"| node_planning
node_server -->|"mounts reports"| node_reports
node_server -->|"mounts masters"| node_masters
node_server -->|"mounts quality"| node_quality
node_server -->|"mounts TDC routes"| node_tdc_routes
node_server -->|"mounts dashboard"| node_dashboard
node_auth_routes -->|"loads access context"| node_security
node_auth_routes -->|"protects endpoints"| node_auth_middleware
node_auth_middleware -->|"checks account state"| node_db
node_security -->|"queries access data"| node_db
node_auth_routes -->|"reads and updates users"| node_db
node_admin_routes -->|"reads and writes records"| node_db
node_preferences -->|"stores preferences"| node_db
node_masters -->|"reads and writes masters"| node_db
node_grn -->|"accesses receipt data"| node_db
node_inventory -->|"accesses stock data"| node_db
node_planning -->|"accesses planning data"| node_db
node_reports -.->|"queries reports"| node_db
node_sap_integration -->|"imports inbound data"| node_db
node_quality -->|"accesses quality data"| node_db
node_tdc_routes -->|"stores TDC records"| node_db
node_tdc_routes -->|"sends notifications"| node_tdc_email
node_dashboard -->|"queries summaries"| node_db

click node_app "https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/App.tsx"
click node_shell "https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/components/Shell.tsx"
click node_api_client "https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/lib/api.ts"
click node_master_ui "https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/pages/GroupCodes.tsx"
click node_tdc_ui "https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/pages/TDCWizard.tsx"
click node_tdc_template_ui "https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/pages/TDCTemplateMaster.tsx"
click node_auth_ui "https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/pages/Login.tsx"
click node_server "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/server.ts"
click node_auth_routes "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/auth.ts"
click node_auth_middleware "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/middleware/auth.ts"
click node_security "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/security.ts"
click node_admin_routes "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/admin-users.ts"
click node_preferences "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/user-preferences.ts"
click node_db "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/db.ts"
click node_masters "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/masters.ts"
click node_grn "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/grn.ts"
click node_inventory "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/inventory.ts"
click node_planning "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/planning.ts"
click node_reports "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/reports.ts"
click node_sap_integration "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/integration.ts"
click node_quality "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/quality.ts"
click node_tdc_routes "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/tdc.ts"
click node_tdc_email "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/services/tdcEmail.ts"
click node_dashboard "https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/dashboard.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_app,node_shell,node_api_client,node_master_ui,node_tdc_ui,node_tdc_template_ui,node_auth_ui,node_user toneBlue
class node_masters,node_grn,node_inventory,node_planning,node_reports,node_sap_integration,node_dashboard toneAmber
class node_quality,node_tdc_routes,node_tdc_email toneMint
class node_server,node_auth_routes,node_auth_middleware,node_security,node_admin_routes,node_preferences,node_db toneRose
```

## Components

### Web Client

- [App Routing](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Navigation Shell](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/components/Shell.tsx): `frontend/src/components/Shell.tsx`
- [API Client](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Master Data UI](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/pages/GroupCodes.tsx): `frontend/src/pages/GroupCodes.tsx`
- [TDC Workspace](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/pages/TDCWizard.tsx): `frontend/src/pages/TDCWizard.tsx`
- [TDC Templates](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/pages/TDCTemplateMaster.tsx): `frontend/src/pages/TDCTemplateMaster.tsx`
- [Login & Users](https://github.com/prabakaransara2325/colorshine-mes/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`

### Plant Operations

- [Reference Masters](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/masters.ts): `backend/src/routes/masters.ts`
- [Goods Receipt](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/grn.ts): `backend/src/routes/grn.ts`
- [Inventory](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/inventory.ts): `backend/src/routes/inventory.ts`
- [Production Planning](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/planning.ts): `backend/src/routes/planning.ts`
- [Operational Reports](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/reports.ts): `backend/src/routes/reports.ts`
- [SAP Inbound](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/integration.ts): `backend/src/routes/integration.ts`
- [MES Dashboard](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/dashboard.ts): `backend/src/routes/dashboard.ts`

### Quality & TDC

- [RM Quality](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/quality.ts): `backend/src/routes/quality.ts`
- [TDC Workflow](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/tdc.ts): `backend/src/routes/tdc.ts`
- [TDC Email](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/services/tdcEmail.ts): `backend/src/services/tdcEmail.ts`

### API & Platform

- [HTTP API Server](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Authentication](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/auth.ts): `backend/src/routes/auth.ts`
- [Session Authorization](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/middleware/auth.ts): `backend/src/middleware/auth.ts`
- [Access Context](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/security.ts): `backend/src/security.ts`
- [User Administration](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/admin-users.ts): `backend/src/routes/admin-users.ts`
- [User Preferences](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/routes/user-preferences.ts): `backend/src/routes/user-preferences.ts`
- [PostgreSQL Access](https://github.com/prabakaransara2325/colorshine-mes/blob/main/backend/src/db.ts): `backend/src/db.ts`

### Other components

- **MES User**

## Connections

- MES User → App Routing: uses (evidence: `frontend/src/App.tsx`)
- App Routing → Navigation Shell: renders (evidence: `frontend/src/App.tsx`)
- App Routing → Login & Users: routes login (evidence: `frontend/src/App.tsx`)
- App Routing → TDC Workspace: routes workflow (evidence: `frontend/src/App.tsx`)
- App Routing → TDC Templates: routes templates (evidence: `frontend/src/App.tsx`)
- Navigation Shell → API Client: loads preferences (evidence: `frontend/src/components/Shell.tsx`)
- Master Data UI → API Client: requests master data (evidence: `frontend/src/pages/GroupCodes.tsx`)
- TDC Workspace → API Client: calls API (evidence: `frontend/src/pages/TDCWizard.tsx`)
- TDC Templates → API Client: calls API (evidence: `frontend/src/pages/TDCTemplateMaster.tsx`)
- Login & Users → API Client: uses session API
- API Client → HTTP API Server: sends HTTP requests
- HTTP API Server → Authentication: mounts auth routes (evidence: `backend/src/server.ts`)
- HTTP API Server → User Administration: mounts admin routes (evidence: `backend/src/server.ts`)
- HTTP API Server → User Preferences: mounts preferences (evidence: `backend/src/server.ts`)
- HTTP API Server → SAP Inbound: mounts SAP routes (evidence: `backend/src/server.ts`)
- HTTP API Server → Goods Receipt: mounts GRN routes (evidence: `backend/src/server.ts`)
- HTTP API Server → Inventory: mounts inventory (evidence: `backend/src/server.ts`)
- HTTP API Server → Production Planning: mounts planning (evidence: `backend/src/server.ts`)
- HTTP API Server → Operational Reports: mounts reports (evidence: `backend/src/server.ts`)
- HTTP API Server → Reference Masters: mounts masters (evidence: `backend/src/server.ts`)
- HTTP API Server → RM Quality: mounts quality (evidence: `backend/src/server.ts`)
- HTTP API Server → TDC Workflow: mounts TDC routes (evidence: `backend/src/server.ts`)
- HTTP API Server → MES Dashboard: mounts dashboard (evidence: `backend/src/server.ts`)
- Authentication → Access Context: loads access context (evidence: `backend/src/routes/auth.ts`)
- Authentication → Session Authorization: protects endpoints (evidence: `backend/src/routes/auth.ts`)
- Session Authorization → PostgreSQL Access: checks account state (evidence: `backend/src/middleware/auth.ts`)
- Access Context → PostgreSQL Access: queries access data (evidence: `backend/src/security.ts`)
- Authentication → PostgreSQL Access: reads and updates users (evidence: `backend/src/routes/auth.ts`)
- User Administration → PostgreSQL Access: reads and writes records (evidence: `backend/src/routes/admin-users.ts`)
- User Preferences → PostgreSQL Access: stores preferences (evidence: `backend/src/routes/user-preferences.ts`)
- Reference Masters → PostgreSQL Access: reads and writes masters (evidence: `backend/src/routes/masters.ts`)
- Goods Receipt → PostgreSQL Access: accesses receipt data (evidence: `backend/src/routes/grn.ts`)
- Inventory → PostgreSQL Access: accesses stock data (evidence: `backend/src/routes/inventory.ts`)
- Production Planning → PostgreSQL Access: accesses planning data (evidence: `backend/src/routes/planning.ts`)
- Operational Reports → PostgreSQL Access: queries reports
- SAP Inbound → PostgreSQL Access: imports inbound data (evidence: `backend/src/routes/integration.ts`)
- RM Quality → PostgreSQL Access: accesses quality data (evidence: `backend/src/routes/quality.ts`)
- TDC Workflow → PostgreSQL Access: stores TDC records (evidence: `backend/src/routes/tdc.ts`)
- TDC Workflow → TDC Email: sends notifications (evidence: `backend/src/routes/tdc.ts`)
- MES Dashboard → PostgreSQL Access: queries summaries (evidence: `backend/src/routes/dashboard.ts`)
