# 用户使用流程图 — 管家与商家入驻

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

```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[📱 申请管家 /apply]:::portMiniApp
        A2 --> A3[📱 获取管家资料 /profile]:::portMiniApp
        A3 --> A4[📱 更新资料 /update-profile]:::portMiniApp
        A4 --> A5[📱 获取家庭成员 /members]:::portMiniApp
        A5 --> A6[📱 服务记录 /service-records]:::portMiniApp
        A6 --> A7[📱 佣金查询 /commissions]:::portMiniApp
    end

    subgraph 商家入驻
        A1 --> B1[📱 申请入驻 /vendor/apply]:::portMiniApp
        B1 --> B2[📱 获取入驻状态 /vendor/status]:::portMiniApp
        B2 --> B3[📱 获取商家信息 /vendor/info]:::portMiniApp
    end

    subgraph 商家管理
        B3 --> C1[🖥 商家商品列表]:::portAdmin
        C1 --> C2[🖥 处理订单]:::portAdmin
        C2 --> C3[🖥 发货管理]:::portAdmin
    end

    R1(("👤 用户")):::actor
    R2(("🏪 商家")):::role

    A1 -.- R1
    B3 -.- R2
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/butler/apply` | 申请管家 | 📱小程序 |
| `/api/butler/profile` | 管家资料 | 📱小程序 |
| `/api/butler/update-profile` | 更新资料 | 📱小程序 |
| `/api/butler/members` | 家庭成员 | 📱小程序 |
| `/api/butler/service-records` | 服务记录 | 📱小程序 |
| `/api/butler/commissions` | 佣金查询 | 📱小程序 |
| `/api/vendor/apply` | 申请入驻 | 📱小程序 |
| `/api/vendor/status` | 入驻状态 | 📱小程序 |
| `/api/vendor/info` | 商家信息 | 📱小程序 |