How cancinoray/stockroom works
Stockroom is a distributor inventory and order-management application. Users inspect stock and its movement history, receive or adjust quantities, reserve all lines of an order atomically, then cancel or fulfil orders; the append-only ledger and invariant checks make stock changes auditable. The graph separates the React screens and API client, HTTP/API handling, domain rules, and persistence, while retaining telemetry and the documented on-call response capability. Some screen, domain, and operations implementation was not sampled, so uncertain links are omitted or marked unverified.
Main entry points: stock.py Stock endpoints · main.py FastAPI application · orders.py Order endpoints · App.tsx Screen navigation
Components 27
User interface
- Screen navigation
frontend/src/App.tsx - Inventory screen
frontend/src/screens/InventoryScreen.tsx - Place-order screen
frontend/src/screens/PlaceOrderScreen.tsx - Orders screen
frontend/src/screens/OrdersScreen.tsx - API query hooks
frontend/src/api/hooks.ts - HTTP API client
frontend/src/api/client.ts
HTTP API
- FastAPI application
backend/main.py - Stock endpoints
backend/api/stock.py - Order endpoints
backend/api/orders.py - Product endpoints
backend/api/products.py - API schemas
backend/api/schemas.py - OpenAPI contract
backend/api/openapi.py - Problem responses
backend/api/problems.py
Inventory domain
- Stock rules
backend/domain/stock.py - Movement ledger
backend/domain/movements.py - Ledger invariants
backend/domain/invariants.py
Persistence and telemetry
- Database sessions
backend/db/session.py - Database models
backend/db/models.py - PostgreSQL
- Telemetry
backend/telemetry.py
Operations response
- Evidence collection
on-call-engineer/collect_evidence.py - Evidence packet
on-call-engineer/packet.py - Responder agent
on-call-engineer/run_responder.py - Response policy
on-call-engineer/policy.py
Other components
- Distributor staff
- OTel collector
- Alert source
Connections 36
- Distributor staff → Screen navigation: uses
README.md - Screen navigation → Inventory screen: shows
frontend/src/App.tsx - Screen navigation → Place-order screen: shows
frontend/src/App.tsx - Screen navigation → Orders screen: shows
frontend/src/App.tsx - Inventory screen → API query hooks: queries
- Place-order screen → API query hooks: queries
frontend/src/screens/PlaceOrderScreen.tsx - Orders screen → API query hooks: queries
frontend/src/screens/OrdersScreen.tsx - API query hooks → HTTP API client: calls
- HTTP API client → FastAPI application: HTTP requests
README.md - FastAPI application → Stock endpoints: mounts
backend/main.py - FastAPI application → Order endpoints: mounts
backend/main.py - FastAPI application → Product endpoints: mounts
backend/main.py - FastAPI application → OpenAPI contract: installs
backend/main.py - Stock endpoints → API schemas: documents
backend/api/stock.py - Order endpoints → API schemas: documents
backend/api/orders.py - OpenAPI contract → API schemas: uses schemas
backend/api/openapi.py - Stock endpoints → Problem responses: builds errors
backend/api/stock.py - Order endpoints → Stock rules: uses rules
backend/api/orders.py - Stock endpoints → Ledger invariants: checks
backend/api/stock.py - Stock rules → Movement ledger: uses ledger
backend/domain/stock.py - Stock endpoints → Database sessions: opens sessions
backend/api/stock.py - Order endpoints → Database sessions: opens sessions
backend/api/orders.py - Product endpoints → Database sessions: opens sessions
backend/api/products.py - Database sessions → PostgreSQL: connects
backend/db/session.py - Stock endpoints → Database models: queries and writes
backend/api/stock.py - Order endpoints → Database models: queries and writes
backend/api/orders.py - Product endpoints → Database models: queries
backend/api/products.py - Stock endpoints → PostgreSQL: locks and appends
README.md - Order endpoints → PostgreSQL: locks and reserves
README.md - FastAPI application → Telemetry: starts and instruments
backend/main.py - Telemetry → Ledger invariants: checks drift
backend/telemetry.py - Telemetry → OTel collector: exports OTLP
README.md - Alert source → Evidence collection: triggers
- Evidence collection → Evidence packet: assembles
on-call-engineer/collect_evidence.py - Evidence packet → Responder agent: informs
README.md - Responder agent → Response policy: uses policy
on-call-engineer/run_responder.py