95 lines
2.9 KiB
Markdown
95 lines
2.9 KiB
Markdown
# 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` 或对应治理文档
|
||
- 任何规则变化都必须先落文档，再落代码
|
||
|
||
---
|
||
|
||
**维护人**：小虾 🦐
|