How aidul23/mas-prompt-analytics works
The product is an interactive chatbot-trace analytics application: users import trace exports, explore predefined dashboard metrics, or ask questions answered by a multi-agent SLM workflow (with a single-model baseline and comparison mode). The map preserves data ingestion, analytics, chat, model management, saved conversations, and evaluation as distinct capabilities. Edges reflect documented wiring and indexed imports; unsampled implementation details are represented at supported directory paths, and evaluation internals are not inferred.
Main entry points: orchestrator.py Multi-agent orchestrator · App.tsx App and routes · main.py FastAPI app · routes_chat.py Chat routes
Components 28
Web interface
- App and routes
frontend/src/App.tsx - Dashboard UI
frontend/src/pages/Dashboard.tsx - Chat UI
frontend/src/pages/Chat.tsx - Data sources UI
frontend/src/pages/DataSources.tsx - Models UI
frontend/src/pages/Models.tsx - API client
frontend/src/api.ts
API services
- FastAPI app
backend/app/api/main.py - Chat routes
backend/app/api/routes_chat.py - Dashboard routes
backend/app/api/routes_dashboard.py - Data routes
backend/app/api/routes_data.py - Model routes
backend/app/api/routes_models.py
Trace data
- Import and sync
backend/app/data/sources.py - Feature pipeline
backend/app/data/pipeline.py - Analytics context
backend/app/data/context.py - Analytics database
backend/app/data/store.py - Dashboard metrics
backend/app/metrics/dashboard.py
Question answering
- Multi-agent orchestrator
backend/app/mas/orchestrator.py - Query understanding
backend/app/mas/agents/query_understanding.py - Other agent stages
backend/app/mas/agents - Single-model baseline
backend/app/baseline/single_model.py - Saved chats
backend/app/chats.py - Conversation traces
backend/app/traces.py
Models and evaluation
- Ollama client
backend/app/llm.py - Model profiles
backend/app/config.py - Model downloads
backend/app/model_pulls.py - Evaluation harness
backend/eval/run_eval.py
Other components
- User
- Ollama service
Connections 36
- User → App and routes: uses
frontend/src/App.tsx - App and routes → Dashboard UI: routes to
frontend/src/App.tsx - App and routes → Chat UI: routes to
frontend/src/App.tsx - App and routes → Data sources UI: routes to
frontend/src/App.tsx - App and routes → Models UI: routes to
frontend/src/App.tsx - Dashboard UI → API client: requests data
frontend/src/pages/Dashboard.tsx - Chat UI → API client: sends questions
frontend/src/pages/Chat.tsx - Data sources UI → API client: manages sources
frontend/src/pages/DataSources.tsx - Models UI → API client: manages models
- API client → FastAPI app: HTTP requests
README.md - FastAPI app → Chat routes: registers
backend/app/api/main.py - FastAPI app → Dashboard routes: registers
backend/app/api/main.py - FastAPI app → Data routes: registers
backend/app/api/main.py - FastAPI app → Model routes: registers
backend/app/api/main.py - Chat routes → Multi-agent orchestrator: dispatches MAS
backend/app/api/routes_chat.py - Chat routes → Single-model baseline: dispatches baseline
backend/app/api/routes_chat.py - Chat routes → Saved chats: loads and saves
backend/app/api/routes_chat.py - Chat routes → Conversation traces: seeds and clears
backend/app/api/routes_chat.py - Data routes → Import and sync: manages sources
backend/app/api/routes_data.py - Import and sync → Feature pipeline: runs rebuilds
backend/app/data/sources.py - Feature pipeline → Analytics database: writes tables
backend/app/data/pipeline.py - Feature pipeline → Import and sync: loads files
backend/app/data/sources.py - Dashboard routes → Dashboard metrics: serves metrics
backend/app/api/routes_dashboard.py - Dashboard metrics → Analytics database: queries
backend/app/metrics/dashboard.py - Multi-agent orchestrator → Other agent stages: runs stages
backend/app/mas/orchestrator.py - Multi-agent orchestrator → Query understanding: repairs query
backend/app/mas/orchestrator.py - Query understanding → Analytics context: grounds questions
backend/app/mas/agents/query_understanding.py - Analytics context → Analytics database: reads values
backend/app/data/context.py - Multi-agent orchestrator → Conversation traces: records turns
backend/app/mas/orchestrator.py - Multi-agent orchestrator → Model profiles: selects profile
backend/app/mas/orchestrator.py - Model routes → Ollama client: queries models
backend/app/api/routes_models.py - Model routes → Model downloads: manages downloads
backend/app/api/routes_models.py - Ollama client → Ollama service: calls API
backend/app/llm.py - Single-model baseline → Ollama client: requests completions
backend/app/baseline/single_model.py - Evaluation harness → Multi-agent orchestrator: evaluates answers
backend/eval/run_eval.py - Evaluation harness → Single-model baseline: evaluates baseline
backend/eval/run_eval.py