How afiroj313501/stockpilot works
StockPilot AI is a retail inventory and point-of-sale platform. Staff use its web application to manage products, stock, purchasing, sales and returns; managers and owners also access reports, reorder recommendations and an assistant. The API applies session, store and role checks before domain routes call services, with Prisma as the persistence layer. The README is brief and the sampled source is selective, so web-to-API calls and unsampled service internals are not mapped; documented route-to-service relationships are shown where the index or excerpts support them.
Main entry points: app.ts API application · App.tsx Web routes · auth.service.ts Account and sessions · purchases Purchasing and receiving
Components 24
Web application
- Web routes
apps/web/src/App.tsx - Operations screens
apps/web/src/pages - Insights screens
apps/web/src/pages
Access and platform
- API application
apps/api/src/app.ts - Authentication routes
apps/api/src/modules/auth/auth.routes.ts - Session middleware
apps/api/src/modules/auth/auth.middleware.ts - Account and sessions
apps/api/src/modules/auth/auth.service.ts - Store and role checks
apps/api/src/modules/auth/store.middleware.ts - Prisma data access
apps/api/src/db/prisma.ts - Store users
apps/api/src/modules/users - Store and health endpoints
apps/api/src/modules/stores
Retail operations
- Catalog management
apps/api/src/modules/products - Stock management
apps/api/src/modules/inventory - Purchasing and receiving
apps/api/src/modules/purchases - POS and sales
apps/api/src/modules/sales - Returns and refunds
apps/api/src/modules/returns - Supplier management
apps/api/src/modules/suppliers - Category management
apps/api/src/modules/categories - Store settings
apps/api/src/modules/settings
Insights and assistance
- Reorder forecasting
apps/api/src/modules/forecasting - Reports and exports
apps/api/src/modules/reports - Audit history
apps/api/src/modules/audit - AI assistant
apps/api/src/modules/ai
Other components
- Retail staff
Connections 24
- Retail staff → Web routes: uses
- Web routes → Operations screens: routes to
apps/web/src/App.tsx - Web routes → Insights screens: routes to
apps/web/src/App.tsx - API application → Authentication routes: mounts
apps/api/src/app.ts - API application → Catalog management: mounts
apps/api/src/app.ts - API application → Stock management: mounts
apps/api/src/app.ts - API application → Purchasing and receiving: mounts
apps/api/src/app.ts - API application → POS and sales: mounts
apps/api/src/app.ts - API application → Returns and refunds: mounts
apps/api/src/app.ts - API application → Reorder forecasting: mounts
apps/api/src/app.ts - API application → Reports and exports: mounts
apps/api/src/app.ts - API application → Audit history: mounts
apps/api/src/app.ts - API application → AI assistant: mounts
apps/api/src/app.ts - API application → Supplier management: mounts
apps/api/src/app.ts - API application → Category management: mounts
apps/api/src/app.ts - API application → Store settings: mounts
apps/api/src/app.ts - API application → Store users: mounts
apps/api/src/app.ts - API application → Store and health endpoints: mounts
apps/api/src/app.ts - Authentication routes → Account and sessions: handles accounts
apps/api/src/modules/auth/auth.routes.ts - Session middleware → Account and sessions: resolves sessions
apps/api/src/modules/auth/auth.middleware.ts - Account and sessions → Prisma data access: reads and writes
apps/api/src/modules/auth/auth.service.ts - Purchasing and receiving → Reorder forecasting: creates draft orders
- Reorder forecasting → Purchasing and receiving: approves to draft
apps/api/src/modules/forecasting/forecasting.routes.ts - Reports and exports → Reports and exports: builds exports
apps/api/src/modules/reports/reports.routes.ts