How rianpramudya/astra-project works
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: api.js HTTP API client · main.py FastAPI app · db.py DB sessions · App.svelte Console navigation
Components 23
Operations Console
- Console navigation
frontend/src/App.svelte - HTTP API client
frontend/src/lib/api.js - Master data
frontend/src/routes/MasterData - Shipment setup
frontend/src/routes/ShipmentHeader.svelte - Vanning simulation
frontend/src/routes/Simulations.svelte - Live containers
frontend/src/routes/LiveContainers - Line monitoring
frontend/src/routes/YellowLineMonitoring - Operational history
frontend/src/routes/HistoryLogs
Backend Workflows
- Assets API
backend/app/api/assets.py - Master data APIs
backend/app/api/boxes.py - Shipment and mapping APIs
backend/app/api/shipment_headers.py - Instruction APIs
backend/app/api/picking_instruction.py - Status and KPI APIs
backend/app/api/packing_status.py - Container APIs
backend/app/api/containers.py - 3D simulation API
backend/app/api/simulation_3d.py - Container 3D API
backend/app/api/container_3d.py - FastAPI app
backend/app/main.py
Persistence
- DB sessions
backend/app/database/db.py - Operational models
backend/app/models/models.py - Relational database
Realtime Processing
- Packing worker
backend/app/workers/packing_worker.py - WebSocket manager
backend/app/websocket/manager.py
Other components
- Operations user
Connections 38
- Operations user → Console navigation: uses
frontend/src/App.svelte - Console navigation → Master data: renders
frontend/src/App.svelte - Console navigation → Shipment setup: renders
frontend/src/App.svelte - Console navigation → Vanning simulation: renders
frontend/src/App.svelte - Console navigation → Live containers: renders
frontend/src/App.svelte - Console navigation → Line monitoring: renders
frontend/src/App.svelte - Console navigation → Operational history: renders
frontend/src/App.svelte - Master data → HTTP API client: requests
frontend/src/routes/MasterData/PartDatabase.svelte - Vanning simulation → HTTP API client: requests
frontend/src/routes/Simulations.svelte - Live containers → HTTP API client: requests
frontend/src/routes/LiveContainers/3DViews&Tracking.svelte - Line monitoring → HTTP API client: requests
frontend/src/routes/YellowLineMonitoring/PackingStatus.svelte - Operational history → HTTP API client: requests
frontend/src/routes/HistoryLogs/PackingInstruction.svelte - HTTP API client → Assets API: calls
frontend/src/lib/api.js - HTTP API client → Master data APIs: calls
frontend/src/lib/api.js - HTTP API client → Shipment and mapping APIs: calls
frontend/src/lib/api.js - HTTP API client → Instruction APIs: calls
frontend/src/lib/api.js - HTTP API client → Status and KPI APIs: calls
frontend/src/lib/api.js - HTTP API client → Container APIs: calls
frontend/src/lib/api.js - HTTP API client → 3D simulation API: calls
frontend/src/lib/api.js - HTTP API client → Container 3D API: calls
frontend/src/lib/api.js - FastAPI app → Assets API: registers
backend/app/main.py - FastAPI app → Master data APIs: registers
backend/app/main.py - FastAPI app → Shipment and mapping APIs: registers
backend/app/main.py - FastAPI app → Instruction APIs: registers
backend/app/main.py - FastAPI app → Status and KPI APIs: registers
backend/app/main.py - FastAPI app → Container APIs: registers
backend/app/main.py - FastAPI app → 3D simulation API: registers
backend/app/main.py - FastAPI app → Container 3D API: registers
backend/app/main.py - FastAPI app → DB sessions: initializes
backend/app/main.py - Assets API → DB sessions: uses sessions
backend/app/api/assets.py - Container APIs → DB sessions: uses sessions
backend/app/api/containers.py - 3D simulation API → DB sessions: uses sessions
backend/app/api/simulation_3d.py - Container 3D API → DB sessions: uses sessions
backend/app/api/container_3d.py - DB sessions → Operational models: initializes metadata
backend/app/database/db.py - Operational models → DB sessions: imports base
backend/app/models/models.py - DB sessions → Relational database: connects
- Packing worker → DB sessions: uses sessions
backend/app/workers/packing_worker.py - FastAPI app → WebSocket manager: connects clients
backend/app/main.py