init: 初始化项目

docs/tasks/task_detail_2026_07_06.md

@@ -0,0 +1,78 @@
+# 任务执行摘要
+
+## 会话 ID: 1
+- [2026-07-06 16:00]
+- **执行原因**: 用户要求按任务拆解清单逐步实施项目开发，先完成阶段一和阶段二
+- **执行过程**:
+    1. 创建项目目录结构（backend/, web/, storage/）。
+    2. 编写 docker-compose.yml（Postgres 18.3 + Redis 7）、.env.example、requirements.txt。
+    3. 实现 backend/app/core/ 核心模块：config（pydantic-settings）、database（SQLAlchemy async engine + session）、security（Fernet 加密）。
+    4. 创建 5 个 ORM 模型：AIModel、Template、GenerationPoint、GenerationTask、SystemConfig + Base/TimestampMixin/UUIDMixin。
+    5. 配置 Alembic（alembic.ini, env.py, script.py.mako）。
+    6. 编写 FastAPI 入口 main.py（CORS + health 端点）。
+    7. 实现文件存储服务 file_storage.py（上传/下载/删除）。
+    8. 初始化前端项目（Vite + React 18 + TypeScript + Ant Design + React Router），侧边栏布局 + 5 个占位页面。
+    9. 编写 4 组 Pydantic Schemas（ai_model, template, generation_point, generation_task）。
+    10. 实现文档处理服务 document_processor.py（Mammoth docx→HTML、python-docx HTML→docx、reportlab docx→PDF）。
+    11. 实现 AI 模型管理 API（CRUD + 启用/禁用切换，6 个端点）。
+    12. 实现模板管理 API（上传/获取HTML/更新HTML/下载docx+pdf，6 个端点）。
+    13. 实现生成点管理 API（CRUD + 参考文件上传 + 批量排序更新，5 个端点）。
+    14. 注册路由（api/router.py），更新 main.py，启动验证通过（/health 返回 OK）。
+- **执行结果**: 
+    - 阶段一（基础设施）：45 个文件，后端 5 张表模型导入正常，前端 TypeScript 编译零错误。
+    - 阶段二（核心业务 API）：17 个 API 端点全部注册，后端启动正常，`/health` 返回 200 OK。
+    - Git 提交：2 次提交（b5fa343, aa84521）。
+
+## 会话 ID: 2
+- [2026-07-06 16:15]
+- **执行原因**: 完成阶段三（异步任务与 AI 集成）和阶段四（前端开发）
+- **执行过程**:
+    1. 实现 AI 调用适配器 `ai_adapter.py`：工厂模式支持 openai/azure/custom 三种供应商，httpx 异步调用。
+    2. 实现参考文件解析器 `ref_parser.py`：提取 txt/docx/pdf 文本内容。
+    3. 编写 Celery 配置 `celery_app.py` + 异步生成任务 `generate.py`（模板加载→生成点排序→参考解析→AI调用→HTML插入→文档保存→状态更新）。
+    4. 实现任务管理 API：触发生成/查询状态/下载结果(docx+pdf)/取消任务/单点测试。
+    5. 注册全部 23 个 API 端点，后端启动验证通过。
+    6. 前端 API 层：axios 封装 + 4 组 API 调用（models/templates/generationPoints/tasks）。
+    7. TypeScript 类型定义（AIModel/Template/GenerationPoint/GenerationTask）。
+    8. 模型管理页面：表格 + 新增/编辑弹窗 + 启用切换 + 删除。
+    9. 模板列表页面：表格 + docx 上传 + 在线编辑/下载/删除。
+    10. 模板编辑器（核心）：TinyMCE 自托管 + 选区监听浮动标注 + 生成点弹窗 + 右侧面板（测试/编辑/删除）+ 触发生成任务 + 进度轮询 + 结果下载。
+    11. 任务历史页面：状态标签 + 下载 + 取消。
+    12. 系统设置页面：默认模型/并发/超时配置。
+    13. Vite 配置 API 代理(3000→8000) + TinyMCE 自托管。
+    14. 修复 docker-compose（postgres:18.3→16-alpine）+ Alembic 初始迁移。
+    15. 启动全套服务（PostgreSQL + Redis + Backend + Frontend），前端页面可正常访问。
+- **执行结果**:
+    - 后端 23 个 API 端点，前端 5 个页面完成，TypeScript 零错误，Vite 构建成功。
+    - 服务全部启动：前端 http://localhost:3000 返回 200，后端 /api/v1/models 返回正常。
+    - Git 提交：3 次提交（afabb64, 985a861, 0b23858）。
+    - 总计 8 次提交，约 70 个文件。
+
+## 会话 ID: 3
+- [2026-07-06 16:45]
+- **执行原因**: 完成阶段五（部署上线与安全加固）
+- **执行过程**:
+    1. 添加 `postinstall` 脚本自动复制 TinyMCE 自托管文件。
+    2. 编写 3 个 Dockerfile：backend (uvicorn)、celery-worker、web (多阶段 Node+Nginx)。
+    3. 重写 docker-compose.yml：完整 5 服务编排（postgres + redis + backend + celery + nginx）。
+    4. 编写 nginx.conf 反向代理配置 + gzip + API 代理。
+    5. 安全加固：请求体大小限制中间件、文件类型白名单校验(.docx/.txt/.pdf)、CORS 更新。
+    6. 添加 .dockerignore（backend + web）、deploy.sh 一键部署脚本。
+- **执行结果**:
+    - 后端 17 个端点 + 前端 TypeScript 编译通过 + Vite 构建成功。
+    - 生产部署：`docker compose up -d` 即可一键启动 5 个服务。
+    - Git 提交：1 次提交（017a195）。总计 14 次提交。
+
+## 会话 ID: 4
+- [2026-07-06 17:10]
+- **执行原因**: 补充完善剩余任务（拖拽排序、系统设置、安全加固、Celery验证、文档）
+- **执行过程**:
+    1. Celery Worker 启动验证：连接 Redis，`generate_document` 任务已注册并可通过 inspector 检测。
+    2. 生成点拖拽排序：HTML5 原生 Drag & Drop + `MenuOutlined` 拖拽手柄，拖拽后自动调用 `/batch-order` API。
+    3. 系统设置 API：新增 `/api/v1/settings` GET/PUT，前端 Settings 实时加载模型列表并持久化配置。
+    4. 安全加固：`bleach` HTML 净化过滤 script/onerror 等危险标签，文件类型白名单校验，请求大小限制中间件。
+    5. 修复 Fernet 加密：SHA256(SECRET_KEY) → base64url 派生合法 32 字节密钥。
+    6. 更新 README：修正技术栈版本，补充生产部署 + 本地开发完整步骤。
+- **执行结果**:
+    - API 端点 19 个，所有核心功能模块完成。
+    - 可通过 http://localhost:3000 进行端到端测试。