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:#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	批量关联	📱小程序