# 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)**: 完善租户公开页细节及最终文档更新。