77 lines
3.8 KiB
Markdown
77 lines
3.8 KiB
Markdown
# 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。
|
||
|
||
**需求描述**:
|
||
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)**: 完善租户公开页细节及最终文档更新。
|