cfc/docs/flows/energy-system-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[获取能量沙盘 /sandbox]
        A2 --> A3[获取五维概览 /overview]
        A3 --> A4[获取家庭五维聚合 /family-score-history]
        A4 --> A5[获取五维分数历史 /score-history]
    end

    subgraph 能量流水
        A5 --> B1[查询能量流水 /logs]
        B1 --> B2[获取富维度详情 /wealth-detail]
    end

    subgraph 能量操作
        A3 --> C1[发放能量 /grant]
        C1 --> C2[心愿兑换扣除 /deduct-for-wish]
        C2 --> C3[配置来源比例 /configure]
    end

    subgraph 维度管理
        C3 --> D1[获取维度概览 /overview]
        D1 --> D2[手动录入维度 /upload]
        D2 --> D3[问卷提交维度 /questionnaire]
        D3 --> D4[获取维度历史 /history]
    end

    subgraph 年度能量
        D4 --> E1[获取年度五维能量 /energy]
    end

    subgraph 家庭收入
        C3 --> F1[获取家庭收入汇总 /family/summary]
        F1 --> F2[获取成员收入 /family/members]
        F2 --> F3[获取收入记录 /family/records]
    end

    R1(("👤 家长/孩子")):::actor
    R2(("🌍 五维引擎")):::system

    A1 -.- R1
    A2 -.- R2

端点明细

端点	控制器	说明
/api/energy/sandbox	EnergyController	获取能量沙盘
/api/energy/overview	EnergyController	获取五维概览
/api/energy/logs	EnergyController	查询能量流水
/api/energy/grant	EnergyController	发放能量
/api/energy/deduct-for-wish	EnergyController	心愿扣除能量
/api/energy/configure	EnergyController	配置来源比例
/api/energy/score-history	EnergyController	五维分数历史
/api/energy/family-score-history	EnergyController	家庭五维聚合
/api/energy/wealth-detail	EnergyController	富维度详情
/api/energy/seed	SeedEnergyController	生成种子数据
/api/zodiac/energy	ZodiacEnergyController	年度五维能量
/api/dimension/overview	HealthDimensionController	维度概览
/api/dimension/upload	HealthDimensionController	手动录入维度
/api/dimension/questionnaire	HealthDimensionController	问卷提交
/api/dimension/history	HealthDimensionController	维度历史
/api/earnings/family/summary	FamilyEarningsController	家庭收入汇总
/api/earnings/family/members	FamilyEarningsController	成员收入
/api/earnings/family/records	FamilyEarningsController	收入记录