How tropical8818/iprotrax works
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: prisma.ts Production Database · orders/route.ts Order Routes · chat/route.ts AI Chat Route · config/route.ts Configuration Routes
Components 30
Shop Floor
- Planner Table
src/components/PlannerTable.tsx - Step Progress UI
src/components/StepProgressPanel.tsx - Kiosk Display
src/app/dashboard/kiosk/page.tsx - Order Routes
src/app/api/orders/route.ts - Progress Routes
src/app/api/step-progress/stop/route.ts - Step Comments
src/app/api/comments/route.ts
Planning And Insights
- Scheduling
src/lib/scheduler.ts - Scheduler Dialog
src/components/SmartSchedulerDialog.tsx - Efficiency Analytics
src/components/analytics/AnalyticsDashboard.tsx - Worker Reports
src/app/api/reports/workers/route.ts - AI Chat Route
src/app/api/ai/chat/route.ts - Production Context
src/lib/ai/context.ts - AI Prompts
src/lib/ai/prompts.ts - AI Provider Client
src/lib/ai/client.ts
Imports And Integrations
- Excel Import Routes
src/app/api/import-excel/preview/route.ts - Import Service
src/lib/import-service.ts - Excel Parsing
src/lib/excel.ts - REST API v1
src/app/api/v1/orders/route.ts - Webhook Notifications
src/lib/services/notification-service.ts
Application Services
- Authentication
src/lib/auth.ts - Session Tokens
src/lib/session.ts - Configuration Routes
src/app/api/config/route.ts - Product Configuration
src/lib/config.ts - Realtime Events
src/app/api/events/route.ts
State And Data
- Redis Pub/Sub
src/lib/redis.ts - Production Database
src/lib/prisma.ts
Other components
- Worker
- Supervisor
- Factory ERP
- External Systems
Connections 37
- Factory ERP → Excel Import Routes: provides spreadsheets
README.md - Excel Import Routes → Import Service: processes imports
- Excel Import Routes → Excel Parsing: parses workbook
src/app/api/import-excel/preview/route.ts - Import Service → Excel Parsing: parses workbook
src/lib/import-service.ts - Import Service → Production Database: upserts orders
src/lib/import-service.ts - Worker → Step Progress UI: records progress
README.md - Step Progress UI → Progress Routes: submits progress
- Progress Routes → Production Database: updates records
src/app/api/step-progress/stop/route.ts - Planner Table → Order Routes: loads orders
- Order Routes → Production Database: queries orders
src/app/api/orders/route.ts - Order Routes → Step Comments: loads comment summaries
src/app/api/orders/route.ts - Supervisor → Scheduler Dialog: plans work
README.md - Scheduler Dialog → Scheduling: requests schedule
- Scheduling → Planner Table: returns schedule
- Supervisor → Step Progress UI: corrects steps
README.md - Order Routes → Kiosk Display: feeds floor status
README.md - Progress Routes → Realtime Events: broadcasts updates
README.md - Realtime Events → Redis Pub/Sub: publishes events
- Supervisor → Efficiency Analytics: reviews efficiency
README.md - Efficiency Analytics → Worker Reports: requests reports
- Worker Reports → Production Database: queries output
- Supervisor → AI Chat Route: asks production questions
README.md - AI Chat Route → Production Context: builds context
src/app/api/ai/chat/route.ts - AI Chat Route → AI Prompts: uses prompts
src/app/api/ai/chat/route.ts - AI Chat Route → AI Provider Client: requests completion
src/app/api/ai/chat/route.ts - Production Context → Production Database: reads production data
src/lib/ai/context.ts - AI Provider Client → External Systems: calls AI provider
README.md - Supervisor → Step Comments: discusses step issues
README.md - Step Comments → Production Database: stores comments
src/app/api/comments/route.ts - External Systems → REST API v1: integrates over REST
README.md - REST API v1 → Authentication: authenticates requests
- REST API v1 → Production Database: accesses production records
- Webhook Notifications → External Systems: sends webhooks
README.md - Configuration Routes → Authentication: checks session
src/app/api/config/route.ts - Authentication → Session Tokens: encrypts session
src/lib/auth.ts - Configuration Routes → Product Configuration: reads and updates settings
src/app/api/config/route.ts - Configuration Routes → Production Database: manages products
src/app/api/config/route.ts