cfc/docs/flows/stats-report-flow.md

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

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	设为默认