How speedster150/retailpilot-ai works
This appears to be a multi-tenant retail operations workspace: staff manage inventory, purchasing, suppliers, goods receipts, sales and related business records; reporting, automation and AI/MCP interfaces provide analysis and actions. The graph follows evidenced route-to-handler and service calls, plus the shared stock, finance and reporting layers. Several dashboard capabilities are represented from the file tree, but their internal wiring is not asserted because those sources were not sampled; the README is a generic Next.js starter.
Main entry points: stock.ts Stock Engine · mcp/server.ts MCP Server · low-stock-alert.ts Low Stock Alerts · supabase/server.ts Supabase Client
Components 28
Retail Operations
- Workspace Pages
app/(dashbaord)/dashboard/page.tsx - Inventory
app/(dashbaord)/inventory/page.tsx - Purchases
app/(dashbaord)/purchases/purchase-management.tsx - Goods Receipts
app/(dashbaord)/goods-receipts/goods-receipt-management.tsx - Suppliers
app/(dashbaord)/suppliers/supplier-management.tsx - Sales POS
app/(dashbaord)/sales/pos-terminal.tsx - Customers
app/(dashbaord)/customers/customer-management.tsx - Other Operations
app/(dashbaord)
Analytics Automation
- Stock Engine
lib/inventory/stock.ts - Dead Stock
lib/inventory/dead-stock.ts - Profitability
lib/finance/profitability.ts - Supplier Outstanding
lib/finance/supplier-outstanding.ts - Business Reports
lib/reports/business-report.ts - Automation Routes
app/api/automation - Daily Dossier
lib/automation/daily-sales-dossier.ts - Low Stock Alerts
lib/automation/low-stock-alert.ts - Dead Stock Audit
lib/automation/dead-stock-audit.ts - Monthly Report
lib/automation/monthly-executive-report.ts - Supplier Escalation
lib/automation/supplier-escalation.ts
AI MCP
- AI Assistant
lib/ai/assistant.ts - MCP Endpoint
app/api/mcp/route.ts - MCP Server
lib/mcp/server.ts - MCP Registry
lib/mcp/registry.ts - Chat Endpoint
app/api/ai/chat/route.ts
Identity Data
- Tenant Context
lib/auth/context.ts - Supabase Client
lib/supabase/server.ts - Supabase
Other components
- Staff
Connections 41
- Staff → Workspace Pages: uses
- Workspace Pages → Inventory: navigates
- Inventory → Stock Engine: uses
app/(dashbaord)/inventory/page.tsx - Inventory → Supabase Client: queries
app/(dashbaord)/inventory/page.tsx - Purchases → Goods Receipts: records receipts
- Goods Receipts → Supabase Client: uses
- Purchases → Supabase Client: uses
- Suppliers → Supabase Client: uses
- Stock Engine → Supabase: reads inventory
- Dead Stock → Stock Engine: calculates stock
lib/inventory/dead-stock.ts - Profitability → Stock Engine: uses
lib/finance/profitability.ts - Supplier Outstanding → Stock Engine: uses
lib/finance/supplier-outstanding.ts - Business Reports → Stock Engine: uses
lib/reports/business-report.ts - Business Reports → Dead Stock: uses
lib/reports/business-report.ts - Business Reports → Supplier Outstanding: uses
lib/reports/business-report.ts - Automation Routes → Daily Dossier: dispatches
app/api/automation/daily-dossier/route.ts - Automation Routes → Low Stock Alerts: dispatches
app/api/automation/low-stock/route.ts - Automation Routes → Dead Stock Audit: dispatches
app/api/automation/dead-stock/route.ts - Automation Routes → Monthly Report: dispatches
app/api/automation/monthly-executive-report/route.ts - Automation Routes → Supplier Escalation: dispatches
app/api/automation/supplier-escalation/route.ts - Daily Dossier → Stock Engine: uses
lib/automation/daily-sales-dossier.ts - Daily Dossier → Low Stock Alerts: uses
lib/automation/daily-sales-dossier.ts - Low Stock Alerts → Stock Engine: calculates stock
lib/automation/low-stock-alert.ts - Dead Stock Audit → Dead Stock: uses
lib/automation/dead-stock-audit.ts - Dead Stock Audit → Low Stock Alerts: uses
lib/automation/dead-stock-audit.ts - Monthly Report → Business Reports: uses
lib/automation/monthly-executive-report.ts - Monthly Report → Low Stock Alerts: uses
lib/automation/monthly-executive-report.ts - Supplier Escalation → Supplier Outstanding: uses
lib/automation/supplier-escalation.ts - Supplier Escalation → Low Stock Alerts: uses
lib/automation/supplier-escalation.ts - Chat Endpoint → Tenant Context: authenticates
app/api/ai/chat/route.ts - Chat Endpoint → AI Assistant: dispatches
app/api/ai/chat/route.ts - AI Assistant → MCP Registry: executes tools
lib/ai/assistant.ts - MCP Endpoint → Tenant Context: authenticates
app/api/mcp/route.ts - MCP Endpoint → MCP Server: creates server
app/api/mcp/route.ts - MCP Server → Stock Engine: queries
lib/mcp/server.ts - MCP Server → Dead Stock: queries
lib/mcp/server.ts - MCP Server → Profitability: queries
lib/mcp/server.ts - MCP Server → Business Reports: generates report
lib/mcp/server.ts - MCP Registry → MCP Server: registers tools
lib/mcp/registry.ts - Tenant Context → Supabase Client: creates client
lib/auth/context.ts - Supabase Client → Supabase: connects