cfc/docs/flows/content-media-flow.md

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

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	批量关联