Files
quyun-v2/implementation-plan.md

3.8 KiB
Raw Blame History

QuyUn v2 Implementation Plan

根据当前项目状态 review以下是针对后续开发的实施计划涵盖清理废弃功能与补全缺失业务模块。

1. 功能清理 (Cleanup: WeChat Removal)

微信生态相关功能确认不再需要,需从代码库和文档中彻底移除,以降低维护成本和避免混淆。

1.1 API 接口 (Backend)

  • 移除 backend/app/http/v1/auth 下微信授权登录相关路由 (/auth/wechat, /auth/wechat/callback)。
  • 移除 WeChat JS-SDK 签名接口及相关 Service 逻辑。
  • 清理 go.mod 中可能存在的无用微信 SDK 依赖。

1.2 前端代码 (Frontend)

  • Portal: 修改 frontend/portal/src/views/auth/LoginView.vue,移除微信登录图标及相关 UI 占位。
  • Portal: 全局搜索并清理残留的 wx.configwx.ready 及微信分享相关代码。

1.3 文档与配置

  • 更新 specs/PRD.mdAPI.md,删除关于微信登录、分享及支付的所有规格说明。
  • 更新 backend/config.toml (及模板),移除 [wechat] 相关配置项 (AppID, Secret 等)。

2. 缺失功能需求 (Missing Features)

以下功能在后端 API 已有部分支持,但前端缺失页面,或业务逻辑需适配生产环境(特别是 S3

2.1 创作者中心 - 团队成员管理 (Creator Member Management)

优先级: High (P0)
现状: 后端已提供 CreateInvite, ReviewMember, CreateMemberInvite 等 API但前端 frontend/portal/src/views/creator/ 目录下完全缺失对应 UI。

需求描述:

  1. 成员列表页 (Member List)

    • 展示当前租户下的所有成员。
    • 显示成员基本信息头像、昵称、加入时间及角色Owner/Admin/Member
    • 提供移除成员的操作入口(仅 Admin/Owner 可见)。
  2. 邀请功能 (Invite System)

    • 生成邀请: 提供表单生成邀请链接或邀请码(设置有效期、最大使用次数)。
    • 邀请记录: 展示当前有效的邀请列表,支持“撤销/禁用”邀请。
  3. 审核功能 (Join Requests)

    • 待审核列表: 展示用户主动发起的加入申请 (Reason, User Info)。
    • 审批操作: 提供“通过”和“拒绝”按钮,调用后端 ReviewMember 接口。

2.2 媒体处理管线适配 (Media Pipeline for S3)

优先级: High (P1)
现状: backend/app/jobs/media_process_job.go 目前逻辑强依赖本地文件系统 (Local Storage),无法处理 S3 上的文件。

需求描述:

  1. 处理流程重构:
    • 兼容 S3 存储模式Worker 需先将源文件从 S3 下载到本地临时目录。
    • 执行 FFmpeg 处理(视频转码、截取封面、音频波形提取)。
    • 将处理后的产物(封面图、预览片段)上传回 S3。
    • 清理本地临时文件。
  2. 封面图自动生成:
    • 视频上传完成后,必须自动截取第一帧或指定帧作为封面 (cover),避免前端展示空白。

2.3 租户公开页完善 (Tenant Public Page)

优先级: Medium (P2)
现状: frontend/portal/src/views/tenant/ 目前仅有基础 HomeView

需求描述:

  1. 关于/简介页:
    • 增加展示租户详细介绍 (Description, Bio) 的区域或模态框。
  2. 内容聚合优化:
    • 确认 HomeView 支持按“专辑/Topic”或“最新/最热”维度筛选展示内容。

3. 执行路线图 (Roadmap)

  1. Phase 1 (Cleanup): 优先执行 [1. 功能清理],确保代码库整洁,去除干扰项。
  2. Phase 2 (Frontend): 开发 Creator Portal 的 [2.1 团队成员管理] 模块,补全多租户协作能力。
  3. Phase 3 (Backend): 配合 S3 调试进度,重构 [2.2 媒体处理管线],确保线上媒体资源可用。
  4. Phase 4 (Polish): 完善租户公开页细节及最终文档更新。