# andreicarillo-9264/manufacturing-coordination-system architecture

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

- Interactive diagram: https://gitdiagram.com/andreicarillo-9264/manufacturing-coordination-system
- Repository: https://github.com/andreicarillo-9264/manufacturing-coordination-system

## Overview

The Manufacturing Coordination System is a role-based Laravel application for coordinating sales, production, inventory, and logistics. Users enter through web routes and operate product and job-order workflows that feed production, stock control, delivery scheduling, and logistics endorsement; dashboards and reports summarize operations. Other documented capabilities include imports/exports, audit logs, notifications, account settings, and an AI chat assistant. The graph combines documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation details and wiring are not asserted.

Main entry points: [`routes/web.php`](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/AIAssistantController.php`](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/AIAssistantController.php) (AI assistant), [`app/Http/Controllers/DashboardController.php`](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/DashboardController.php) (Operational dashboards), [`app/Models/JobOrder.php`](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/JobOrder.php) (Job-order records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and interface"]
  node_web["Web routes<br/>[web.php]"]
  node_accounts["Accounts and roles<br/>[UserController.php]"]
end

subgraph group_operations["Manufacturing operations"]
  node_catalog["Product catalog"]
  node_imports["Data imports"]
  node_orders["Job orders"]
  node_production["Production tracking"]
  node_stock["Inventory counts"]
  node_finished["Finished goods"]
  node_delivery["Delivery scheduling"]
  node_logistics["Logistics endorsement"]
end

subgraph group_insight["Insights and assistance"]
  node_dashboards["Operational dashboards"]
  node_reports["Reports and exports"]
  node_assistant["AI assistant"]
end

subgraph group_records["Domain records"]
  node_productdata[("Product records<br/>[Product.php]")]
  node_orderdata[("Job-order records<br/>[JobOrder.php]")]
  node_inventorydata[("Inventory records")]
  node_finisheddata[("Finished-good records<br/>[FinishedGood.php]")]
  node_transferdata[("Transfer records")]
  node_deliverydata[("Delivery records")]
  node_logisticsdata[("Endorsement records")]
  node_chatdata[("Conversation history<br/>[Conversation.php]")]
  node_chatmessages[("Chat history<br/>[ChatHistory.php]")]
  node_auditdata[("Activity records<br/>[ActivityLog.php]")]
end

subgraph group_platform["Cross-cutting services"]
  node_audit["Activity logs"]
  node_notifications["Notifications"]
end

node_user(("Staff user"))
node_aiapi["AI service<br/>external system"]

node_user -->|"uses"| node_web
node_web -->|"routes to"| node_accounts
node_web -->|"routes to"| node_catalog
node_web -->|"routes to"| node_imports
node_web -->|"routes to"| node_orders
node_web -->|"routes to"| node_production
node_web -->|"routes to"| node_stock
node_web -->|"routes to"| node_finished
node_web -->|"routes to"| node_delivery
node_web -->|"routes to"| node_logistics
node_web -->|"routes to"| node_dashboards
node_web -->|"routes to"| node_reports
node_web -->|"routes to"| node_assistant
node_web -->|"routes to"| node_audit
node_web -->|"routes to"| node_notifications
node_catalog -->|"uses records"| node_productdata
node_imports -->|"imports"| node_productdata
node_imports -->|"queues processing"| node_production
node_orders -->|"uses records"| node_orderdata
node_production -->|"tracks transfers"| node_transferdata
node_stock -->|"uses records"| node_inventorydata
node_finished -->|"uses records"| node_finisheddata
node_delivery -->|"uses records"| node_deliverydata
node_logistics -->|"uses records"| node_logisticsdata
node_dashboards -->|"reads"| node_orderdata
node_dashboards -->|"reads"| node_finisheddata
node_dashboards -->|"reads"| node_transferdata
node_reports -->|"reports on"| node_orderdata
node_assistant -->|"queries"| node_orderdata
node_assistant -->|"stores conversations"| node_chatdata
node_assistant -->|"stores messages"| node_chatmessages
node_assistant -->|"requests completion"| node_aiapi
node_aiapi -->|"returns response"| node_assistant
node_audit -->|"uses records"| node_auditdata
node_notifications -.->|"notifies"| node_user

click node_web "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/routes/web.php"
click node_accounts "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/UserController.php"
click node_catalog "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ProductController.php"
click node_imports "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ImportController.php"
click node_orders "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/JobOrderController.php"
click node_production "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/InventoryTransferController.php"
click node_stock "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ActualInventoryController.php"
click node_finished "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/FinishedGoodController.php"
click node_delivery "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/DeliveryScheduleController.php"
click node_logistics "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/EndorseToLogisticController.php"
click node_dashboards "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/DashboardController.php"
click node_reports "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ReportController.php"
click node_assistant "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/AIAssistantController.php"
click node_audit "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ActivityLogController.php"
click node_notifications "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/NotificationController.php"
click node_productdata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/Product.php"
click node_orderdata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/JobOrder.php"
click node_inventorydata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/ActualInventory.php"
click node_finisheddata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/FinishedGood.php"
click node_transferdata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/InventoryTransfer.php"
click node_deliverydata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/DeliverySchedule.php"
click node_logisticsdata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/EndorseToLogistic.php"
click node_chatdata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/Conversation.php"
click node_chatmessages "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/ChatHistory.php"
click node_auditdata "https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/ActivityLog.php"

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_web,node_accounts,node_user toneBlue
class node_catalog,node_imports,node_orders,node_production,node_stock,node_finished,node_delivery,node_logistics toneAmber
class node_dashboards,node_reports,node_assistant toneMint
class node_productdata,node_orderdata,node_inventorydata,node_finisheddata,node_transferdata,node_deliverydata,node_logisticsdata,node_chatdata,node_chatmessages,node_auditdata toneRose
class node_audit,node_notifications,node_aiapi toneIndigo
```

## Components

### Access and interface

- [Web routes](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/routes/web.php): `routes/web.php`
- [Accounts and roles](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`

### Manufacturing operations

- [Product catalog](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ProductController.php): `app/Http/Controllers/ProductController.php`
- [Data imports](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ImportController.php): `app/Http/Controllers/ImportController.php`
- [Job orders](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/JobOrderController.php): `app/Http/Controllers/JobOrderController.php`
- [Production tracking](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/InventoryTransferController.php): `app/Http/Controllers/InventoryTransferController.php`
- [Inventory counts](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ActualInventoryController.php): `app/Http/Controllers/ActualInventoryController.php`
- [Finished goods](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/FinishedGoodController.php): `app/Http/Controllers/FinishedGoodController.php`
- [Delivery scheduling](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/DeliveryScheduleController.php): `app/Http/Controllers/DeliveryScheduleController.php`
- [Logistics endorsement](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/EndorseToLogisticController.php): `app/Http/Controllers/EndorseToLogisticController.php`

### Insights and assistance

- [Operational dashboards](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Reports and exports](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ReportController.php): `app/Http/Controllers/ReportController.php`
- [AI assistant](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/AIAssistantController.php): `app/Http/Controllers/AIAssistantController.php`

### Domain records

- [Product records](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/Product.php): `app/Models/Product.php`
- [Job-order records](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/JobOrder.php): `app/Models/JobOrder.php`
- [Inventory records](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/ActualInventory.php): `app/Models/ActualInventory.php`
- [Finished-good records](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/FinishedGood.php): `app/Models/FinishedGood.php`
- [Transfer records](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/InventoryTransfer.php): `app/Models/InventoryTransfer.php`
- [Delivery records](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/DeliverySchedule.php): `app/Models/DeliverySchedule.php`
- [Endorsement records](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/EndorseToLogistic.php): `app/Models/EndorseToLogistic.php`
- [Conversation history](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/Conversation.php): `app/Models/Conversation.php`
- [Chat history](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/ChatHistory.php): `app/Models/ChatHistory.php`
- [Activity records](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Models/ActivityLog.php): `app/Models/ActivityLog.php`

### Cross-cutting services

- [Activity logs](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/ActivityLogController.php): `app/Http/Controllers/ActivityLogController.php`
- [Notifications](https://github.com/andreicarillo-9264/manufacturing-coordination-system/blob/main/app/Http/Controllers/NotificationController.php): `app/Http/Controllers/NotificationController.php`

### Other components

- **Staff user**
- **AI service**: external system

## Connections

- Staff user → Web routes: uses (evidence: `README.md`)
- Web routes → Accounts and roles: routes to (evidence: `routes/web.php`)
- Web routes → Product catalog: routes to (evidence: `routes/web.php`)
- Web routes → Data imports: routes to (evidence: `routes/web.php`)
- Web routes → Job orders: routes to (evidence: `routes/web.php`)
- Web routes → Production tracking: routes to (evidence: `routes/web.php`)
- Web routes → Inventory counts: routes to (evidence: `routes/web.php`)
- Web routes → Finished goods: routes to (evidence: `routes/web.php`)
- Web routes → Delivery scheduling: routes to (evidence: `routes/web.php`)
- Web routes → Logistics endorsement: routes to (evidence: `routes/web.php`)
- Web routes → Operational dashboards: routes to (evidence: `routes/web.php`)
- Web routes → Reports and exports: routes to (evidence: `routes/web.php`)
- Web routes → AI assistant: routes to (evidence: `routes/web.php`)
- Web routes → Activity logs: routes to (evidence: `routes/web.php`)
- Web routes → Notifications: routes to (evidence: `routes/web.php`)
- Product catalog → Product records: uses records
- Data imports → Product records: imports (evidence: `app/Http/Controllers/ImportController.php`)
- Data imports → Production tracking: queues processing (evidence: `app/Http/Controllers/ImportController.php`)
- Job orders → Job-order records: uses records
- Production tracking → Transfer records: tracks transfers
- Inventory counts → Inventory records: uses records (evidence: `app/Http/Controllers/ActualInventoryController.php`)
- Finished goods → Finished-good records: uses records
- Delivery scheduling → Delivery records: uses records (evidence: `app/Http/Controllers/DeliveryScheduleController.php`)
- Logistics endorsement → Endorsement records: uses records (evidence: `app/Models/EndorseToLogistic.php`)
- Operational dashboards → Job-order records: reads (evidence: `app/Http/Controllers/DashboardController.php`)
- Operational dashboards → Finished-good records: reads (evidence: `app/Http/Controllers/DashboardController.php`)
- Operational dashboards → Transfer records: reads (evidence: `app/Http/Controllers/DashboardController.php`)
- Reports and exports → Job-order records: reports on (evidence: `app/Http/Controllers/ReportController.php`)
- AI assistant → Job-order records: queries (evidence: `app/Http/Controllers/AIAssistantController.php`)
- AI assistant → Conversation history: stores conversations (evidence: `app/Http/Controllers/AIAssistantController.php`)
- AI assistant → Chat history: stores messages (evidence: `app/Http/Controllers/AIAssistantController.php`)
- AI assistant → AI service: requests completion (evidence: `app/Http/Controllers/AIAssistantController.php`)
- AI service → AI assistant: returns response (evidence: `app/Http/Controllers/AIAssistantController.php`)
- Activity logs → Activity records: uses records (evidence: `app/Http/Controllers/ActivityLogController.php`)
- Notifications → Staff user: notifies