How vaish1101/enterprise-analytics-copilot works
Enterprise Analytics Copilot serves governed KPI investigations: a user asks a question, the web client submits it to the API, and a bounded backend workflow plans the request, performs deterministic analysis and/or evidence retrieval, synthesizes claims, verifies them, and presents a supported answer or a boundary. The graph also shows the interface’s result-view layer and major documented capabilities. Backend wiring is better evidenced than the frontend transport details; optional or unverified links are marked dashed.
Main entry points: graph.py Workflow orchestrator · retrieve.py Evidence retrieval · App.tsx Experience app · service.py Graph service
Components 25
Product interface
- Experience app
frontend/src/App.tsx - Question interface
frontend/src/landing/Landing.tsx - Result view model
frontend/src/lib/viewModel.ts - Analysis workspace
frontend/src/workspace/Workspace.tsx - Workflow illustration
frontend/src/scene/PrecisionEngine.ts
API boundary
- HTTP application
src/api/app.py - API routes
src/api/routes - Graph service
src/api/service.py
Analysis workflow
- Question planner
src/planning/planner.py - Workflow orchestrator
src/orchestration/graph.py - Structured synthesis
src/llm/openai_provider.py - Independent verifier
src/orchestration/verifier.py - Bounded agent runtime
src/bounded_agents/runtime.py
Evidence and analytics
- Governed analytics
src/analytics/executor.py - Deterministic calculations
src/analytics/calculations.py - Evidence retrieval
src/retrieval/retrieve.py - Governed query
src/retrieval/query.py - Dense embeddings
src/retrieval/embeddings.py - Vector store
src/retrieval/vector_store.py
Contracts and state
- Metric contracts
src/schemas/models.py - Plan contracts
src/planning/models.py - Evidence contracts
src/retrieval/models.py - Workflow checkpoints
src/persistence/checkpoint_store.py
Other components
- Business user
- Browser
Connections 26
- Business user → Question interface: asks
README.md - Question interface → Experience app: submits question
frontend/src/App.tsx - Experience app → Result view model: builds result
frontend/src/App.tsx - Experience app → Analysis workspace: renders
frontend/src/App.tsx - Experience app → Workflow illustration: shows workflow
frontend/src/App.tsx - Experience app → HTTP application: sends request
- Browser → HTTP application: calls HTTP API
- HTTP application → API routes: registers
src/api/app.py - API routes → Graph service: delegates query
src/api/routes/query.py - Graph service → Workflow orchestrator: invokes workflow
src/api/service.py - Workflow orchestrator → Question planner: plans question
src/orchestration/graph.py - Question planner → Metric contracts: uses contracts
src/planning/planner.py - Workflow orchestrator → Governed analytics: executes analytics
- Governed analytics → Deterministic calculations: calculates metrics
src/analytics/executor.py - Workflow orchestrator → Evidence retrieval: retrieves evidence
src/orchestration/graph.py - Evidence retrieval → Governed query: builds query
src/retrieval/retrieve.py - Evidence retrieval → Dense embeddings: embeds query
src/retrieval/retrieve.py - Evidence retrieval → Vector store: searches vectors
src/retrieval/retrieve.py - Evidence retrieval → Evidence contracts: returns evidence
src/retrieval/retrieve.py - Workflow orchestrator → Structured synthesis: requests draft
src/orchestration/graph.py - Workflow orchestrator → Independent verifier: checks claims
src/orchestration/graph.py - Workflow orchestrator → Workflow checkpoints: saves workflow state
src/orchestration/graph.py - Bounded agent runtime → Workflow orchestrator: uses workflow
src/bounded_agents/runtime.py - Workflow orchestrator → Plan contracts: uses plan contract
src/orchestration/graph.py - Graph service → Evidence retrieval: configures retrieval
src/api/service.py - Graph service → Evidence contracts: maps evidence
src/api/service.py