# 良渚电商前后端分离看板设计说明

## 视图维度

### 日视图
- 用于看单日经营状态。
- 趋势图只有一个点，重点看 KPI、店铺对比、商品 TOP、流量来源 TOP。

### 周视图
- 以用户选择日期所在自然周为范围：周一到周日。
- 趋势图显示每天成交和访客变化。
- 店铺、商品、流量数据按周汇总。

### 月视图
- 以用户选择日期所在自然月为范围。
- 趋势图显示整月每天变化。
- 适合月度复盘、结构分析和经营汇报。

## API Payload

`GET /api/dashboard?grain=week&date=2026-05-31`

返回结构：

```json
{
  "grain": "week",
  "period": {"start": "2026-05-25", "end": "2026-05-31", "label": "2026-05-25 至 2026-05-31"},
  "kpis": {},
  "charts": {"trend": []},
  "sections": {"stores": [], "products": [], "traffic": []}
}
```

## 后续可扩展

1. 增加店铺 / 平台筛选；
2. 增加同比、环比；
3. 接入用户权限或只读 token；
4. 部署到 `wwyl.yipeng.online` 现有 dashboard 路径；
5. 每日流程完成入库后自动刷新或重启 API。