How karan8989-ux/neemans-ai works
Neeman’s AI Business Intelligence is a React dashboard backed by FastAPI and pandas analytics. Users view business KPIs and AI highlights, generate a daily briefing, explore customer feedback, ask the analytics-grounded Copilot questions, or upload and reset CSV datasets. Uploaded CSVs are mapped and validated before replacing in-memory data; analytics then supplies dashboard and AI features. The README identifies backend/ as active and the nested backend as an older duplicate, so the duplicate is omitted. Some frontend-to-API links are documented rather than visible in sampled page code.
Main entry points: main.py FastAPI app · analytics.py Pandas analytics · App.tsx Page router · api.ts API client
Components 22
Dashboard
- Page router
frontend/src/App.tsx - Business overview
frontend/src/pages/OverviewPage.tsx - Daily briefing
frontend/src/pages/BriefingPage.tsx - Feedback explorer
frontend/src/pages/FeedbackPage.tsx - Data sources
frontend/src/pages/DataSourcesPage.tsx - Copilot chat
frontend/src/components/copilot/AIBusinessCopilot.tsx - API client
frontend/src/services/api.ts
API routes
- FastAPI app
backend/main.py - Overview routes
backend/routers/overview.py - Briefing routes
backend/routers/briefing.py - Feedback routes
backend/routers/feedback.py - Upload routes
backend/routers/upload.py - Copilot routes
backend/routers/copilot.py
Data and analytics
- CSV mapping
backend/services/schema_mapper.py - Dataset store
backend/services/data_store.py - Pandas analytics
backend/services/analytics.py
AI insights
- Overview insights
backend/agents/overview_agent.py - Briefing generator
backend/agents/briefing_agent.py - Feedback recommendations
backend/agents/feedback_agent.py - Copilot agent
backend/agents/copilot_agent.py
Other components
- Business user
- Anthropic Claude
Connections 37
- Business user → Page router: uses
README.md - Page router → Business overview: routes to
frontend/src/App.tsx - Page router → Daily briefing: routes to
frontend/src/App.tsx - Page router → Feedback explorer: routes to
frontend/src/App.tsx - Page router → Data sources: routes to
frontend/src/App.tsx - Page router → Copilot chat: renders
frontend/src/App.tsx - Business overview → API client: requests data
- Daily briefing → API client: requests data
- Feedback explorer → API client: requests data
- Data sources → API client: uploads CSVs
- Copilot chat → API client: asks questions
- API client → FastAPI app: calls API
README.md - FastAPI app → Overview routes: registers
backend/main.py - FastAPI app → Briefing routes: registers
backend/main.py - FastAPI app → Feedback routes: registers
backend/main.py - FastAPI app → Upload routes: registers
backend/main.py - FastAPI app → Copilot routes: registers
backend/main.py - FastAPI app → Dataset store: loads demo data
backend/main.py - Upload routes → CSV mapping: validates CSV
backend/routers/upload.py - Upload routes → Dataset store: replaces dataset
backend/routers/upload.py - CSV mapping → Anthropic Claude: maps ambiguous columns
- Overview routes → Pandas analytics: reads aggregates
backend/routers/overview.py - Briefing routes → Pandas analytics: reads aggregates
backend/routers/briefing.py - Feedback routes → Pandas analytics: reads feedback
backend/routers/feedback.py - Copilot routes → Copilot agent: dispatches chat
backend/routers/copilot.py - Pandas analytics → Dataset store: reads datasets
backend/services/analytics.py - Overview routes → Overview insights: requests highlights
README.md - Briefing routes → Briefing generator: generates briefing
backend/routers/briefing.py - Feedback routes → Feedback recommendations: requests recommendations
backend/routers/feedback.py - Overview insights → Pandas analytics: uses aggregates
backend/agents/overview_agent.py - Briefing generator → Pandas analytics: uses aggregates
backend/agents/briefing_agent.py - Feedback recommendations → Pandas analytics: uses aggregates
backend/agents/feedback_agent.py - Copilot agent → Pandas analytics: gathers context
backend/agents/copilot_agent.py - Overview insights → Anthropic Claude: generates insights
- Briefing generator → Anthropic Claude: generates briefing
- Feedback recommendations → Anthropic Claude: generates recommendations
backend/agents/feedback_agent.py - Copilot agent → Anthropic Claude: generates answer
backend/agents/copilot_agent.py