# rianpramudya/astra-project architecture

> Architecture diagram of the GitHub repository rianpramudya/astra-project, 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/rianpramudya/astra-project
- Repository: https://github.com/rianpramudya/astra-project

## Overview

This is a warehouse and shipping operations application for managing parts, packaging, containers, shipment instructions, live status, and 3D vanning simulations. Users enter through the Svelte console, choose a domain workflow, and the frontend API client sends requests to FastAPI routes; those routes serve operational data backed by SQLAlchemy models and a relational database. The graph preserves major documented workflows, including master data, monitoring, history, and 3D simulation. Backend route-to-storage links are shown where the source index or excerpts establish them; unsampled implementation details are not inferred.

Main entry points: [`frontend/src/lib/api.js`](https://github.com/rianpramudya/astra-project/blob/main/frontend/src/lib/api.js) (HTTP API client), [`backend/app/main.py`](https://github.com/rianpramudya/astra-project/blob/main/backend/app/main.py) (FastAPI app), [`backend/app/database/db.py`](https://github.com/rianpramudya/astra-project/blob/main/backend/app/database/db.py) (DB sessions), [`frontend/src/App.svelte`](https://github.com/rianpramudya/astra-project/blob/main/frontend/src/App.svelte) (Console navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Operations Console"]
  node_app_shell["Console navigation<br/>[App.svelte]"]
  node_api_client["HTTP API client<br/>[api.js]"]
  node_master_data_ui["Master data"]
  node_shipment_ui["Shipment setup"]
  node_simulation_ui["Vanning simulation<br/>[Simulations.svelte]"]
  node_live_ui["Live containers"]
  node_monitor_ui["Line monitoring"]
  node_history_ui["Operational history"]
end

subgraph group_backend_api["Backend Workflows"]
  node_assets_api["Assets API<br/>[assets.py]"]
  node_master_api["Master data APIs<br/>[boxes.py]"]
  node_shipment_api["Shipment and mapping APIs"]
  node_instruction_api["Instruction APIs"]
  node_status_api["Status and KPI APIs<br/>[packing_status.py]"]
  node_container_api["Container APIs<br/>[containers.py]"]
  node_simulation_api["3D simulation API<br/>[simulation_3d.py]"]
  node_container_3d_api["Container 3D API<br/>[container_3d.py]"]
  node_app_server["FastAPI app<br/>[main.py]"]
end

subgraph group_persistence["Persistence"]
  node_db_session["DB sessions<br/>[db.py]"]
  node_orm_models["Operational models<br/>[models.py]"]
  node_database[("Relational database")]
end

subgraph group_runtime["Realtime Processing"]
  node_packing_worker["Packing worker<br/>[packing_worker.py]"]
  node_websocket_manager["WebSocket manager<br/>[manager.py]"]
end

node_operator(("Operations user"))

node_operator -->|"uses"| node_app_shell
node_app_shell -->|"renders"| node_master_data_ui
node_app_shell -->|"renders"| node_shipment_ui
node_app_shell -->|"renders"| node_simulation_ui
node_app_shell -->|"renders"| node_live_ui
node_app_shell -->|"renders"| node_monitor_ui
node_app_shell -->|"renders"| node_history_ui
node_master_data_ui -->|"requests"| node_api_client
node_simulation_ui -->|"requests"| node_api_client
node_live_ui -->|"requests"| node_api_client
node_monitor_ui -->|"requests"| node_api_client
node_history_ui -->|"requests"| node_api_client
node_api_client -->|"calls"| node_assets_api
node_api_client -->|"calls"| node_master_api
node_api_client -->|"calls"| node_shipment_api
node_api_client -->|"calls"| node_instruction_api
node_api_client -->|"calls"| node_status_api
node_api_client -->|"calls"| node_container_api
node_api_client -->|"calls"| node_simulation_api
node_api_client -->|"calls"| node_container_3d_api
node_app_server -->|"registers"| node_assets_api
node_app_server -->|"registers"| node_master_api
node_app_server -->|"registers"| node_shipment_api
node_app_server -->|"registers"| node_instruction_api
node_app_server -->|"registers"| node_status_api
node_app_server -->|"registers"| node_container_api
node_app_server -->|"registers"| node_simulation_api
node_app_server -->|"registers"| node_container_3d_api
node_app_server -->|"initializes"| node_db_session
node_assets_api -->|"uses sessions"| node_db_session
node_container_api -->|"uses sessions"| node_db_session
node_simulation_api -->|"uses sessions"| node_db_session
node_container_3d_api -->|"uses sessions"| node_db_session
node_db_session -->|"initializes metadata"| node_orm_models
node_orm_models -->|"imports base"| node_db_session
node_db_session -.->|"connects"| node_database
node_packing_worker -->|"uses sessions"| node_db_session
node_app_server -->|"connects clients"| node_websocket_manager

click node_app_shell "https://github.com/rianpramudya/astra-project/blob/main/frontend/src/App.svelte"
click node_api_client "https://github.com/rianpramudya/astra-project/blob/main/frontend/src/lib/api.js"
click node_master_data_ui "https://github.com/rianpramudya/astra-project/tree/main/frontend/src/routes/MasterData"
click node_shipment_ui "https://github.com/rianpramudya/astra-project/blob/main/frontend/src/routes/ShipmentHeader.svelte"
click node_simulation_ui "https://github.com/rianpramudya/astra-project/blob/main/frontend/src/routes/Simulations.svelte"
click node_live_ui "https://github.com/rianpramudya/astra-project/tree/main/frontend/src/routes/LiveContainers"
click node_monitor_ui "https://github.com/rianpramudya/astra-project/tree/main/frontend/src/routes/YellowLineMonitoring"
click node_history_ui "https://github.com/rianpramudya/astra-project/tree/main/frontend/src/routes/HistoryLogs"
click node_assets_api "https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/assets.py"
click node_master_api "https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/boxes.py"
click node_shipment_api "https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/shipment_headers.py"
click node_instruction_api "https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/picking_instruction.py"
click node_status_api "https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/packing_status.py"
click node_container_api "https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/containers.py"
click node_simulation_api "https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/simulation_3d.py"
click node_container_3d_api "https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/container_3d.py"
click node_app_server "https://github.com/rianpramudya/astra-project/blob/main/backend/app/main.py"
click node_db_session "https://github.com/rianpramudya/astra-project/blob/main/backend/app/database/db.py"
click node_orm_models "https://github.com/rianpramudya/astra-project/blob/main/backend/app/models/models.py"
click node_packing_worker "https://github.com/rianpramudya/astra-project/blob/main/backend/app/workers/packing_worker.py"
click node_websocket_manager "https://github.com/rianpramudya/astra-project/blob/main/backend/app/websocket/manager.py"

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_shell,node_api_client,node_master_data_ui,node_shipment_ui,node_simulation_ui,node_live_ui,node_monitor_ui,node_history_ui,node_operator toneBlue
class node_assets_api,node_master_api,node_shipment_api,node_instruction_api,node_status_api,node_container_api,node_simulation_api,node_container_3d_api,node_app_server toneAmber
class node_db_session,node_orm_models,node_database toneMint
class node_packing_worker,node_websocket_manager toneRose
```

## Components

### Operations Console

- [Console navigation](https://github.com/rianpramudya/astra-project/blob/main/frontend/src/App.svelte): `frontend/src/App.svelte`
- [HTTP API client](https://github.com/rianpramudya/astra-project/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`
- [Master data](https://github.com/rianpramudya/astra-project/tree/main/frontend/src/routes/MasterData): `frontend/src/routes/MasterData`
- [Shipment setup](https://github.com/rianpramudya/astra-project/blob/main/frontend/src/routes/ShipmentHeader.svelte): `frontend/src/routes/ShipmentHeader.svelte`
- [Vanning simulation](https://github.com/rianpramudya/astra-project/blob/main/frontend/src/routes/Simulations.svelte): `frontend/src/routes/Simulations.svelte`
- [Live containers](https://github.com/rianpramudya/astra-project/tree/main/frontend/src/routes/LiveContainers): `frontend/src/routes/LiveContainers`
- [Line monitoring](https://github.com/rianpramudya/astra-project/tree/main/frontend/src/routes/YellowLineMonitoring): `frontend/src/routes/YellowLineMonitoring`
- [Operational history](https://github.com/rianpramudya/astra-project/tree/main/frontend/src/routes/HistoryLogs): `frontend/src/routes/HistoryLogs`

### Backend Workflows

- [Assets API](https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/assets.py): `backend/app/api/assets.py`
- [Master data APIs](https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/boxes.py): `backend/app/api/boxes.py`
- [Shipment and mapping APIs](https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/shipment_headers.py): `backend/app/api/shipment_headers.py`
- [Instruction APIs](https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/picking_instruction.py): `backend/app/api/picking_instruction.py`
- [Status and KPI APIs](https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/packing_status.py): `backend/app/api/packing_status.py`
- [Container APIs](https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/containers.py): `backend/app/api/containers.py`
- [3D simulation API](https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/simulation_3d.py): `backend/app/api/simulation_3d.py`
- [Container 3D API](https://github.com/rianpramudya/astra-project/blob/main/backend/app/api/container_3d.py): `backend/app/api/container_3d.py`
- [FastAPI app](https://github.com/rianpramudya/astra-project/blob/main/backend/app/main.py): `backend/app/main.py`

### Persistence

- [DB sessions](https://github.com/rianpramudya/astra-project/blob/main/backend/app/database/db.py): `backend/app/database/db.py`
- [Operational models](https://github.com/rianpramudya/astra-project/blob/main/backend/app/models/models.py): `backend/app/models/models.py`
- **Relational database**

### Realtime Processing

- [Packing worker](https://github.com/rianpramudya/astra-project/blob/main/backend/app/workers/packing_worker.py): `backend/app/workers/packing_worker.py`
- [WebSocket manager](https://github.com/rianpramudya/astra-project/blob/main/backend/app/websocket/manager.py): `backend/app/websocket/manager.py`

### Other components

- **Operations user**

## Connections

- Operations user → Console navigation: uses (evidence: `frontend/src/App.svelte`)
- Console navigation → Master data: renders (evidence: `frontend/src/App.svelte`)
- Console navigation → Shipment setup: renders (evidence: `frontend/src/App.svelte`)
- Console navigation → Vanning simulation: renders (evidence: `frontend/src/App.svelte`)
- Console navigation → Live containers: renders (evidence: `frontend/src/App.svelte`)
- Console navigation → Line monitoring: renders (evidence: `frontend/src/App.svelte`)
- Console navigation → Operational history: renders (evidence: `frontend/src/App.svelte`)
- Master data → HTTP API client: requests (evidence: `frontend/src/routes/MasterData/PartDatabase.svelte`)
- Vanning simulation → HTTP API client: requests (evidence: `frontend/src/routes/Simulations.svelte`)
- Live containers → HTTP API client: requests (evidence: `frontend/src/routes/LiveContainers/3DViews&Tracking.svelte`)
- Line monitoring → HTTP API client: requests (evidence: `frontend/src/routes/YellowLineMonitoring/PackingStatus.svelte`)
- Operational history → HTTP API client: requests (evidence: `frontend/src/routes/HistoryLogs/PackingInstruction.svelte`)
- HTTP API client → Assets API: calls (evidence: `frontend/src/lib/api.js`)
- HTTP API client → Master data APIs: calls (evidence: `frontend/src/lib/api.js`)
- HTTP API client → Shipment and mapping APIs: calls (evidence: `frontend/src/lib/api.js`)
- HTTP API client → Instruction APIs: calls (evidence: `frontend/src/lib/api.js`)
- HTTP API client → Status and KPI APIs: calls (evidence: `frontend/src/lib/api.js`)
- HTTP API client → Container APIs: calls (evidence: `frontend/src/lib/api.js`)
- HTTP API client → 3D simulation API: calls (evidence: `frontend/src/lib/api.js`)
- HTTP API client → Container 3D API: calls (evidence: `frontend/src/lib/api.js`)
- FastAPI app → Assets API: registers (evidence: `backend/app/main.py`)
- FastAPI app → Master data APIs: registers (evidence: `backend/app/main.py`)
- FastAPI app → Shipment and mapping APIs: registers (evidence: `backend/app/main.py`)
- FastAPI app → Instruction APIs: registers (evidence: `backend/app/main.py`)
- FastAPI app → Status and KPI APIs: registers (evidence: `backend/app/main.py`)
- FastAPI app → Container APIs: registers (evidence: `backend/app/main.py`)
- FastAPI app → 3D simulation API: registers (evidence: `backend/app/main.py`)
- FastAPI app → Container 3D API: registers (evidence: `backend/app/main.py`)
- FastAPI app → DB sessions: initializes (evidence: `backend/app/main.py`)
- Assets API → DB sessions: uses sessions (evidence: `backend/app/api/assets.py`)
- Container APIs → DB sessions: uses sessions (evidence: `backend/app/api/containers.py`)
- 3D simulation API → DB sessions: uses sessions (evidence: `backend/app/api/simulation_3d.py`)
- Container 3D API → DB sessions: uses sessions (evidence: `backend/app/api/container_3d.py`)
- DB sessions → Operational models: initializes metadata (evidence: `backend/app/database/db.py`)
- Operational models → DB sessions: imports base (evidence: `backend/app/models/models.py`)
- DB sessions → Relational database: connects
- Packing worker → DB sessions: uses sessions (evidence: `backend/app/workers/packing_worker.py`)
- FastAPI app → WebSocket manager: connects clients (evidence: `backend/app/main.py`)
