# 用户使用流程图 — 内容与媒体

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

```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[📱 获取文章列表 /list]:::portMiniApp
        A2 --> A3[📱 获取文章分类 /categories]:::portMiniApp
        A3 --> A4[📱 获取文章详情 /detail]:::portMiniApp
        A4 --> A5[📱 获取精选文章 /featured]:::portMiniApp
        A5 --> A6[📱 记录阅读 /record-read]:::portMiniApp
        A6 --> A7[📱 获取阅读统计 /reading-stats]:::portMiniApp
    end

    subgraph 每日贴士
        A7 --> B1[📱 获取每日贴士 /daily-tip]:::portMiniApp
        B1 --> B2[📱 获取AI问题列表 /ai-questions]:::portMiniApp
        B2 --> B3[📱 提交答案 /submit-answers]:::portMiniApp
    end

    subgraph 内容发布
        B3 --> C1[📱 发布文章 /publish]:::portMiniApp
        C1 --> C2[📱 获取我的帖子 /my-posts]:::portMiniApp
    end

    subgraph 内容分享
        C2 --> D1[📱 创建分享记录 /share/create]:::portMiniApp
        D1 --> D2[📱 记录点击 /share/click]:::portMiniApp
        D2 --> D3[📱 记录阅读 /share/read]:::portMiniApp
        D3 --> D4[📱 获取我的分享 /share/my]:::portMiniApp
        D4 --> D5[📱 获取分享统计 /share/stats]:::portMiniApp
        D5 --> D6[📱 获取家庭足迹 /share/family-footprint]:::portMiniApp
    end

    subgraph 媒体管理
        D6 --> E1[📱 上传媒体文件 /media/upload]:::portMiniApp
        E1 --> E2[📱 保存文字记录 /media/upload-text]:::portMiniApp
        E2 --> E3[📱 获取任务媒体 /media/task/:taskId]:::portMiniApp
        E3 --> E4[📱 删除媒体 /media/:mediaId]:::portMiniApp
        E4 --> E5[📱 批量关联 /media/attach]:::portMiniApp
    end

    R1(("👤 用户")):::actor
    R2(("📱 分享系统")):::system

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

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/articles/list` | 文章列表 | 📱小程序 |
| `/api/articles/categories` | 文章分类 | 📱小程序 |
| `/api/articles/detail` | 文章详情 | 📱小程序 |
| `/api/articles/featured` | 精选文章 | 📱小程序 |
| `/api/articles/record-read` | 记录阅读 | 📱小程序 |
| `/api/articles/reading-stats` | 阅读统计 | 📱小程序 |
| `/api/articles/daily-tip` | 每日贴士 | 📱小程序 |
| `/api/articles/ai-questions` | AI问题列表 | 📱小程序 |
| `/api/articles/submit-answers` | 提交答案 | 📱小程序 |
| `/api/articles/publish` | 发布文章 | 📱小程序 |
| `/api/articles/my-posts` | 我的帖子 | 📱小程序 |
| `/api/share/create` | 创建分享 | 📱小程序 |
| `/api/share/click` | 记录点击 | 📱小程序 |
| `/api/share/read` | 记录阅读 | 📱小程序 |
| `/api/share/my` | 我的分享 | 📱小程序 |
| `/api/share/stats` | 分享统计 | 📱小程序 |
| `/api/share/family-footprint` | 家庭足迹 | 📱小程序 |
| `/api/media/upload` | 上传媒体 | 📱小程序 |
| `/api/media/upload-text` | 保存文字 | 📱小程序 |
| `/api/media/task/{taskId}` | 任务媒体 | 📱小程序 |
| `/api/media/{mediaId}` | 删除媒体 | 📱小程序 |
| `/api/media/attach` | 批量关联 | 📱小程序 |