# 用户使用流程图 — 五维能量沙盘

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

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

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

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

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

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

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

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

    A1 -.- R1
    A2 -.- R2
```

## 端点明细

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