feat(phase3): 下线/edit-plans/*旧路由 + 清理废弃代码 + 数据库冗余字段清理 #657

Merged

auto-approve-bot merged 6 commits from feat/phase3-backend-cleanup into develop 2026-07-20 23:48:36 +08:00

Conversation 6 Commits 6 Files Changed 32

+505 -9252

xiaoxia commented 2026-07-20 21:23:15 +08:00

Owner

Copy Link

Copy Source

Phase 3 后端清理

路由层（已删除）

• 删除 11 个旧路由文件（edit_plans*.py），共 ~4000 行
• 从 router.py 移除 /edit-plans 路径注册
• 删除 _helpers.py 中 deprecated_edit_plans_api

Service 层（已清理）

• 删除 EditPlanService 中 6 个字幕方法（模板编辑器直接操作 clip.config.subtitles）
• 保留核心 CRUD / clips / 状态机 / 生成流程方法（模板编辑器仍在使用）
• 保留 create_plan 基础方法（测试与脚本使用）

测试

• 删除 7 个旧路由 API 测试文件（~4000 行）
• 删除 TestSubtitleManagement 测试类（16 个用例）
• templates_editor API: 37/37 ✅
• EditPlanService: 55/55 ✅

数据库

• EditPlan 表为模板草稿存储基础，所有字段均在使用中，暂不做字段删除
• result_count / source_edit_plan_id 虽为剪辑计划概念遗留，但 worker 与 API 仍在读写，保持兼容

统计

• 22 files changed, +459 / -9234 行
• 净减少约 8775 行 代码

## Phase 3 后端清理 ### 路由层（已删除） - 删除 11 个旧路由文件（edit_plans*.py），共 ~4000 行 - 从 router.py 移除 /edit-plans 路径注册 - 删除 _helpers.py 中 deprecated_edit_plans_api ### Service 层（已清理） - 删除 EditPlanService 中 6 个字幕方法（模板编辑器直接操作 clip.config.subtitles） - 保留核心 CRUD / clips / 状态机 / 生成流程方法（模板编辑器仍在使用） - 保留 create_plan 基础方法（测试与脚本使用） ### 测试 - 删除 7 个旧路由 API 测试文件（~4000 行） - 删除 TestSubtitleManagement 测试类（16 个用例） - templates_editor API: 37/37 ✅ - EditPlanService: 55/55 ✅ ### 数据库 - EditPlan 表为模板草稿存储基础，所有字段均在使用中，暂不做字段删除 - result_count / source_edit_plan_id 虽为剪辑计划概念遗留，但 worker 与 API 仍在读写，保持兼容 ### 统计 - 22 files changed, +459 / -9234 行 - 净减少约 **8775 行** 代码

gitea-actions bot commented 2026-07-20 21:24:59 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#657
预览链接	https://pr-657.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #657 | | 预览链接 | [https://pr-657.preview.xiaoxiajianji.com](https://pr-657.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia changed title from feat(phase3): 下线/edit-plans/*旧路由 + 清理废弃代码 to feat(phase3): 下线/edit-plans/*旧路由 + 清理废弃代码 + 数据库冗余字段清理 2026-07-20 21:37:32 +08:00

auto-approve-bot approved these changes 2026-07-20 22:16:23 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-07-20 22:16:24 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot commented 2026-07-20 22:31:11 +08:00

Collaborator

Copy Link

Copy Source

Auto merge skipped after multiple 405 errors: PR may have conflicts or unresolved checks. Please review manually. This is not a CI failure.

Auto merge skipped after multiple 405 errors: PR may have conflicts or unresolved checks. Please review manually. This is not a CI failure.

xiaoxia added 6 commits 2026-07-20 23:42:59 +08:00

feat(phase3): 删除旧 /edit-plans/* 路由及废弃代码 ... 9438af6704

- 删除11个旧路由文件（edit_plans*.py）
- 删除7个对应API测试文件
- 从router移除 /edit-plans 路径注册
- Pydantic schemas 已迁移到 templates_editor.py
- 移除 deprecated_edit_plans_api helper
- 保留 EditPlanService 服务层及数据模型（模板编辑器仍在使用）

feat(phase3): 清理EditPlanService废弃字幕方法及测试 ... 022187cb9e

- 删除EditPlanService中6个字幕相关方法（list/get/add/update/delete/batch_update）
  模板编辑器直接操作clip.config.subtitles，不再走service层
- 删除对应TestSubtitleManagement测试类（16个用例）
- 修复test_get_plan_or_raise_not_found遗留bug（引用未定义变量）
- net: -775行

fix(phase3): black + isort 格式修复 dadbab5b3c

feat(phase3): 清理EditPlan表冗余字段result_count ... d5d8f4bfdb

- 删除EditPlan领域模型/仓储/DB模型中的result_count字段
- 清理worker中对plan.result_count的写入
- 创建048 migration删除edit_plans.result_count列
- 该字段为剪辑计划独立功能遗留，生成结果数由generation_tasks承载
- net: -6行 + 1 migration

fix(phase2): 修复模板发布时旧片段配置未删除的Bug ... a5febd54fe

- 根因: publish_template_from_draft 中删除走 db.query().delete() 绕过了 repository 层
- 修复: delete_by_template 增加 commit 参数，publish 中走 repository 调用
- 修复后 stub 测试能正确验证删除逻辑，52个 edit_template_service 测试全绿

fix(phase3): 缩短alembic revision ID，避免超过varchar(32)限制 ... 018e40c73e

alembic_version表version_num字段是varchar(32)，原revision名
'048_cleanup_editplan_redundant_fields' 有38字符，导致更新失败。
改短为 '048_cleanup_result_count' (24字符)。

xiaoxia force-pushed feat/phase3-backend-cleanup from 1c8dcbd98e to 018e40c73e 2026-07-20 23:42:59 +08:00 Compare

auto-approve-bot commented 2026-07-20 23:45:27 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR: #657

⚠️ 问题（2个需要修改）

1. packages/adapters/sqlalchemy_impl/models.py (未在diff中显示，但在修改列表中)：ORM模型字段未同步移除风险。

   • 问题描述：Migration脚本 048_cleanup_result_count.py 删除了数据库表 edit_plans 中的 result_count 字段。如果对应的 SQLAlchemy ORM 模型（通常位于 models.py 中的 EditPlan 类）没有同步移除该字段定义，应用启动时 SQLAlchemy 会抛出 sqlalchemy.exc.InvalidRequestError，因为无法在表中找到该列的映射。
   • 修改建议：请确认 packages/adapters/sqlalchemy_impl/models.py 中的 EditPlan 模型已删除 result_count 属性。

2. apps/api/app/api/routes/templates_editor.py (未在diff中显示，但在修改列表中)：子路由注册缺失风险。

   • 问题描述：被删除的 edit_plans.py 文件中包含了对子路由的引用和注册（如 adjustments_router, export_router, filter_router 等）。根据注释“所有剪辑计划 API 迁移到 /templates/{id}/editor/*”，这些子路由应当被迁移并重新注册到 templates_editor.py 中。如果遗漏，将导致相关功能不可用。
   • 修改建议：请检查 templates_editor.py 是否正确 include_router 了上述所有子路由，并确保路径前缀符合新的 API 规范。

💡 建议（1个可选）

1. alembic/versions/048_cleanup_result_count.py 第34行：Downgrade 脚本的数据丢失提示。
   • 问题描述：downgrade 函数中使用 op.add_column 恢复字段时指定了 server_default="0"。由于 upgrade 中使用了 op.drop_column，原有的 result_count 数据在数据库中已永久丢失。回滚操作虽然能恢复表结构，但无法恢复原有数据，所有记录的该字段值都将变为 0。
   • 修改建议：虽然对于清理类 Migration 这通常是可以接受的，但建议在代码注释中明确标注此回滚操作会导致数据丢失，提醒运维人员谨慎操作。

---

✅ 格式检查通过 | ❌ 逻辑审查需修改 | ✅ 性能无明显问题

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-07-20 23:45:27 | 模型:}

## 代码审查结果 - PR: #657 ### ⚠️ 问题（2个需要修改） 1. **packages/adapters/sqlalchemy_impl/models.py (未在diff中显示，但在修改列表中)**：ORM模型字段未同步移除风险。 - 问题描述：Migration脚本 `048_cleanup_result_count.py` 删除了数据库表 `edit_plans` 中的 `result_count` 字段。如果对应的 SQLAlchemy ORM 模型（通常位于 `models.py` 中的 `EditPlan` 类）没有同步移除该字段定义，应用启动时 SQLAlchemy 会抛出 `sqlalchemy.exc.InvalidRequestError`，因为无法在表中找到该列的映射。 - 修改建议：请确认 `packages/adapters/sqlalchemy_impl/models.py` 中的 `EditPlan` 模型已删除 `result_count` 属性。 2. **apps/api/app/api/routes/templates_editor.py (未在diff中显示，但在修改列表中)**：子路由注册缺失风险。 - 问题描述：被删除的 `edit_plans.py` 文件中包含了对子路由的引用和注册（如 `adjustments_router`, `export_router`, `filter_router` 等）。根据注释“所有剪辑计划 API 迁移到 /templates/{id}/editor/*”，这些子路由应当被迁移并重新注册到 `templates_editor.py` 中。如果遗漏，将导致相关功能不可用。 - 修改建议：请检查 `templates_editor.py` 是否正确 `include_router` 了上述所有子路由，并确保路径前缀符合新的 API 规范。 ### 💡 建议（1个可选） 1. **alembic/versions/048_cleanup_result_count.py 第34行**：Downgrade 脚本的数据丢失提示。 - 问题描述：`downgrade` 函数中使用 `op.add_column` 恢复字段时指定了 `server_default="0"`。由于 `upgrade` 中使用了 `op.drop_column`，原有的 `result_count` 数据在数据库中已永久丢失。回滚操作虽然能恢复表结构，但无法恢复原有数据，所有记录的该字段值都将变为 0。 - 修改建议：虽然对于清理类 Migration 这通常是可以接受的，但建议在代码注释中明确标注此回滚操作会导致数据丢失，提醒运维人员谨慎操作。 --- ✅ 格式检查通过 | ❌ 逻辑审查需修改 | ✅ 性能无明显问题 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-07-20 23:45:27 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

auto-approve-bot merged commit 981d965d89 into develop 2026-07-20 23:48:36 +08:00

auto-approve-bot deleted branch feat/phase3-backend-cleanup 2026-07-20 23:48:36 +08:00

gitea-actions bot commented 2026-07-20 23:48:54 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #657 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #657 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

xiaoxia referenced this issue from a commit 2026-07-21 00:59:48 +08:00

fix(e2e): 更新API路径从/edit-plans到/template-editors

xiaoxia referenced this pull request 2026-07-21 00:59:58 +08:00

fix(e2e): 修复E2E测试API路径从/edit-plans到/template-editors #667

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#657