# SaaS 后续专项整治清单（2026-06-18）

> 本清单基于《SaaS 全面质量审计报告（2026-06-18）》整理。
> 原则：**业务推进与专项治理分开，不混做。**

---

## 一、专项划分

### 专项 A：CI/CD 稳定性修复
**目标**：让质量门禁重新成为稳定、可信的交付门禁。  
**当前问题**：`e5d5ae4` 对应 `ci-cd.yml #239` 失败于 `Code Quality Check`。  
**边界**：单独规划、单独执行，不并入 Phase 7 业务收尾提交。

**待办**：
- [ ] 核查 `requirements-dev.txt` 与 CI 质量工具链的可执行性
- [ ] 核查 `.gitea/workflows/ci-cd.yml` 与 `.github/workflows/ci-cd.yml` 的一致性
- [ ] 验证 `black/isort/flake8/mypy/bandit` 在 CI 容器内的真实安装结果
- [ ] 形成 CI/CD 修复方案文档
- [ ] 在独立分支修复并验证

---

### 专项 B：全仓主线路径澄清
**目标**：消除“旧文档 / 旧测试 / 当前主线”并存带来的认知混乱。  
**当前问题**：router、测试、历史实现之间存在代际不一致。

**待办**：
- [ ] 列出当前真实 API 主线清单
- [ ] 标记旧接口 / 旧测试 / 兼容层的状态（保留 / 废弃 / 待迁移）
- [ ] 统一 README / 索引 / 设计文档中的主线表述
- [ ] 对历史测试做分类：现主线 / 旧主线 / 待重写

---

### 专项 C：文档入口质量修复
**目标**：让项目文档真正成为可信入口。  
**当前问题**：README 存在乱码或内容质量不可靠问题。

**待办**：
- [ ] 修复 `README.md` 编码/内容质量问题
- [ ] 核对 `saas-index.md` 与当前仓库主线一致性
- [ ] 增补“当前真实主线”说明文档

---

### 专项 D：生成链生产化深化
**目标**：把当前最小闭环生成链推进到更真实生产能力。  
**当前问题**：worker 仍偏 skeleton。

**待办**：
- [ ] 明确真实生成策略输入输出
- [ ] 设计 FFmpeg / 渲染 / 媒体处理链路
- [ ] 增加失败恢复、日志、重试策略
- [ ] 增加更真实的集成验证

---

### 专项 E：前端真实联调验收深化
**目标**：从“可构建”提升到“完整用户路径稳定可用”。

**待办**：
- [ ] 验证生成页到结果页的真实 API 联调
- [ ] 验证下载链真实行为
- [ ] 增补关键前端交互测试
- [ ] 识别并修复非主链页面的历史类型/状态问题

---

## 二、优先级排序

### P0
- [ ] 专项 A：CI/CD 稳定性修复

### P1
- [ ] 专项 B：全仓主线路径澄清
- [ ] 专项 C：文档入口质量修复

### P2
- [ ] 专项 D：生成链生产化深化
- [ ] 专项 E：前端真实联调验收深化

---

## 三、执行原则

- 不把业务推进和 CI/CD 专项修复混在一轮提交里
- 每个专项必须先有目标、范围、验收标准
- 每次专项结束后必须更新 `PHASE7-PROGRESS.md` 或对应治理文档
- 任何规则变化都必须先落文档，再落代码

---

**维护人**：小虾 🦐
