README.md

---
title: Dashsight
emoji: 🌍
colorFrom: red
colorTo: indigo
sdk: docker
pinned: false
---

# BiteSight Analytics API

Static-CSV-backed analytics service with:
- **12 deterministic KPI endpoints** under `/api/*` (dashboard data)
- **AI BizConsultant** `/chat` endpoint powered by MiniMax-M2.5 via AkashML + LangChain pandas agent

## Endpoints
- `GET /` — Service info
- `GET /health` — Health check
- `GET /api/meta` — Metadata (branches, products, date range)
- `GET /api/kpi/summary` — KPI summary with sparkline
- `GET /api/kpi/sales-by-day` — Sales by day of week
- `GET /api/kpi/heatmap` — Product × Day heatmap
- `GET /api/kpi/peak-hours` — Peak hours distribution
- `GET /api/kpi/payments` — Payment method breakdown
- `GET /api/kpi/branch-radar` — Branch comparison radar
- `GET /api/kpi/bubble-strategy` — Product strategy bubble chart
- `GET /api/kpi/city-treemap` — City revenue treemap
- `GET /api/kpi/spend-histogram` — Spend distribution histogram
- `GET /api/kpi/velocity-trend` — Revenue velocity trend
- `GET /api/kpi/insights` — Auto-generated insights
- `POST /chat` — AI BizConsultant (requires AKASHML_API_KEY secret)

## Secrets Required
Set `AKASHML_API_KEY` in Space Settings → Variables and secrets.