update

UI测试手册.md

@@ -1,6 +1,6 @@
 # 第 1~4 周功能 · 界面人工测试手册
 
-> 用途：你按这份手册在浏览器里点一遍，验证第 1~4 周的功能（登录、租户/项目、资源 ACL、审计日志、审批中心、写操作自动审计与审批拦截）。
+> 用途：你按这份手册在浏览器里点一遍，验证第 1~4 周的功能（登录、租户/项目、资源 ACL、审计日志、审批中心、数据处理 C 模块、写操作自动审计与审批拦截）。
 > 功能代码层均已联调通过（含此前修复的 `audit.ts`/`approval.ts` 双重解包、审计接口 `/system` 前缀、审批模块 `include_router` 启动崩溃）。下面是给你的人工回归步骤。
 
 ---
@@ -276,7 +276,77 @@ npm run dev
 
 ---
 
-## 6. 验收清单（打勾）
+## 6. 数据处理（C 模块 · 第 2 周）
+
+> 入口：左侧菜单「数据治理 → 数据处理」（`/data-process`），对应后端 `/modelTF/data-process/*`。该模块为本次合并从 `yg_ft1` 并入的可运行子系统（后端 `app/modules/data_process/` + 前端 `views/data-process/`）。
+> 创建任务为**六步向导**：`创建任务 → 大模型选择 → 上传文件 → 数据预览 → 开始生成 → 结果编辑与保存`。后端启动时会自动建表（`002_data_process.sql`），无需手动迁移。
+
+### 6.1 列表与入口
+1. 左侧菜单「数据治理 → 数据处理」
+2. 预期：进入列表页 `/data-process`，展示已有数据处理任务（空状态显示「暂无数据」属正常，不要当成 bug）
+3. 点右上「新建数据处理」进入创建向导
+
+### 6.2 创建任务（六步向导）
+
+**步骤 1 · 创建任务**
+1. 填任务名称（如 `test-dp-manual`）、描述（可选）
+2. 选处理类型：
+   - `结构化数据`（structured）：按行生成 QA 对
+   - `非结构化数据`（unstructured）：文档切片（chunk 方法/大小/重叠/保留表格代码块等）
+   - `外部数据源`（external）：接 PostgreSQL 等外部库
+3. 配置处理选项（预处理、语义增强、数据集切分比例、输出类型、温度等，保持默认即可）
+4. 点「继续：选择大模型」
+
+**步骤 2 · 大模型选择**
+1. 从模型下拉选一个生成模型（需「模型管理」里已登记可用模型；若下拉为空，先到「模型管理」登记一个基座/API 模型）
+2. 设输出要求（生成模型、提示词、输出类型、reasoning、温度、max_tokens、质量过滤开关等）
+3. 点「继续：上传文件」
+
+**步骤 3 · 上传文件**
+- 结构化/非结构化：点「上传」选本地文件（jsonl/csv/pdf/docx/xlsx/txt 等，按处理类型校验扩展名）；或点「使用样例文件」快速载入示例 `finance_qa.jsonl`
+- 外部数据源：填连接（postgresql URL、认证模式、只读 `SELECT` 查询），点「测试连接」→ 联通后「拉取数据」
+1. 选/拉取至少一个源文件，等待上传完成（状态变 `ready`）
+2. 点「继续：数据预览」，系统自动按配置**切分**（进度条，可能耗时；失败会提示原因，可重试）
+
+**步骤 4 · 数据预览**
+1. 切分完成后进入预览，左侧为源文件 / 分片列表，右侧为预览内容
+2. 可编辑预览条目内容、新增 / 删除条目、还原为原文（不影响源文件）
+3. 切换不同源文件核对切分结果
+4. 点「确认预览并继续」
+
+**步骤 5 · 开始生成**
+1. 进入生成页，显示任务摘要（任务名、处理类型、文件、预览条目数、修改条数）
+2. 点「开始生成」启动处理（调用所选大模型）
+3. 等待生成完成：状态 `running → completed`（失败显示原因，可「重新生成」）
+4. 生成成功后点「查看生成结果」
+
+**步骤 6 · 结果编辑与保存**
+1. 进入结果编辑页，逐条检查结果（问题 / 答案等），可编辑字段、单条或批量「重新生成」
+2. 校验通过后点「保存任务」
+3. 预期：提示「生成结果已确认」，跳转到任务详情页 `/data-process/<任务ID>`
+
+### 6.3 任务详情
+1. 列表点目标任务「详情」（或保存后自动进入）
+2. 预期：详情页展示任务信息、处理配置、源文件、预览条目、生成结果
+3. 支持「重新生成」（`/data-process/:id/regenerate`）与「任务进度」（`/data-process/:id/workflow`）两个子页，均复用创建向导
+
+### 6.4 重新生成（可选）
+1. 详情页或列表进入「重新生成」子页
+2. 调整配置（保持原处理类型），保存后按新配置重新切分 / 生成；原生成结果与已发布数据在点击「开始生成」前保持不变
+3. 验证：提交重新生成后，进度可在「任务进度」页查看
+
+### 6.5 发布数据集（第 2 周验收点）
+1. 结果确认后，在详情页点「发布数据集」（对应 `POST /modelTF/data-process/{id}/publish`）
+2. 填目标数据集元信息（名称 / 项目归属等），确认发布
+3. 预期：生成数据集记录，可在「数据集管理」看到该发布数据集，来源链路保留
+
+### 6.6 删除任务（可选）
+1. 列表行点「删除」，二次确认后删除
+2. 预期：列表不再显示该任务
+
+---
+
+## 7. 验收清单（打勾）
 
 **第 1~2 周**
 - [ ] 1. 登录成功，进仪表盘，显示 `admin`
