docs: Web UI 设计评审修订(v1.0→v1.1,7 项发现全修 + api §2.2 write_instruction)

This commit is contained in:
lhl
2026-08-09 13:28:38 +08:00
parent 69f04ecda2
commit 1a3c829d4c
6 changed files with 376 additions and 99 deletions
+23 -7
View File
@@ -1027,7 +1027,7 @@ QA 输出:
```
┌─────────────────────────────────────────────────────────────┐
│ Genesis [上传] [解析] [影响调查] [生成] [结果] [设置] │ ← 顶部导航
│ Genesis [上传] [解析] [影响调查] [生成] [结果] [历史] [设置] │ ← 顶部导航
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─ 对话区域 ──────────────────────────────────────────┐ │
@@ -1070,9 +1070,9 @@ QA 输出:
│ │ .docx (Word) │ │
│ └─────────────────────────────────────┘ │
│ │
│ 📁 入规则 (推荐, 可多个) │
│ 📁 入规则 (推荐, 可多个) │
│ 📁 图表规则 (推荐) │
│ 📁 做成说明书 (推荐)
│ 📁 做成说明书 (推荐, 独立类型)
│ │
│ 📁 现有系统文件 (任意, 追加/改修场景使用) │
│ │
@@ -1085,7 +1085,7 @@ QA 输出:
上传规则:
- 要件定义文件至少一个
- 模板文件必须是一个 .docx
- 规则文档可多个,也可零个(规则手册已存在时
- 做成说明书 / 记入规则 / 图表规则 均可多个,也可零个(规则手册已存在时);做成说明书使用独立 `file_type=write_instruction`api-design §2.2
- 现系统文件仅在追加/改修场景时需要
- 文件大小限制:最大100MB
- 支持拖拽上传、点击上传、取消上传
@@ -1181,10 +1181,25 @@ QA 输出:
│ 适用规则: 写入规则_v3 │
│ │
│ [中途中断] [查看日志] │
│ │
│ ┌─ 规则冲突 (浮动卡片) ───────────────────┐ │
│ │ ⚠ 检测到规则冲突(DB设计章) │ │
│ │ 记入规则 2.3「表头仅加粗」 │ │
│ │ 图表规则 2.3「表头加粗+下划线」 │ │
│ │ [采用「记入规则」] [采用「图表规则」] [标注] │ │
│ └──────────────────────────────────────┘ │
└─────────────────────────────────────────────┘
```
交互说明:用户可保持此画面打开同时进行其他工作。生成完成时通知。选择中断时,已完成的章节保留。
交互说明:用户可保持此画面打开同时进行其他工作。生成完成时通知。选择中断时,已完成的章节保留。规则冲突由 WS 事件 `conflict_pending` 触发浮动卡片,决策后调用 `/api/rules/conflicts/{id}/resolve` 继续生成。
#### 页面6: 设置
>
> 简版:规则手册版本管理(versions / 更新 / 回滚)+ LLM 配置只读摘要(脱敏)。见 `docs/web-ui-design.md` §3.6。
#### 页面7: 会话历史
>
> 简版:会话列表(恢复 / 删除 / 新建),对应 `GET /api/sessions`。见 `docs/web-ui-design.md` §3.7。
#### 页面5: 结果预览与下载
@@ -1199,7 +1214,7 @@ QA 输出:
│ └────────────────────────────────────────┘ │
│ │
│ ┌─ 预览 ──────────────────────────┐ │
│ │ (docx → HTML → 浏览器内渲染) │ │
│ │ (ContentBlock → HTML 渲染) │ │
│ │ [章标题] [段落] [表] ... │ │
│ └────────────────────────────────────────┘ │
│ │
@@ -1218,7 +1233,7 @@ QA 输出:
#### 8.4.1 任务管理
```
Task Queue (Redis)
TaskQueue(抽象接口,默认 InMemoryQueue,生产可切 Redis/Valkey
├── task:generate-chapter-1
│ status: completed
│ result: {chapter: "功能一览", html: "...", time_ms: 23000}
@@ -1305,6 +1320,7 @@ CREATE TABLE session_files (
/impact → 跳转到影响调查画面
/generate → 跳转到生成执行画面
/result → 跳转到结果画面
/history → 跳转到历史会话页
/settings → 跳转到设置画面
/status → 显示当前生成任务的状态
/cancel → 取消当前生成