# 用户使用流程图 — 心理与情绪管理

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

```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[📱 创建情绪打卡 /mind/checkin/create]:::portMiniApp
        A2 --> A3[📱 获取情绪列表 /mind/checkin/list]:::portMiniApp
        A3 --> A4[📱 获取最新情绪 /mind/checkin/latest]:::portMiniApp
        A4 --> A5[📱 获取情绪趋势 /mind/checkin/trend]:::portMiniApp
        A5 --> A6[📱 获取情绪统计 /mind/checkin/stats]:::portMiniApp
        A6 --> A7[📱 获取周报 /mind/checkin/weekly-report]:::portMiniApp
    end

    subgraph 情绪预警
        A7 --> B1[📱 获取活跃预警 /mind/alert/active]:::portMiniApp
        B1 --> B2[📱 获取打卡预警 /mind/alert/checkin-alerts]:::portMiniApp
        B2 --> B3[📱 处理预警 /mind/alert/resolve]:::portMiniApp
    end

    subgraph 心理测评
        A1 --> C1[📱 提交筛查问卷 /mind/screening/submit]:::portMiniApp
        C1 --> C2[📱 获取筛查历史 /mind/screening/history]:::portMiniApp
        C2 --> C3[📱 获取最新结果 /mind/screening/latest]:::portMiniApp
    end

    subgraph 脑科学与神经递质
        C3 --> D1[📱 获取神经递质分析 /mind/neurotransmitters]:::portMiniApp
        D1 --> D2[📱 获取肠脑洞察 /mind/gut-emotion-insight]:::portMiniApp
        D2 --> D3[📱 获取EMI报告 /mind/emireport/latest]:::portMiniApp
    end

    subgraph 心理运势
        D3 --> E1[📱 获取心理运势 /mind/fortune]:::portMiniApp
        E1 --> E2[📱 刷新运势 /mind/fortune/refresh]:::portMiniApp
        E2 --> E3[📱 导出运势 /mind/fortune/export]:::portMiniApp
    end

    subgraph 传统心理镜像
        E3 --> F1[📱 获取心理镜像 /mind/traditional/mirror]:::portMiniApp
        F1 --> F2[📱 获取家庭看板 /mind/traditional/family-dashboard]:::portMiniApp
        F2 --> F3[📱 获取兼容性 /mind/traditional/compatibility]:::portMiniApp
    end

    subgraph EMI心理报告
        F3 --> G1[📱 获取EMI心理报告 /emireport/latest]:::portMiniApp
    end

    R1(("👤 用户")):::actor
    R2(("🧠 心理引擎")):::system

    A1 -.- R1
    D1 -.- R2
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/mind/checkin/create` | 创建情绪打卡 | 📱小程序 |
| `/api/mind/checkin/list` | 情绪列表 | 📱小程序 |
| `/api/mind/checkin/latest` | 最新情绪 | 📱小程序 |
| `/api/mind/checkin/trend` | 情绪趋势 | 📱小程序 |
| `/api/mind/checkin/stats` | 情绪统计 | 📱小程序 |
| `/api/mind/checkin/weekly-report` | 周报 | 📱小程序 |
| `/api/mind/alert/active` | 活跃预警 | 📱小程序 |
| `/api/mind/alert/checkin-alerts` | 打卡预警 | 📱小程序 |
| `/api/mind/alert/resolve` | 处理预警 | 📱小程序 |
| `/api/mind/neurotransmitters` | 神经递质 | 📱小程序 |
| `/api/mind/gut-emotion-insight` | 肠脑洞察 | 📱小程序 |
| `/api/mind/emireport/latest` | EMI报告 | 📱小程序 |
| `/api/mind/fortune` | 心理运势 | 📱小程序 |
| `/api/mind/fortune/refresh` | 刷新运势 | 📱小程序 |
| `/api/mind/fortune/export` | 导出运势 | 📱小程序 |
| `/api/mind/screening/submit` | 提交筛查 | 📱小程序 |
| `/api/mind/screening/history` | 筛查历史 | 📱小程序 |
| `/api/mind/screening/latest` | 最新结果 | 📱小程序 |
| `/api/mind/traditional/mirror` | 心理镜像 | 📱小程序 |
| `/api/mind/traditional/family-dashboard` | 家庭看板 | 📱小程序 |
| `/api/mind/traditional/compatibility` | 兼容性 | 📱小程序 |
| `/api/emireport/latest` | EMI心理报告 | 📱小程序 |