feat: generate doc preview html

2026-07-01 20:30:34 +08:00
parent 389b9c0c92
commit 611e089c9e
3 changed files with 78 additions and 11 deletions
@@ -40,10 +40,10 @@
 | 024 | 实现层级构建（parent_block_id）+ 结构树 tree 输出 | 后端 | 0.25d | ✅ 已完成 |
 | 025 | 将解析结果批量写入 template_block 表 | 后端 | 0.25d | ✅ 已完成 |
 | | **HTML 预览生成** | | | |
-| 026 | 标题 → `<h2 data-block-id>` 转换 + 居中加粗样式 | 后端 | 0.25d | ⏳ 未完成 |
-| 027 | 段落 → `<p data-block-id>` 转换 + 首行缩进样式 | 后端 | 0.25d | ⏳ 未完成 |
-| 028 | 表格 → `<table data-block-id>` 转换 + 边框样式 | 后端 | 0.25d | ⏳ 未完成 |
-| 029 | 拼接完整 HTML 字符串（带内联 CSS） | 后端 | 0.25d | ⏳ 未完成 |
+| 026 | 标题 → `<h2 data-block-id>` 转换 + 居中加粗样式 | 后端 | 0.25d | ✅ 已完成 |
+| 027 | 段落 → `<p data-block-id>` 转换 + 首行缩进样式 | 后端 | 0.25d | ✅ 已完成 |
+| 028 | 表格 → `<table data-block-id>` 转换 + 边框样式 | 后端 | 0.25d | ✅ 已完成 |
+| 029 | 拼接完整 HTML 字符串（带内联 CSS） | 后端 | 0.25d | ✅ 已完成 |
 | | **查询 + 配置接口** | | | |
 | 030 | 实现 `GET /api/templates/{id}` 组装全部数据 | 后端 | 0.5d | ⏳ 未完成 |
 | 031 | 实现 `POST /api/templates/{id}/blocks/{blockId}/config` upsert | 后端 | 0.25d | ⏳ 未完成 |
@@ -35,3 +35,15 @@
    5. 新增 `save_template_blocks`，上传模板后批量写入 `template_block`。
    6. 使用临时 docx 验证标题、段落、表格混排时的顺序和父子关系。
 - **执行结果**: 完成任务 019-025，上传模板时会解析 Word 并保存模板区域块。
+
+## 会话 ID: 20260701-preview-html
+- [2026-07-01 20:30:13]
+- **执行原因**: 按任务清单继续完成 HTML 预览生成阶段 026-029。
+- **执行过程**:
+    1. 重构 `html_generator.py`，为预览容器、标题、段落、表格定义内联样式。
+    2. 标题输出为 `<h2 data-block-id>`，支持居中、加粗和下边框样式。
+    3. 段落输出为 `<p data-block-id>`，支持首行缩进和两端对齐。
+    4. 表格输出为真实 `<table data-block-id>`，包含表头、单元格边框和占位网格。
+    5. 增加 HTML 转义，避免 Word 文本中的特殊字符破坏预览结构。
+    6. 使用示例 blocks 验证标题、段落、表格 HTML 均生成正确。
+- **执行结果**: 完成任务 026-029，HTML 预览生成服务已满足基础预览要求。