How 1vannce/rcwheels-systems-integration works
RCWheels is a browser-based business-management prototype for staff to manage requisitions, inventory, purchasing, and delivery against a shared database. The main workflow is request submission and review, stock reservation and issue preparation, delivery, and acceptance with quantities and history tracked centrally. Authentication and role-based access gate the app; inventory services enforce stock movements. Purchasing and delivery are documented capabilities, but their implementations were not sampled, so their internal flows are not inferred. Links between stages reflect README statements where source evidence was unavailable.
Main entry points: requisition Requisition workflow · index.ts PostgreSQL database · page.tsx Request detail page · session.service.ts Session and access
Components 15
Access and shared services
- App routes
src/app - Session and access
src/modules/core/services/session.service.ts - Supabase Auth
- Audit and notifications
src/modules/core
Requisition lifecycle
- Requisition workflow
src/modules/requisition - Request detail page
src/app/(app)/requisitions/[requisitionId]/page.tsx - Requisition records
src/modules/requisition/repositories/requisition.repository.ts
Inventory control
- Inventory operations
src/modules/inventory - Stock movements
src/modules/inventory/services/stock.service.ts - Stock queries
src/modules/inventory/repositories/stock.repository.ts
Business data and operations
- Purchasing
src/modules/purchasing - Delivery
src/modules/delivery - PostgreSQL database
src/db/index.ts - Shared domain schema
src/db/schema
Other components
- Staff
Connections 20
- Staff → App routes: uses
- App routes → Session and access: requires identity
src/app/(app)/requisitions/[requisitionId]/page.tsx - Session and access → Supabase Auth: verifies session
src/modules/core/services/session.service.ts - Session and access → Audit and notifications: audits denials
src/modules/core/services/authorization.service.ts - App routes → Request detail page: routes to
- Request detail page → Session and access: requires user
src/app/(app)/requisitions/[requisitionId]/page.tsx - Request detail page → Requisition workflow: loads details
src/app/(app)/requisitions/[requisitionId]/page.tsx - Requisition workflow → Requisition records: queries records
src/modules/requisition/services/requisition.prep-AR.service.ts - Requisition workflow → Inventory operations: checks quantities
src/modules/requisition/services/requisition.prep-AR.service.ts - Requisition workflow → Audit and notifications: notifies roles
src/modules/requisition/services/requisition.prep-AR.service.ts - Request detail page → Inventory operations: loads stock
src/app/(app)/requisitions/[requisitionId]/page.tsx - Inventory operations → Stock movements: manages balances
src/modules/inventory/index.ts - Stock movements → Stock queries: updates stock
src/modules/inventory/services/stock.service.ts - Requisition workflow → Delivery: prepares delivery
- Requisition workflow → Purchasing: connects purchasing
- Requisition workflow → PostgreSQL database: stores workflow data
src/modules/requisition/repositories/requisition.repository.ts - Inventory operations → PostgreSQL database: stores stock data
src/modules/inventory/services/stock.service.ts - Purchasing → PostgreSQL database: shares central data
- Delivery → PostgreSQL database: shares central data
- PostgreSQL database → Shared domain schema: uses tables
src/db/index.ts