How tanto0366/inventory-os works
InventoryOS is a browser-based inventory and logistics system whose main workflow manages assets, issues gate passes, tracks resulting shipments, and records activity. The React app coordinates these operational views and synchronizes data with Google Sheets, with Firebase-backed sign-in and role checks. The graph also captures campaign, administration, and spreadsheet-import capabilities documented in the README. App and integration code excerpts are partial, so uncertain component-to-handler wiring is omitted.
Main entry points: App.tsx Application coordinator · googleSheets.ts Sheets integration · transactions.ts Movement transactions · importTemplateService.ts Inventory import
Components 24
Inventory operations
- Application coordinator
src/App.tsx - Asset management
src/components/AssetsView.tsx - Gate pass issuance
src/components/GatePassesView.tsx - Shipment tracking
src/components/ShipmentsView.tsx - Pass manifests
src/components/ShipmentManifestModal.tsx - Campaign deployment
src/components/CampaignsView.tsx - Operations dashboard
src/components/DashboardView.tsx - Inventory import
src/services/importTemplateService.ts
Access and oversight
- Audit activity
src/components/AuditTrailView.tsx - Admin console
src/components/EnterpriseAdminView.tsx - Role authorization
src/lib/auth.ts - Audit event creation
src/services/auditService.ts
Data integration
- Sync status
src/components/SyncStatus.tsx - Sheets integration
src/lib/googleSheets.ts - Firebase authentication
src/lib/firebase.ts
Domain services
- Movement transactions
src/domain/transactions.ts - Shipment state rules
src/domain/stateMachine.ts - Input validation
src/domain/validation.ts - Identifier generation
src/domain/identity.ts - Asset utilities
src/lib/assetUtils.ts - Runtime configuration
src/services/configService.ts
Other components
- Staff user
- Google Sheets service
- Browser local storage
Connections 30
- Staff user → Application coordinator: uses
- Application coordinator → Asset management: renders
- Application coordinator → Gate pass issuance: renders
- Application coordinator → Shipment tracking: renders
- Application coordinator → Campaign deployment: renders
- Application coordinator → Operations dashboard: renders
- Application coordinator → Audit activity: renders
- Application coordinator → Admin console: renders
- Application coordinator → Sync status: renders
- Application coordinator → Browser local storage: persists state
- Application coordinator → Sheets integration: syncs collections
- Application coordinator → Role authorization: checks roles
- Application coordinator → Firebase authentication: authenticates
- Application coordinator → Movement transactions: creates movements
- Movement transactions → Shipment state rules: checks transitions
- Movement transactions → Input validation: validates passes
- Movement transactions → Identifier generation: generates IDs
- Shipment tracking → Shipment state rules: checks transitions
- Application coordinator → Inventory import: imports inventory
- Inventory import → Identifier generation: allocates IDs
- Inventory import → Asset utilities: expands quantities
- Sheets integration → Google Sheets service: reads and writes
- Sheets integration → Firebase authentication: refreshes token
- Sheets integration → Asset utilities: expands quantities
- Role authorization → Runtime configuration: loads admin config
- Audit event creation → Identifier generation: generates event ID
- Application coordinator → Audit event creation: creates audit events
- Application coordinator → Pass manifests: shows manifest
- Sync status → Application coordinator: displays sync state
- Application coordinator → Runtime configuration: resolves settings