How ddelgadillod/inventaio works
InventAI/o is an analytics and decision-support product for grocery distributors: users sign in to the web app, inspect inventory, alerts and reports, and request forecasts and purchasing or transfer recommendations; Vera provides read-only conversational access. The Core API enforces authentication and role-based access while serving analytical queries and coordinating ML and chat services. ETL loads the star-schema warehouse, and the ML service computes forecasts and recommendations from it. Edges follow the README and cited source references; some internals are unsampled, so those relationships are left out or marked unverified.
Main entry points: api/main.py Core API routing · database.py Star-schema warehouse · ml_service/main.py ML service · servicio.py Demand forecasts
Components 21
Web application
- Web screens
frontend/src/App.jsx - Chat interface
frontend/src/components/chat/PanelChat.jsx
Core API
- Authentication and roles
api/auth/dependencies.py - Core API routing
api/main.py - Inventory queries
api/inventario/router.py - Catalog queries
api/consulta/router.py - Rule and AI alerts
api/alertas/router.py - Reports and KPIs
api/reportes/router.py - Recommendation API
api/ml/router.py - Chat gateway
api/chat/router.py
Forecasting and recommendations
- ML service
ml_service/main.py - Demand forecasts
ml_service/prediccion/servicio.py - Purchase recommendations
ml_service/compras/motor.py - Transfer recommendations
ml_service/transferencias/motor.py - ML warehouse access
ml_service/prediccion/bodega.py
Vera assistant
- Agent orchestration
nlp_agent/agente/bucle.py - Read-only tools
nlp_agent/herramientas/catalogo.py - Local language model
nlp_agent/llm/cliente.py
Analytical data
- Real-data ETL
etl_real/cargar_postgres.py - Star-schema warehouse
api/core/database.py
Other components
- Distributor user
Connections 28
- Distributor user → Web screens: uses
README.md - Web screens → Core API routing: calls
README.md - Web screens → Chat interface: opens
frontend/src/App.jsx - Chat interface → Chat gateway: streams chat
README.md - Core API routing → Authentication and roles: applies auth
api/main.py - Core API routing → Inventory queries: routes to
api/main.py - Core API routing → Catalog queries: routes to
api/main.py - Core API routing → Rule and AI alerts: routes to
api/main.py - Core API routing → Reports and KPIs: routes to
api/main.py - Core API routing → Recommendation API: routes to
api/main.py - Core API routing → Chat gateway: routes to
api/main.py - Inventory queries → Star-schema warehouse: queries
api/inventario/router.py - Catalog queries → Star-schema warehouse: queries
api/consulta/router.py - Rule and AI alerts → Star-schema warehouse: queries
api/alertas/router.py - Reports and KPIs → Star-schema warehouse: queries
api/reportes/router.py - Recommendation API → ML service: requests results
api/ml/router.py - ML service → Demand forecasts: initializes
ml_service/main.py - ML service → Purchase recommendations: serves
ml_service/main.py - ML service → Transfer recommendations: serves
ml_service/main.py - Demand forecasts → ML warehouse access: uses warehouse
- Purchase recommendations → Demand forecasts: uses forecasts
- Transfer recommendations → Demand forecasts: uses forecasts
ml_service/transferencias/motor.py - ML warehouse access → Star-schema warehouse: reads
- Real-data ETL → Star-schema warehouse: loads data
README.md - Chat gateway → Agent orchestration: forwards stream
api/chat/router.py - Agent orchestration → Read-only tools: dispatches tools
- Agent orchestration → Local language model: uses model
- Read-only tools → Core API routing: queries Core API
README.md