Browse Source

docs: 更新实现阶段规划(阶段2-4完成)

何文松 1 month ago
parent
commit
0b169be149
1 changed files with 39 additions and 16 deletions
  1. 39 16
      docs/design/数据提取规则系统-实现阶段规划.md

+ 39 - 16
docs/design/数据提取规则系统-实现阶段规划.md

@@ -19,9 +19,9 @@
 | 阶段 | 名称 | 主要产出 | 预估工作量 | 状态 |
 | ---- | ---- | -------- | ---------- | ---- |
 | 1 | 数据模型重构 | 新表结构、实体类重构 | 中 | ✅ 已完成 |
-| 2 | 模板管理 | Template 的 CRUD API | 中 | ⏳ 待开发 |
-| 3 | 来源文件定义 | SourceFile 的 CRUD API | 小 | ⏳ 待开发 |
-| 4 | 变量管理 | Variable 的 CRUD API | 中 | ⏳ 待开发 |
+| 2 | 模板管理 | Template 的 CRUD API | 中 | ✅ 已完成 |
+| 3 | 来源文件定义 | SourceFile 的 CRUD API | 小 | ✅ 已完成 |
+| 4 | 变量管理 | Variable 的 CRUD API | 中 | ✅ 已完成 |
 | 5 | 内容定位服务 | 按页码/章节/元素定位 | 中 | ⏳ 待开发 |
 | 6 | AI 提取服务 | AI 字段提取、总结 | 中 | ⏳ 待开发 |
 | 7 | 生成任务管理 | Generation 的 CRUD API | 中 | ⏳ 待开发 |
@@ -29,7 +29,7 @@
 | 9 | 文档生成 | 替换变量、输出文档 | 中 | ⏳ 待开发 |
 | 10 | 集成与优化 | 系统集成、性能优化 | 中 | ⏳ 待开发 |
 
-> **当前进度**: 1/10 阶段完成 (10%)
+> **当前进度**: 4/10 阶段完成 (40%)
 > 
 > **备注**: v1.x 版本已完成的代码需要重构以适应新设计
 
@@ -152,10 +152,17 @@
 
 #### 2.2.3 验收标准
 
-- [ ] 可创建模板并关联示例报告
-- [ ] 可查询、更新、删除模板
-- [ ] 发布/归档状态切换正常
-- [ ] 复制模板功能正常
+- [x] 可创建模板并关联示例报告
+- [x] 可查询、更新、删除模板
+- [x] 发布/归档状态切换正常
+- [x] 复制模板功能正常
+
+> ✅ **已完成** (2026-01-23)
+> 
+> 实现概要:
+> - TemplateService: create, getById, getTemplateDetail, listByUserId, update, delete, publish, archive, duplicate
+> - TemplateController: 完整 RESTful API
+> - DTO: CreateTemplateRequest, UpdateTemplateRequest, TemplateDetailResponse, TemplateListResponse
 
 ---
 
@@ -184,10 +191,17 @@
 
 #### 2.3.3 验收标准
 
-- [ ] 可添加来源文件定义(自定义别名)
-- [ ] 别名在模板内唯一
-- [ ] 可设置文件类型、是否必须等属性
-- [ ] 可调整显示顺序
+- [x] 可添加来源文件定义(自定义别名)
+- [x] 别名在模板内唯一
+- [x] 可设置文件类型、是否必须等属性
+- [x] 可调整显示顺序
+
+> ✅ **已完成** (2026-01-23)
+> 
+> 实现概要:
+> - SourceFileService: add, batchAdd, getById, listByTemplateId, update, delete, forceDelete
+> - 集成到 TemplateController(/api/v1/templates/{templateId}/source-files)
+> - DTO: AddSourceFileRequest, SourceFileResponse
 
 ---
 
@@ -231,10 +245,19 @@
 
 #### 2.4.3 验收标准
 
-- [ ] 可创建各种来源类型的变量
-- [ ] 变量名在模板内唯一
-- [ ] 配置校验正确
-- [ ] 引用类型变量的循环引用检测正常
+- [x] 可创建各种来源类型的变量
+- [x] 变量名在模板内唯一
+- [x] 配置校验正确
+- [x] 引用类型变量的循环引用检测正常
+
+> ✅ **已完成** (2026-01-23)
+> 
+> 实现概要:
+> - VariableService: add, batchAdd, getById, getByName, listByTemplateId, update, delete, forceDelete
+> - 支持按来源文件、来源类型、分组过滤
+> - 引用变量检测: findReferencingVariables
+> - 集成到 TemplateController(/api/v1/templates/{templateId}/variables)
+> - DTO: AddVariableRequest, VariableResponse
 
 ---