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

```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:#616111,stroke-width:1px,shape:box

    subgraph 文章浏览
        A1(("用户")) --> A2[获取文章列表 /list]
        A2 --> A3[获取文章分类 /categories]
        A3 --> A4[获取文章详情 /detail]
        A4 --> A5[获取精选文章 /featured]
        A5 --> A6[记录阅读 /record-read]
        A6 --> A7[获取阅读统计 /reading-stats]
    end

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

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

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

    subgraph 媒体管理
        D6 --> E1[上传媒体文件 /media/upload]
        E1 --> E2[保存文字记录 /media/upload-text]
        E2 --> E3[获取任务媒体 /media/task/{taskId}]
        E3 --> E4[删除媒体 /media/{mediaId}]
        E4 --> E5[批量关联 /media/attach]
    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` | 批量关联 |