How akhileshjoshi10/ai-powered-operating-intelligence-platform works
SmartMart is an operating-intelligence platform that turns business data into reviewed management actions and executive briefs. Its documented workflow runs from validation and storage through deterministic analysis, issue prioritization, evidence-based diagnosis, agent enhancement, recommendations, human approval, tasks, and automation. The graph preserves major documented capabilities, including knowledge retrieval and controlled tools. README-documented relationships are cited there; source-level wiring is limited to shown imports and calls. Several major subsystems are represented by their exact service or analytics paths, but their unsampled internals are not asserted.
Main entry points: orchestrator.py Multi-agent workflow · database.py PostgreSQL store · llm_tool_execution_service.py LLM tool execution · main.py FastAPI control layer
Components 21
Data foundation
- Import and validation
backend/app/services/data_import_service.py - PostgreSQL store
backend/database.py
Business intelligence
- Deterministic analytics
backend/analytics/priority_engine.py - Issue detection
backend/analytics/issue_detection.py - Priority ranking
backend/analytics/priority_engine.py - Evidence and root cause
backend/analytics/root_cause_analysis.py
Agent decision support
- Knowledge retrieval
backend/app/services/knowledge_service.py - Controlled tools
backend/app/tools/tool_executor.py - Multi-agent workflow
backend/app/agents/orchestrator.py - LLM tool execution
backend/app/services/llm_tool_execution_service.py - LLM providers
backend/app/llm/groq_provider.py
Action and oversight
- Recommendations
backend/app/services/recommendation_service.py - Manager review
backend/app/routers/recommendations.py - Task tracking
backend/app/services/task_service.py - Workflow automation
backend/app/services/automation_service.py - Executive briefs
backend/app/services/executive_brief_service.py
Application access
- FastAPI control layer
backend/app/main.py - Web authentication
frontend/src/auth/tokenStorage.ts
Other components
- Business data
- Manager / application user
- n8n automation
Connections 23
- Business data → Import and validation: ingests and validates
README.md - Import and validation → PostgreSQL store: loads data
README.md - PostgreSQL store → Deterministic analytics: supplies data
README.md - Deterministic analytics → Issue detection: detects risks
README.md - Issue detection → Priority ranking: ranks issues
README.md - Priority ranking → Evidence and root cause: supports diagnosis
README.md - Evidence and root cause → Multi-agent workflow: enhances analysis
README.md - Knowledge retrieval → Multi-agent workflow: provides retrieved knowledge
README.md - Controlled tools → Multi-agent workflow: provides tool outputs
README.md - Multi-agent workflow → LLM tool execution: uses controlled tools
- LLM tool execution → LLM providers: requests generation
backend/app/services/llm_tool_execution_service.py - LLM tool execution → Controlled tools: executes tool calls
backend/app/services/llm_tool_execution_service.py - Multi-agent workflow → Recommendations: generates actions
README.md - Recommendations → Manager review: submits for review
README.md - Manager review → Task tracking: converts approved actions
- Task tracking → Workflow automation: triggers follow-ups
README.md - Workflow automation → n8n automation: dispatches workflows
README.md - FastAPI control layer → Executive briefs: serves brief routes
backend/app/main.py - FastAPI control layer → Multi-agent workflow: serves chief-of-staff route
backend/app/main.py - PostgreSQL store → Executive briefs: informs briefs
README.md - Manager / application user → Web authentication: authenticates
- Web authentication → FastAPI control layer: calls authenticated API
- Manager / application user → Manager review: accepts, edits, or rejects
README.md