3.8 KiB
3.8 KiB
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.config、wx.ready及微信分享相关代码。
1.3 文档与配置
- 更新
specs/PRD.md和API.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。
需求描述:
-
成员列表页 (Member List)
- 展示当前租户下的所有成员。
- 显示成员基本信息(头像、昵称、加入时间)及角色(Owner/Admin/Member)。
- 提供移除成员的操作入口(仅 Admin/Owner 可见)。
-
邀请功能 (Invite System)
- 生成邀请: 提供表单生成邀请链接或邀请码(设置有效期、最大使用次数)。
- 邀请记录: 展示当前有效的邀请列表,支持“撤销/禁用”邀请。
-
审核功能 (Join Requests)
- 待审核列表: 展示用户主动发起的加入申请 (Reason, User Info)。
- 审批操作: 提供“通过”和“拒绝”按钮,调用后端
ReviewMember接口。
2.2 媒体处理管线适配 (Media Pipeline for S3)
优先级: High (P1)
现状: backend/app/jobs/media_process_job.go 目前逻辑强依赖本地文件系统 (Local Storage),无法处理 S3 上的文件。
需求描述:
- 处理流程重构:
- 兼容 S3 存储模式:Worker 需先将源文件从 S3 下载到本地临时目录。
- 执行 FFmpeg 处理(视频转码、截取封面、音频波形提取)。
- 将处理后的产物(封面图、预览片段)上传回 S3。
- 清理本地临时文件。
- 封面图自动生成:
- 视频上传完成后,必须自动截取第一帧或指定帧作为封面 (
cover),避免前端展示空白。
- 视频上传完成后,必须自动截取第一帧或指定帧作为封面 (
2.3 租户公开页完善 (Tenant Public Page)
优先级: Medium (P2)
现状: frontend/portal/src/views/tenant/ 目前仅有基础 HomeView。
需求描述:
- 关于/简介页:
- 增加展示租户详细介绍 (
Description,Bio) 的区域或模态框。
- 增加展示租户详细介绍 (
- 内容聚合优化:
- 确认
HomeView支持按“专辑/Topic”或“最新/最热”维度筛选展示内容。
- 确认
3. 执行路线图 (Roadmap)
- Phase 1 (Cleanup): 优先执行 [1. 功能清理],确保代码库整洁,去除干扰项。
- Phase 2 (Frontend): 开发 Creator Portal 的 [2.1 团队成员管理] 模块,补全多租户协作能力。
- Phase 3 (Backend): 配合 S3 调试进度,重构 [2.2 媒体处理管线],确保线上媒体资源可用。
- Phase 4 (Polish): 完善租户公开页细节及最终文档更新。