zwt13703
5.6 KiB
5.6 KiB
AI 文档模板生成系统 · 模板在线编辑重构任务拆解清单
总工期估算：4-6 周（两人并行：前端 + 后端）
第一阶段：方案定稿与数据结构升级（第 1 周）
产品方案与交互定稿（2-3 天）
- 明确“在线编辑模式 / AI 选区模式”双模式交互
- 明确块类型定义（标题块 / 正文块 / 表格块 / AI 块 / 变量块）
- 明确 AI 选区后的操作菜单（设为 AI / 设为固定内容 / 设为变量）
- 明确模板保存后的基线含义（保存即修改模板源内容）
- 明确导出时的填充规则（固定内容保留，AI 块填充，变量块替换）
- 输出交互原型说明文档
数据模型升级（2-3 天）
- 新增模板块表
template_blocks - 定义块字段（block_type / sort_index / parent_id / anchor_ref / content_json / style_json / edit_mode）
- 为 AI 块补充字段（placeholder_key / model_id / prompt_text / need_file / output_format）
- 为变量块补充字段（variable_key / default_value）
- 保留旧
paragraphs结构用于兼容过渡 - 输出数据库增量 SQL
第二阶段：模板解析器重构（第 1-2 周）
Word 块级解析（4-5 天）
- 解析
.docx为块流结构，而不只按 Heading 识别段落 - 识别标题块
- 识别普通正文块
- 识别表格块
- 识别空白分隔块
- 为每个块记录原始位置索引与样式快照
- 输出新的块级 JSON 结构
特殊区域识别（2-3 天）
- 识别封面区内容（标题 / 日期 / 负责人 / 单位等）
- 识别摘要区内容
- 识别未使用 Heading 的小节正文
- 识别连续正文中的可拆分候选块
- 输出模板体检提示信息
第三阶段：模板在线编辑器重构（第 2-3 周）
中间编辑画布（4-5 天）
- 将当前段落预览区改造为块级编辑画布
- 支持标题块直接编辑
- 支持正文块直接编辑
- 支持表格块展示与基础编辑
- 支持块新增
- 支持块删除
- 支持块上移 / 下移
- 支持块拆分 / 合并
编辑模式与 AI 选区模式（3-4 天）
- 增加“在线编辑模式 / AI 选区模式”切换
- 在线编辑模式下支持直接修改模板内容
- AI 选区模式下支持鼠标选中一段内容
- 选中内容后可设为 AI 块
- 选中内容后可设为变量块
- 支持在当前位置后插入新的 AI 块
- 支持取消 AI 标记并恢复为固定内容
左右侧配置区联动（2-3 天）
- 左侧块列表与中间编辑画布联动高亮
- 右侧根据当前选中块显示不同配置项
- AI 块显示模型 / 提示词 / 文件要求 / 输出格式配置
- 变量块显示变量名 / 默认值配置
- 固定块显示只读或基础编辑信息
第四阶段：模板保存与模板源同步写回（第 3 周）
模板保存链路重构（3-4 天）
- 保存模板时持久化块结构而非仅保存段落配置
- 保存模板时同步生成最新模板快照
- 将最新模板快照写回模板源
.docx - 保存后重新加载模板时展示最新编辑结果
- 补充模板版本或快照记录
模板源写回引擎（3-4 天）
- 支持标题块写回
- 支持正文块写回
- 支持删除块后同步从模板源移除
- 支持移动块后同步更新模板顺序
- 支持新增块后同步插入模板源
- 处理第一页封面区块写回
第五阶段：生成链路适配（第 3-4 周）
AI 生成任务改造（3-4 天）
- 生成任务由“按段落”改为“按 AI 块”
- 固定块不参与 AI 生成
- 变量块按规则填充值
- AI 块支持单块测试生成
- AI 块支持多块批量生成
- AI 块支持失败回退与重试
文件与提示词链路适配（2-3 天）
- 文件上传改为绑定 AI 块
- 历史文件复用继续兼容
- 提示词配置迁移到 AI 块级别
- 输出格式配置迁移到 AI 块级别
第六阶段：导出引擎重构（第 4-5 周）
Word 导出写回（4-5 天）
- 导出基于“最新模板快照”而不是原始导入模板
- 固定块保持模板编辑后的最终内容
- AI 块按占位位置写回生成结果
- 变量块按变量值替换
- 支持同一位置下多块顺序写回
- 支持文字与表格混排导出
- 保留主要样式与段落结构
导出正确性校验（2-3 天）
- 校验删除块后导出无残留
- 校验调整顺序后导出顺序正确
- 校验第一页内容导出正确
- 校验摘要区内容导出正确
- 校验多级标题结构导出正确
第七阶段：联调、修边与验收（第 5-6 周）
- 用真实复杂模板联调（含封面 / 摘要 / 多级标题 / 表格）
- 验证第一页块可删除、可调整、可导出
- 验证保存模板后再次进入能看到最新模板内容
- 验证 AI 选区转块后的生成与导出闭环
- 验证历史生成记录兼容旧数据
- 完善错误提示、加载状态与操作反馈
- 补充模板编辑使用说明
阶段交付物
| 阶段 | 交付物 |
|---|---|
| 第 1 周 | 在线编辑方案、块模型设计、数据库增量方案 |
| 第 2 周 | 新版模板解析器、块级 JSON 结构、模板体检提示 |
| 第 3 周 | 块级在线编辑器、AI 选区模式、模板保存链路 |
| 第 4-5 周 | AI 块生成链路、导出写回引擎、真实模板导出闭环 |
| 第 6 周 | 全流程联调通过、使用说明与验收结果 |