zwt13703
113 lines
4.3 KiB
Markdown
113 lines
4.3 KiB
Markdown
# AI 文档模板生成系统 · 任务拆解清单
|
||
|
||
总工期估算：5-6 周（两人并行：前端 + 后端）
|
||
|
||
## 第一阶段：架构与规范（第 1 周）
|
||
|
||
- [x] 搭建前端脚手架（Vue 3 + Vite + TS + Ant Design Vue + Pinia + Router）
|
||
- [x] 搭建后端脚手架（FastAPI + SQLAlchemy async + SQLite）
|
||
- [x] 数据库表设计与建表
|
||
- [x] 模板格式规范定稿（段落边界规则、标题样式要求、表格归属）
|
||
- [x] AI 输出格式规范定稿（JSON 结构、表格标记、错误兜底）
|
||
- [x] 导出策略定稿（基于原模板替换内容）
|
||
- [x] 前后端 API 接口约定
|
||
|
||
## 第二阶段：后端核心开发（第 2-3 周）
|
||
|
||
### Word 解析器（5-7 天）
|
||
- [x] python-docx 打开模板，逐段落遍历
|
||
- [x] 标题样式识别（Heading 1~6）→ 段落边界
|
||
- [x] 正文内容捕获 → 合并到上一标题
|
||
- [ ] 表格结构提取（行列数、合并单元格、边框、底纹）
|
||
- [x] 样式捕获（字体名、字号、加粗、颜色、对齐、缩进、间距、行距）
|
||
- [x] 段落索引记录（在文档中的位置，用于导出定位）
|
||
- [x] 输出结构化 JSON
|
||
|
||
### AI 服务层（5-7 天）
|
||
- [x] OpenAI 格式适配（GPT-4o、DeepSeek-V3、通义千问）
|
||
- [x] Anthropic 格式适配（Claude 3.5 Sonnet）
|
||
- [x] 统一接口：call_ai(paragraph, files, callback) → content
|
||
- [ ] 提示词拼接：系统提示词 + 段落预设提示词 + 文件摘要
|
||
- [x] 超时/重试/错误处理
|
||
- [ ] 并发控制（asyncio.Semaphore）
|
||
- [ ] 文件摘要生成（Excel 解析 + 数据统计）
|
||
|
||
### 文档生成器（3 天）
|
||
- [x] 单段落生成流程
|
||
- [ ] 多段落并行生成编排（asyncio.gather）
|
||
- [x] SSE 进度推送
|
||
- [x] 取消生成支持
|
||
- [x] 生成结果入库
|
||
|
||
### Word 导出引擎（5-7 天）
|
||
- [ ] 复制原模板文件作为骨架
|
||
- [ ] 段落定位（按索引/xpath/标题文本三级匹配）
|
||
- [ ] 纯文本替换（保留原样式）
|
||
- [ ] 表格填充（删除占位表格 → 创建新表格 → 填充数据 → 应用样式）
|
||
- [ ] 混合内容处理（文字 + 表格交替）
|
||
- [ ] PDF 导出（调用 LibreOffice 命令）
|
||
|
||
### 路由与 API（3 天）
|
||
- [x] 模板 CRUD 路由
|
||
- [x] 模型 CRUD 路由
|
||
- [x] 生成相关路由（测试/全量/进度SSE/取消）
|
||
- [ ] 导出路由（Word/PDF）
|
||
- [x] 文件上传/管理
|
||
|
||
## 第三阶段：前端核心开发（第 2-4 周）
|
||
|
||
### 通用组件（3 天）
|
||
- [ ] FileUploader 组件（拖拽 + 点击上传）
|
||
- [ ] ModelModal 组件（添加/编辑模型弹窗）
|
||
- [ ] TestModal 组件（段落测试三步弹窗）
|
||
- [ ] 状态标签、加载状态、空状态组件
|
||
|
||
### 模板管理页（5-7 天）
|
||
- [ ] 模板列表：卡片布局 + 搜索 + 分页
|
||
- [x] 三栏编辑器布局
|
||
- [x] 左栏：段落列表（点击高亮 + 滚动联动）
|
||
- [x] 中栏：文档预览（A4 纸样式，段落可点击选择）
|
||
- [x] 右栏：段落配置面板（编辑方式/模型/提示词/文件/格式）
|
||
- [x] 保存模板
|
||
|
||
### 模型管理页（2 天）
|
||
- [x] 模型卡片列表 + 启用/禁用
|
||
- [x] 添加/编辑弹窗表单
|
||
|
||
### 执行生成页（3 天）
|
||
- [x] 双栏布局：左模板选择 + 右段落列表
|
||
- [x] 文件上传区（按段落分列）
|
||
- [x] 生成按钮 + 进度展示
|
||
- [x] 完成跳转
|
||
|
||
### 生成记录页（2 天）
|
||
- [x] 统计卡片
|
||
- [ ] 卡片式历史列表 + 筛选
|
||
- [x] 预览/下载按钮
|
||
|
||
### 预览编辑页（3-4 天）
|
||
- [ ] 富文本编辑器（contenteditable + 自定义工具栏）
|
||
- [ ] AI 内容紫色高亮标注
|
||
- [ ] 重新生成单段落
|
||
- [x] 保存/导出按钮
|
||
|
||
## 第四阶段：联调与修边（第 5-6 周）
|
||
|
||
- [ ] 文件上传 → 解析 → 保存 → 生成 → 导出全流程联调
|
||
- [ ] 模板不同格式兼容性测试（不同字体、不同布局、含表格/图片/页眉页脚）
|
||
- [ ] AI 不同模型的输出格式兼容性
|
||
- [ ] 错误处理完善（网络中断、模型不可用、文件格式错误）
|
||
- [ ] 边界情况处理（空模板、超大文件、特殊字符）
|
||
- [ ] 响应式适配
|
||
- [ ] 加载状态/骨架屏
|
||
- [ ] 操作提示/Toast
|
||
|
||
## 阶段交付物
|
||
|
||
| 阶段 | 交付物 |
|
||
|------|--------|
|
||
| 第 1 周 | 项目脚手架、数据库表、API 接口文档 |
|
||
| 第 2-3 周 | 后端全部功能可用（可通过 API 测试） |
|
||
| 第 4-5 周 | 前端全部页面可用，可联调 |
|
||
| 第 6 周 | 全流程跑通，交付验收 |
|