# kotaprasanna12345/smartwarehouse architecture

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

- Interactive diagram: https://gitdiagram.com/kotaprasanna12345/smartwarehouse
- Repository: https://github.com/kotaprasanna12345/smartwarehouse

## Overview

SmartStock AI is a Flask-backed warehouse operations and order-fulfillment platform. Warehouse staff use its browser interface to inspect operational health, inventory and congestion, then allocate orders, pick items, and track fulfillment. The main workflow runs from order allocation through picking-task execution and status updates; replenishment and picker rebalancing are separate corrective actions. The README documents further analytics, an AI copilot, a global optimizer, and demo simulation. Sampled excerpts support the Flask, intelligence-engine, and SQLite layers; some feature wiring is documented but not shown in source excerpts.

Main entry points: [`app.py`](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py) (Flask Routes), [`templates`](https://github.com/kotaprasanna12345/smartwarehouse/tree/main/templates) (Browser UI), [`database.py`](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/database.py) (Database Access), [`engine.py`](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py) (Intelligence Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Operations Interface"]
  node_browser["Browser UI"]
  node_dashboard["Command Dashboard<br/>[dashboard.js]"]
  node_inventory_ui["Inventory Controls<br/>[inventory.js]"]
  node_orders_ui["Orders Interface<br/>[orders.js]"]
  node_fulfillment_ui["RF Picking Center<br/>[fulfillment.js]"]
  node_warehouse_ui["Spatial Warehouse Map<br/>[warehouse.js]"]
  node_warehouse_3d["3D Warehouse Twin<br/>[warehouse-3d.js]"]
  node_alerts_ui["Alerts Center<br/>[alerts.js]"]
  node_analytics_ui["Analytics Views<br/>[analytics.js]"]
  node_copilot_ui["AI Copilot<br/>[ai-insights.js]"]
  node_optimizer_ui["Optimizer Controls<br/>[optimizer.js]"]
  node_demo_ui["Demo Simulator<br/>[demo-mode.js]"]
end

subgraph group_workflow["Warehouse Workflow"]
  node_orders["Order Allocation<br/>[app.py]"]
  node_picking["Picking Execution<br/>[app.py]"]
  node_replenishment["Stock Replenishment<br/>[app.py]"]
end

subgraph group_insight["Intelligence Features"]
  node_engine["Intelligence Engine<br/>[engine.py]"]
  node_health["Health and Bottlenecks<br/>[engine.py]"]
  node_allocation["Smart Allocation<br/>[engine.py]"]
  node_copilot["Copilot Responses<br/>[engine.py]"]
  node_optimizer["Global Optimization<br/>[engine.py]"]
  node_analytics["Operational Analytics<br/>[app.py]"]
end

subgraph group_backend["Application Backend"]
  node_api["Flask Routes<br/>[app.py]"]
  node_database_layer["Database Access<br/>[database.py]"]
  node_store[("Warehouse Records<br/>[database.db]")]
end

node_staff(("Warehouse Staff"))

node_staff -->|"uses"| node_browser
node_browser -->|"renders"| node_dashboard
node_browser -->|"uses"| node_inventory_ui
node_browser -->|"uses"| node_orders_ui
node_browser -->|"uses"| node_fulfillment_ui
node_browser -->|"uses"| node_warehouse_ui
node_warehouse_ui -->|"controls"| node_warehouse_3d
node_browser -->|"uses"| node_alerts_ui
node_browser -->|"uses"| node_analytics_ui
node_browser -->|"uses"| node_copilot_ui
node_browser -->|"uses"| node_optimizer_ui
node_browser -->|"uses"| node_demo_ui
node_dashboard -->|"requests data"| node_api
node_inventory_ui -->|"requests and updates"| node_api
node_orders_ui -->|"requests allocation"| node_api
node_fulfillment_ui -->|"submits pick actions"| node_api
node_warehouse_ui -->|"requests rebalance"| node_api
node_alerts_ui -->|"requests alerts"| node_api
node_analytics_ui -->|"requests metrics"| node_api
node_copilot_ui -->|"sends queries"| node_api
node_optimizer_ui -->|"requests optimization"| node_api
node_demo_ui -->|"sends simulation events"| node_api
node_api -->|"dispatches"| node_orders
node_api -->|"dispatches"| node_picking
node_api -->|"dispatches"| node_replenishment
node_api -->|"computes"| node_analytics
node_api -->|"calls"| node_engine
node_engine -->|"calculates"| node_health
node_engine -->|"recommends"| node_allocation
node_engine -->|"answers"| node_copilot
node_engine -->|"executes"| node_optimizer
node_api -->|"accesses records"| node_database_layer
node_orders -->|"reads and writes"| node_database_layer
node_picking -->|"reads and writes"| node_database_layer
node_replenishment -->|"updates stock"| node_database_layer
node_engine -->|"queries and updates"| node_database_layer
node_analytics -->|"reads records"| node_database_layer
node_database_layer -->|"reads and writes"| node_store

click node_browser "https://github.com/kotaprasanna12345/smartwarehouse/tree/main/templates"
click node_dashboard "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/dashboard.js"
click node_inventory_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/inventory.js"
click node_orders_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/orders.js"
click node_fulfillment_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/fulfillment.js"
click node_warehouse_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/warehouse.js"
click node_warehouse_3d "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/warehouse-3d.js"
click node_alerts_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/alerts.js"
click node_analytics_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/analytics.js"
click node_copilot_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/ai-insights.js"
click node_optimizer_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/optimizer.js"
click node_demo_ui "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/demo-mode.js"
click node_orders "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py"
click node_picking "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py"
click node_replenishment "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py"
click node_engine "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py"
click node_health "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py"
click node_allocation "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py"
click node_copilot "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py"
click node_optimizer "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py"
click node_analytics "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py"
click node_api "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py"
click node_database_layer "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/database.py"
click node_store "https://github.com/kotaprasanna12345/smartwarehouse/blob/main/database.db"

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_browser,node_dashboard,node_inventory_ui,node_orders_ui,node_fulfillment_ui,node_warehouse_ui,node_warehouse_3d,node_alerts_ui,node_analytics_ui,node_copilot_ui,node_optimizer_ui,node_demo_ui toneBlue
class node_orders,node_picking,node_replenishment toneAmber
class node_engine,node_health,node_allocation,node_copilot,node_optimizer,node_analytics toneMint
class node_api,node_database_layer,node_store toneRose
class node_staff toneIndigo
```

## Components

### Operations Interface

- [Browser UI](https://github.com/kotaprasanna12345/smartwarehouse/tree/main/templates): `templates`
- [Command Dashboard](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/dashboard.js): `static/js/dashboard.js`
- [Inventory Controls](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/inventory.js): `static/js/inventory.js`
- [Orders Interface](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/orders.js): `static/js/orders.js`
- [RF Picking Center](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/fulfillment.js): `static/js/fulfillment.js`
- [Spatial Warehouse Map](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/warehouse.js): `static/js/warehouse.js`
- [3D Warehouse Twin](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/warehouse-3d.js): `static/js/warehouse-3d.js`
- [Alerts Center](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/alerts.js): `static/js/alerts.js`
- [Analytics Views](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/analytics.js): `static/js/analytics.js`
- [AI Copilot](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/ai-insights.js): `static/js/ai-insights.js`
- [Optimizer Controls](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/optimizer.js): `static/js/optimizer.js`
- [Demo Simulator](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/static/js/demo-mode.js): `static/js/demo-mode.js`

### Warehouse Workflow

- [Order Allocation](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py): `app.py`
- [Picking Execution](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py): `app.py`
- [Stock Replenishment](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py): `app.py`

### Intelligence Features

- [Intelligence Engine](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py): `engine.py`
- [Health and Bottlenecks](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py): `engine.py`
- [Smart Allocation](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py): `engine.py`
- [Copilot Responses](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py): `engine.py`
- [Global Optimization](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/engine.py): `engine.py`
- [Operational Analytics](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py): `app.py`

### Application Backend

- [Flask Routes](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/app.py): `app.py`
- [Database Access](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/database.py): `database.py`
- [Warehouse Records](https://github.com/kotaprasanna12345/smartwarehouse/blob/main/database.db): `database.db`

### Other components

- **Warehouse Staff**

## Connections

- Warehouse Staff → Browser UI: uses
- Browser UI → Command Dashboard: renders
- Browser UI → Inventory Controls: uses
- Browser UI → Orders Interface: uses
- Browser UI → RF Picking Center: uses
- Browser UI → Spatial Warehouse Map: uses
- Spatial Warehouse Map → 3D Warehouse Twin: controls
- Browser UI → Alerts Center: uses
- Browser UI → Analytics Views: uses
- Browser UI → AI Copilot: uses
- Browser UI → Optimizer Controls: uses
- Browser UI → Demo Simulator: uses
- Command Dashboard → Flask Routes: requests data
- Inventory Controls → Flask Routes: requests and updates
- Orders Interface → Flask Routes: requests allocation
- RF Picking Center → Flask Routes: submits pick actions
- Spatial Warehouse Map → Flask Routes: requests rebalance
- Alerts Center → Flask Routes: requests alerts
- Analytics Views → Flask Routes: requests metrics
- AI Copilot → Flask Routes: sends queries
- Optimizer Controls → Flask Routes: requests optimization
- Demo Simulator → Flask Routes: sends simulation events
- Flask Routes → Order Allocation: dispatches
- Flask Routes → Picking Execution: dispatches
- Flask Routes → Stock Replenishment: dispatches
- Flask Routes → Operational Analytics: computes
- Flask Routes → Intelligence Engine: calls
- Intelligence Engine → Health and Bottlenecks: calculates
- Intelligence Engine → Smart Allocation: recommends
- Intelligence Engine → Copilot Responses: answers
- Intelligence Engine → Global Optimization: executes
- Flask Routes → Database Access: accesses records
- Order Allocation → Database Access: reads and writes
- Picking Execution → Database Access: reads and writes
- Stock Replenishment → Database Access: updates stock
- Intelligence Engine → Database Access: queries and updates
- Operational Analytics → Database Access: reads records
- Database Access → Warehouse Records: reads and writes