# 良渚电商数据看板（前后端分离）

目标：把原来每日流程里生成的单文件静态 HTML，升级为可复用的前后端分离看板：

- 后端提供 API，从固定的 `liangzhu_qianniu` PostgreSQL 数据库读取数据；
- 前端通过接口按日 / 周 / 月维度查询；
- 支持日期选择器、指标卡、趋势图、店铺对比、商品排行、流量来源排行；
- 不写入业务数据库，只读查询；
- 不保存 Cookie、Token、数据库密码等敏感信息。

## 目录

```text
app/        FastAPI 后端
static/     前端页面、CSS、JS
tests/      API 与前端结构测试
docs/       设计说明
scripts/    本地启动脚本
```

## 本地运行

```bash
cd /Users/bot1/Volumes/root_for_ai/AI工作区/良渚_电商数据看板_前后端分离_20260602_0257
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --host 127.0.0.1 --port 8765
```

打开：

```text
http://127.0.0.1:8765/
```

## API

```text
GET /api/health
GET /api/meta
GET /api/dashboard?grain=day&date=2026-05-31
GET /api/dashboard?grain=week&date=2026-05-31
GET /api/dashboard?grain=month&date=2026-05-31
```

## 数据源

默认通过 SSH 调用云端 psql：

```text
ssh wwyl-cloud sudo -u postgres psql -d liangzhu_qianniu
```

也支持未来部署在云端时切换为本地 `psql` 或 `DATABASE_URL` 直连模式。