# AI 文档模板生成系统 · 项目概述

## 一句话
上传 Word 模板 → AI 自动解析段落结构 → 配置各段落生成规则 → 上传参考文件 → AI 并行生成 → 在线预览编辑 → 导出保留原始样式的 Word 文档。

## 核心架构
```
┌─────────────────────────────────────────────────────┐
│                  前端 Vue 3 + Ant Design Vue         │
│  模板管理  模型管理  执行生成  生成记录  预览编辑    │
└────────────┬───────────────────────────┬────────────┘
             │ REST API + SSE 进度       │
             ▼                           ▼
┌─────────────────────────────────────────────────────┐
│              后端 FastAPI + SQLAlchemy               │
│  模板解析 → 段落管理 → AI 调度 → 文档生成 → 导出    │
└─────────────────────────────────────────────────────┘
```

## 核心流程（7步闭环）
1. **上传模板** — 上传 .docx → 解析段落结构 + 完整样式 → 存库
2. **段落标注** — 三栏编辑器：左栏点段落→中栏定位→右栏配置（编辑方式/模型/提示词/参考文件）
3. **保存模板** — 段落配置持久化
4. **执行生成** — 选模板 → 按需上传参考文件 → 启动生成
5. **并行生成** — 无依赖段落同时请求 AI，SSE 实时推进度
6. **预览编辑** — 富文本编辑器查看结果，手动精修
7. **导出 Word** — 基于原模板替换内容，样式零损失

## 关键设计决策
| 决策 | 选择 | 原因 |
|------|------|------|
| 段落边界 | Word 内置标题样式 (Heading 1~6) | 最稳定，用户学习成本低 |
| 输出格式 | AI 返回结构化 JSON | 支持文字+表格混合，后端可控解析 |
| 导出策略 | 基于原模板替换内容 | 样式零损失，不限模板格式 |
| 生成方式 | 多段落并行请求 AI | 大幅缩短等待时间 |
| 样式保留 | 导出时读取原模板段落样式映射 | 精度最高 |

## 技术栈
- **前端**: Vue 3.4 + Vite 5 + TypeScript + Ant Design Vue 4.x + Pinia + Axios
- **后端**: Python 3.11+ + FastAPI + SQLAlchemy 2.0 (async) + SQLite + python-docx + openpyxl + httpx