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