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

> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动

```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
    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2

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

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

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

    subgraph 用户地址
        A1 --> D1[📱 地址列表 /user/address/list]:::portMiniApp
        D1 --> D2[📱 获取地址 /user/address/get]:::portMiniApp
        D2 --> D3[📱 创建地址 /user/address/create]:::portMiniApp
        D3 --> D4[📱 更新地址 /user/address/update]:::portMiniApp
        D4 --> D5[📱 删除地址 /user/address/delete]:::portMiniApp
        D5 --> D6[📱 设为默认 /user/address/setDefault]:::portMiniApp
    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` | 设为默认 | 📱小程序 |