# 用户使用流程图 — 统计报表

```mermaid
flowchart TD
    %% ============ 颜色定义 ============
    classDef actor fill:#e1f5fe,stroke:#0288d1,stroke-width:2px
    classDef action fill:#fff3e0,stroke:#f57c00,stroke-width:1px
    classDef system fill:#e8f5e9,stroke:#388e3c,stroke-width:1px
    classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
    classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
    classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px,shape:box

    subgraph 统计报表
        A1(("管理员/家长")) --> A2[孩子数据概览 /child/overview]
        A2 --> A3[家庭汇总统计 /family/summary]
        A3 --> A4[积分排行榜 /points/ranking]
    end

    subgraph 任务统计
        A4 --> B1[仪表盘汇总 /dashboard]
        B1 --> B2[孩子完成率 /child-completion]
        B2 --> B3[家庭完成率 /family-completion]
        B3 --> B4[数据总览 /overview]
        B4 --> B5[收入统计 /revenue]
        B5 --> B6[会员分布 /membership]
        B6 --> B7[每日趋势 /trend]
    end

    subgraph 地址区域
        A1 --> C1[获取省份 /provinces]
        C1 --> C2[获取子级 /children/{parentId}]
        C2 --> C3[获取详情 /{id}]
        C3 --> C4[获取完整路径 /{id}/path]
        C4 --> C5[地址搜索 /search]
        C5 --> C6[区域回退匹配 /{id}/match]
        C6 --> C7[按区域统计 /stats]
    end

    subgraph 用户地址
        A1 --> D1[地址列表 /user/address/list]
        D1 --> D2[获取地址 /user/address/get]
        D2 --> D3[创建地址 /user/address/create]
        D3 --> D4[更新地址 /user/address/update]
        D4 --> D5[删除地址 /user/address/delete]
        D5 --> D6[设为默认 /user/address/setDefault]
    end

    R1(("👤 管理员/家长")):::actor
    R2(("📊 统计引擎")):::system

    A1 -:- R1
    B1 -:- R2
```

## 端点明细

| 端点 | 说明 |
|------|------|
| `/api/stats/child/overview` | 孩子数据概览 |
| `/api/stats/family/summary` | 家庭汇总 |
| `/api/stats/points/ranking` | 积分排行榜 |
| `/api/stats/dashboard` | 仪表盘汇总 |
| `/api/stats/child-completion` | 孩子完成率 |
| `/api/stats/family-completion` | 家庭完成率 |
| `/api/stats/overview` | 数据总览 |
| `/api/stats/revenue` | 收入统计 |
| `/api/stats/membership` | 会员分布 |
| `/api/stats/trend` | 每日趋势 |
| `/api/region/provinces` | 省份列表 |
| `/api/region/cities` | 城市列表 |
| `/api/region/districts` | 区县列表 |
| `/api/region/streets` | 街道列表 |
| `/api/streets/provinces` | 所有省份 |
| `/api/streets/children/{parentId}` | 子级地址 |
| `/api/streets/{id}` | 地址详情 |
| `/api/streets/{id}/path` | 地址路径 |
| `/api/streets/search` | 搜索地址 |
| `/api/streets/{id}/match` | 区域回退匹配 |
| `/api/streets/stats` | 区域统计 |
| `/api/user/address/list` | 地址列表 |
| `/api/user/address/create` | 创建地址 |
| `/api/user/address/update` | 更新地址 |
| `/api/user/address/delete` | 删除地址 |
| `/api/user/address/setDefault` | 设为默认 |