# tropical8818/iprotrax architecture

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

- Interactive diagram: https://gitdiagram.com/tropical8818/iprotrax
- Repository: https://github.com/tropical8818/iprotrax

## Overview

iProTraX is a production-tracking and shop-floor collaboration application. Its primary workflow is to bring production orders into the system, let workers record step progress, and present current status to planners and supervisors through operational views, kiosks, and reports. Supervisors can correct progress, plan work, and discuss issues; AI analysis and external integrations extend that workflow. The graph combines sampled calls and imports with explicitly documented README capabilities; several unsampled product subsystems are represented at their exact route or directory paths, with edges limited to documented relationships.

Main entry points: [`src/lib/prisma.ts`](https://github.com/tropical8818/iprotrax/blob/main/src/lib/prisma.ts) (Production Database), [`src/app/api/orders/route.ts`](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/orders/route.ts) (Order Routes), [`src/app/api/ai/chat/route.ts`](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/ai/chat/route.ts) (AI Chat Route), [`src/app/api/config/route.ts`](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/config/route.ts) (Configuration Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_floor["Shop Floor"]
  node_planner["Planner Table<br/>[PlannerTable.tsx]"]
  node_stepui["Step Progress UI"]
  node_kiosk["Kiosk Display<br/>[page.tsx]"]
  node_orderapi["Order Routes<br/>[route.ts]"]
  node_progressapi["Progress Routes<br/>[route.ts]"]
  node_comments["Step Comments<br/>[route.ts]"]
end

subgraph group_planning["Planning And Insights"]
  node_scheduler["Scheduling<br/>[scheduler.ts]"]
  node_schedulerui["Scheduler Dialog"]
  node_analytics["Efficiency Analytics"]
  node_reports["Worker Reports<br/>[route.ts]"]
  node_airoute["AI Chat Route<br/>[route.ts]"]
  node_aicontext["Production Context<br/>[context.ts]"]
  node_aiprompts["AI Prompts<br/>[prompts.ts]"]
  node_aiclient["AI Provider Client<br/>[client.ts]"]
end

subgraph group_integration["Imports And Integrations"]
  node_importapi["Excel Import Routes<br/>[route.ts]"]
  node_importservice["Import Service<br/>[import-service.ts]"]
  node_excel["Excel Parsing<br/>[excel.ts]"]
  node_api["REST API v1<br/>[route.ts]"]
  node_notifications["Webhook Notifications"]
end

subgraph group_platform["Application Services"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_session["Session Tokens<br/>[session.ts]"]
  node_configapi["Configuration Routes<br/>[route.ts]"]
  node_config["Product Configuration<br/>[config.ts]"]
  node_realtime["Realtime Events<br/>[route.ts]"]
end

subgraph group_state["State And Data"]
  node_redis[("Redis Pub/Sub<br/>[redis.ts]")]
  node_database[("Production Database<br/>[prisma.ts]")]
end

node_worker(("Worker"))
node_supervisor(("Supervisor"))
node_erp["Factory ERP"]
node_external["External Systems"]

node_erp -->|"provides spreadsheets"| node_importapi
node_importapi -.->|"processes imports"| node_importservice
node_importapi -->|"parses workbook"| node_excel
node_importservice -->|"parses workbook"| node_excel
node_importservice -->|"upserts orders"| node_database
node_worker -->|"records progress"| node_stepui
node_stepui -.->|"submits progress"| node_progressapi
node_progressapi -->|"updates records"| node_database
node_planner -.->|"loads orders"| node_orderapi
node_orderapi -->|"queries orders"| node_database
node_orderapi -->|"loads comment summaries"| node_comments
node_supervisor -->|"plans work"| node_schedulerui
node_schedulerui -.->|"requests schedule"| node_scheduler
node_scheduler -.->|"returns schedule"| node_planner
node_supervisor -->|"corrects steps"| node_stepui
node_orderapi -->|"feeds floor status"| node_kiosk
node_progressapi -->|"broadcasts updates"| node_realtime
node_realtime -.->|"publishes events"| node_redis
node_supervisor -->|"reviews efficiency"| node_analytics
node_analytics -.->|"requests reports"| node_reports
node_reports -.->|"queries output"| node_database
node_supervisor -->|"asks production questions"| node_airoute
node_airoute -->|"builds context"| node_aicontext
node_airoute -->|"uses prompts"| node_aiprompts
node_airoute -->|"requests completion"| node_aiclient
node_aicontext -->|"reads production data"| node_database
node_aiclient -->|"calls AI provider"| node_external
node_supervisor -->|"discusses step issues"| node_comments
node_comments -->|"stores comments"| node_database
node_external -->|"integrates over REST"| node_api
node_api -.->|"authenticates requests"| node_auth
node_api -.->|"accesses production records"| node_database
node_notifications -->|"sends webhooks"| node_external
node_configapi -->|"checks session"| node_auth
node_auth -->|"encrypts session"| node_session
node_configapi -->|"reads and updates settings"| node_config
node_configapi -->|"manages products"| node_database

click node_planner "https://github.com/tropical8818/iprotrax/blob/main/src/components/PlannerTable.tsx"
click node_stepui "https://github.com/tropical8818/iprotrax/blob/main/src/components/StepProgressPanel.tsx"
click node_kiosk "https://github.com/tropical8818/iprotrax/blob/main/src/app/dashboard/kiosk/page.tsx"
click node_orderapi "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/orders/route.ts"
click node_progressapi "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/step-progress/stop/route.ts"
click node_comments "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/comments/route.ts"
click node_scheduler "https://github.com/tropical8818/iprotrax/blob/main/src/lib/scheduler.ts"
click node_schedulerui "https://github.com/tropical8818/iprotrax/blob/main/src/components/SmartSchedulerDialog.tsx"
click node_analytics "https://github.com/tropical8818/iprotrax/blob/main/src/components/analytics/AnalyticsDashboard.tsx"
click node_reports "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/reports/workers/route.ts"
click node_airoute "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/ai/chat/route.ts"
click node_aicontext "https://github.com/tropical8818/iprotrax/blob/main/src/lib/ai/context.ts"
click node_aiprompts "https://github.com/tropical8818/iprotrax/blob/main/src/lib/ai/prompts.ts"
click node_aiclient "https://github.com/tropical8818/iprotrax/blob/main/src/lib/ai/client.ts"
click node_importapi "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/import-excel/preview/route.ts"
click node_importservice "https://github.com/tropical8818/iprotrax/blob/main/src/lib/import-service.ts"
click node_excel "https://github.com/tropical8818/iprotrax/blob/main/src/lib/excel.ts"
click node_api "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/v1/orders/route.ts"
click node_notifications "https://github.com/tropical8818/iprotrax/blob/main/src/lib/services/notification-service.ts"
click node_auth "https://github.com/tropical8818/iprotrax/blob/main/src/lib/auth.ts"
click node_session "https://github.com/tropical8818/iprotrax/blob/main/src/lib/session.ts"
click node_configapi "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/config/route.ts"
click node_config "https://github.com/tropical8818/iprotrax/blob/main/src/lib/config.ts"
click node_realtime "https://github.com/tropical8818/iprotrax/blob/main/src/app/api/events/route.ts"
click node_redis "https://github.com/tropical8818/iprotrax/blob/main/src/lib/redis.ts"
click node_database "https://github.com/tropical8818/iprotrax/blob/main/src/lib/prisma.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_planner,node_stepui,node_kiosk,node_orderapi,node_progressapi,node_comments toneBlue
class node_scheduler,node_schedulerui,node_analytics,node_reports,node_airoute,node_aicontext,node_aiprompts,node_aiclient toneAmber
class node_importapi,node_importservice,node_excel,node_api,node_notifications toneMint
class node_auth,node_session,node_configapi,node_config,node_realtime,node_worker toneRose
class node_redis,node_database,node_supervisor,node_erp,node_external toneIndigo
```

## Components

### Shop Floor

- [Planner Table](https://github.com/tropical8818/iprotrax/blob/main/src/components/PlannerTable.tsx): `src/components/PlannerTable.tsx`
- [Step Progress UI](https://github.com/tropical8818/iprotrax/blob/main/src/components/StepProgressPanel.tsx): `src/components/StepProgressPanel.tsx`
- [Kiosk Display](https://github.com/tropical8818/iprotrax/blob/main/src/app/dashboard/kiosk/page.tsx): `src/app/dashboard/kiosk/page.tsx`
- [Order Routes](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/orders/route.ts): `src/app/api/orders/route.ts`
- [Progress Routes](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/step-progress/stop/route.ts): `src/app/api/step-progress/stop/route.ts`
- [Step Comments](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/comments/route.ts): `src/app/api/comments/route.ts`

### Planning And Insights

- [Scheduling](https://github.com/tropical8818/iprotrax/blob/main/src/lib/scheduler.ts): `src/lib/scheduler.ts`
- [Scheduler Dialog](https://github.com/tropical8818/iprotrax/blob/main/src/components/SmartSchedulerDialog.tsx): `src/components/SmartSchedulerDialog.tsx`
- [Efficiency Analytics](https://github.com/tropical8818/iprotrax/blob/main/src/components/analytics/AnalyticsDashboard.tsx): `src/components/analytics/AnalyticsDashboard.tsx`
- [Worker Reports](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/reports/workers/route.ts): `src/app/api/reports/workers/route.ts`
- [AI Chat Route](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/ai/chat/route.ts): `src/app/api/ai/chat/route.ts`
- [Production Context](https://github.com/tropical8818/iprotrax/blob/main/src/lib/ai/context.ts): `src/lib/ai/context.ts`
- [AI Prompts](https://github.com/tropical8818/iprotrax/blob/main/src/lib/ai/prompts.ts): `src/lib/ai/prompts.ts`
- [AI Provider Client](https://github.com/tropical8818/iprotrax/blob/main/src/lib/ai/client.ts): `src/lib/ai/client.ts`

### Imports And Integrations

- [Excel Import Routes](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/import-excel/preview/route.ts): `src/app/api/import-excel/preview/route.ts`
- [Import Service](https://github.com/tropical8818/iprotrax/blob/main/src/lib/import-service.ts): `src/lib/import-service.ts`
- [Excel Parsing](https://github.com/tropical8818/iprotrax/blob/main/src/lib/excel.ts): `src/lib/excel.ts`
- [REST API v1](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/v1/orders/route.ts): `src/app/api/v1/orders/route.ts`
- [Webhook Notifications](https://github.com/tropical8818/iprotrax/blob/main/src/lib/services/notification-service.ts): `src/lib/services/notification-service.ts`

### Application Services

- [Authentication](https://github.com/tropical8818/iprotrax/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Session Tokens](https://github.com/tropical8818/iprotrax/blob/main/src/lib/session.ts): `src/lib/session.ts`
- [Configuration Routes](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/config/route.ts): `src/app/api/config/route.ts`
- [Product Configuration](https://github.com/tropical8818/iprotrax/blob/main/src/lib/config.ts): `src/lib/config.ts`
- [Realtime Events](https://github.com/tropical8818/iprotrax/blob/main/src/app/api/events/route.ts): `src/app/api/events/route.ts`

### State And Data

- [Redis Pub/Sub](https://github.com/tropical8818/iprotrax/blob/main/src/lib/redis.ts): `src/lib/redis.ts`
- [Production Database](https://github.com/tropical8818/iprotrax/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`

### Other components

- **Worker**
- **Supervisor**
- **Factory ERP**
- **External Systems**

## Connections

- Factory ERP → Excel Import Routes: provides spreadsheets (evidence: `README.md`)
- Excel Import Routes → Import Service: processes imports
- Excel Import Routes → Excel Parsing: parses workbook (evidence: `src/app/api/import-excel/preview/route.ts`)
- Import Service → Excel Parsing: parses workbook (evidence: `src/lib/import-service.ts`)
- Import Service → Production Database: upserts orders (evidence: `src/lib/import-service.ts`)
- Worker → Step Progress UI: records progress (evidence: `README.md`)
- Step Progress UI → Progress Routes: submits progress
- Progress Routes → Production Database: updates records (evidence: `src/app/api/step-progress/stop/route.ts`)
- Planner Table → Order Routes: loads orders
- Order Routes → Production Database: queries orders (evidence: `src/app/api/orders/route.ts`)
- Order Routes → Step Comments: loads comment summaries (evidence: `src/app/api/orders/route.ts`)
- Supervisor → Scheduler Dialog: plans work (evidence: `README.md`)
- Scheduler Dialog → Scheduling: requests schedule
- Scheduling → Planner Table: returns schedule
- Supervisor → Step Progress UI: corrects steps (evidence: `README.md`)
- Order Routes → Kiosk Display: feeds floor status (evidence: `README.md`)
- Progress Routes → Realtime Events: broadcasts updates (evidence: `README.md`)
- Realtime Events → Redis Pub/Sub: publishes events
- Supervisor → Efficiency Analytics: reviews efficiency (evidence: `README.md`)
- Efficiency Analytics → Worker Reports: requests reports
- Worker Reports → Production Database: queries output
- Supervisor → AI Chat Route: asks production questions (evidence: `README.md`)
- AI Chat Route → Production Context: builds context (evidence: `src/app/api/ai/chat/route.ts`)
- AI Chat Route → AI Prompts: uses prompts (evidence: `src/app/api/ai/chat/route.ts`)
- AI Chat Route → AI Provider Client: requests completion (evidence: `src/app/api/ai/chat/route.ts`)
- Production Context → Production Database: reads production data (evidence: `src/lib/ai/context.ts`)
- AI Provider Client → External Systems: calls AI provider (evidence: `README.md`)
- Supervisor → Step Comments: discusses step issues (evidence: `README.md`)
- Step Comments → Production Database: stores comments (evidence: `src/app/api/comments/route.ts`)
- External Systems → REST API v1: integrates over REST (evidence: `README.md`)
- REST API v1 → Authentication: authenticates requests
- REST API v1 → Production Database: accesses production records
- Webhook Notifications → External Systems: sends webhooks (evidence: `README.md`)
- Configuration Routes → Authentication: checks session (evidence: `src/app/api/config/route.ts`)
- Authentication → Session Tokens: encrypts session (evidence: `src/lib/auth.ts`)
- Configuration Routes → Product Configuration: reads and updates settings (evidence: `src/app/api/config/route.ts`)
- Configuration Routes → Production Database: manages products (evidence: `src/app/api/config/route.ts`)