@@ -287,6 +357,14 @@ npm run dev
 - [ ] 6. 归档：点后状态变 `archived`
 - [ ] 7. 用户设置：创建用户（账号/显示名/初始密码/角色/状态/页面权限均可设，列表出现新账号）、重置密码（自定义生效 / 留空回退 `platform123` / `admin` 被拒）、启用禁用账号（禁用后登录失败、启用后恢复）、页面权限精细控制（取消权限后登录即生效）、删除账号（二次确认后列表移除、登录失败）
 
+**第 2 周（数据处理 · C 模块）**
+- [ ] 16. 数据处理入口可见（数据治理 → 数据处理），列表 / 空状态正常
+- [ ] 17. 创建向导六步可走通：创建任务 → 选模型 → 上传/拉取源文件 → 切分预览（可编辑/增删/还原）→ 生成 → 结果保存并跳详情
+- [ ] 18. 结构 / 非结构化 / 外部数据源三类处理类型均可配置并产出预览条目
+- [ ] 19. 生成结果可编辑、可单条 / 批量重新生成，保存后跳详情
+- [ ] 20. 发布数据集成功，「数据集管理」可见且保留来源链路
+- [ ] 21. 全程浏览器控制台（F12 → Console）在数据处理流程中无红色报错
+
 **第 3 周（审计）**
 - [ ] 8. 审计日志：按 动作/操作人/项目 过滤均能返回正确结果
 - [ ] 9. 审计日志：导出 CSV 成功，列与内容正确
@@ -301,19 +379,19 @@ npm run dev
 
 ---
 
-## 7. 我自测已覆盖（你不用重复，除非想验证）
+## 8. 我自测已覆盖（你不用重复，除非想验证）
 
 - 后端真实导入：`import app.main` → `IMPORT_OK`，启动崩溃已修复（`approval/__init__.py` 补 re-export `router`）。
 - 前端 `type-check` 全绿：`audit.ts`/`approval.ts` 双重解包已改 `get/post`；审计接口已加 `/system` 前缀（`/system/audit-logs`、`/system/audit-logs/export`）。
 - 接口链路已用真实代码核对：审计查询/导出（`system`）、审批模板/实例/逐步决策（`approvals`）、项目写操作自动 `record_audit` 与 `_require_no_pending_approval` 拦截均按上述行为实现。
 
-## 8. 已知非 bug / 注意事项（仅供参考）
+## 9. 已知非 bug / 注意事项（仅供参考）
 
 1. 前端由你自己在 **Windows 终端** 跑 `npm run dev` 启动（默认 **16801**）。不要从 WSL 终端启动（会慢 8 倍）。
 2. 「归档项目」当前是**直接执行无确认弹窗**——功能正确，建议后续补个二次确认，避免误操作。
 4. 控制台偶见的 `ERR_ABORTED` 是导航时浏览器正常中止旧 CSS 请求，无害；Google Fonts 外网字体加载失败不影响功能。
 5. 审计「操作人」列 = 登录 token（当前登录用户标识），由前端 `Authorization: Bearer <token>` 透传，非真实姓名。
 
-## 9. 清理测试数据（可选）
+## 10. 清理测试数据（可选）
 
 手动建的 `test-tenant-manual` / `test-project-manual`、审批实例/模板可在对应列表里删除，或告诉我帮你清库（后端连 PostgreSQL，`PlatformStore` 启动时自动建表）。