Shared details page for the full Invio team. Use this as the project baseline for architecture, scope, repository responsibilities, and current implementation conventions.
Build a reliable inventory platform for small and multi-store retailers.
Store operators, inventory managers, and admin teams.
Product/barcode catalog + immutable stock movement ledger + offline scan sync.
Fast operation on the floor, strict traceability in the backend.
SKU identity, barcode mappings, and category metadata.
Per-location inventory scope and threshold settings.
IN / OUT / ADJUST events as append-only records.
Mobile-captured event batch for offline-first synchronization.
RBAC rules for product updates, stock edits, and reporting access.
| Repo | Responsibility | Key Focus | Run Command |
|---|---|---|---|
| backend | API and inventory domain logic | Product catalog, stock movements, RBAC, alerts, sync ingestion | uvicorn app.main:app --reload |
| frontend | Admin dashboard for management workflows | Products, stores/users, stock summary, reports, optional supplier module | (app-specific frontend command) |
| mobile | Store-floor scanning companion app | Fast barcode scan, stock actions, offline capture + background sync | (mobile project runner) |
| pages | Project references and documentation | Shared team docs, project overview, links and guidance | Static hosting |
Scan or enter stock actions from mobile/web interfaces.
Apply RBAC, product/store checks, and movement rules.
Write immutable movement records and audit-relevant metadata.
Update views and emit low-stock signals for operations teams.
Stock ledger should remain append-only to preserve audit history.
Mobile batching must be idempotent to avoid duplicated stock movements.
RBAC required for stock adjustment, catalog edit, and user management.
Keep health endpoint and structured logs available in all environments.