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
    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	设为默认	📱小程序