diff --git a/docs/原型设计/1.1.资料包导入页原型设计.md b/docs/原型设计/1.1.资料包导入页原型设计.md new file mode 100644 index 0000000..cbf383b --- /dev/null +++ b/docs/原型设计/1.1.资料包导入页原型设计.md @@ -0,0 +1,142 @@ +# 资料包导入页原型设计 + +## 1. 页面目标 + +把注册申报资料的导入、解包、扫描、目录汇总和章节点识别结果集中展示出来,让用户第一眼就明白本平台的输入对象是“资料包”,不是单篇文档。 + +## 2. 适用角色 + +- 注册资料专员 +- 文档整理人员 +- 演示讲解人 + +## 3. 页面布局分区 + +页面建议采用“三段式”: + +1. 顶部导入条 +2. 中部处理看板 +3. 底部目录汇总区 + +建议分区: + +- 顶部:批次信息、上传入口、导入方式切换 +- 左侧:文件 / 压缩包导入队列 +- 中部:处理流水线 +- 右侧:异常与待复核箱 +- 底部:目录树与目录汇总表 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 导入入口卡 + +展示: + +- 批量文件上传 +- 文件夹导入 +- 压缩包导入 +- 支持格式标签:`pdf / docx / doc / zip / rar / 7z` + +### 4.2 处理流水线 + +按步骤展示: + +1. 创建批次 +2. 文件校验 +3. 解包 +4. 文件树扫描 +5. 页数统计 +6. 章节点识别 +7. 目录汇总 + +每一步显示: + +- 当前状态 +- 处理数量 +- 成功 / 失败数 + +### 4.3 异常箱 + +展示以下异常类型: + +- 页数待复核 +- 扩展名与 MIME 不一致 +- 扫描件待 OCR +- 章节点识别失败 +- 解包失败 + +### 4.4 目录汇总表 + +表格列建议: + +- 原始相对路径 +- 文件名 +- 文件类型 +- 页数 +- 页数可信度 +- 章节点 +- 资料名称 +- 处理状态 +- 是否命中法规目录 + +## 5. 关键字段定义 + +页面主要消费 `registration_overview_report`。 + +关键字段: + +- `batch_id` +- `file_count` +- `supported_file_count` +- `failed_file_count` +- `total_page_count` +- `page_count_status` +- `chapter_summary` +- `documents[]` + +目录条目关键字段: + +- `original_filename` +- `relative_path` +- `file_type` +- `chapter_code` +- `chapter_name` +- `page_count` +- `page_count_confidence` +- `processing_status` +- `needs_manual_review` + +## 6. 关键交互 + +- 点击“上传压缩包”后,展示模拟导入进度。 +- 点击目录树节点,可在右侧高亮对应文件。 +- 点击异常项,可筛选下方表格。 +- 点击单个文件行,可打开“文档详情抽屉”,展示页数统计方式和章节点识别结果。 +- 点击“进入法规完整性检查”,跳转下一页。 + +## 7. 与上下游页面的数据关系 + +上游:无,属于演示主线起点。 + +下游: + +- 法规完整性检查页直接消费目录汇总结果。 +- 字段抽取页复用文档主数据、文本状态和章节点结果。 +- 治理台中的 RAG 文档源管理可从该页二级入口进入。 + +## 8. 演示话术重点 + +- 强调本平台处理的是整套注册资料,不是单文档聊天。 +- 强调压缩包、目录层级、页数和章节点是后续审核的事实基础。 +- 强调异常箱的价值在于把“资料问题”前置,而不是等到审核后才发现。 + +## 9. 与知识库 / 治理台的关联入口 + +本页应提供以下治理入口: + +- `查看 RAG 入库策略` +- `查看支持文件类型配置` +- `查看章节点识别规则` +- `重跑切片任务` + +这些入口统一打开治理台抽屉,不在本页直接展开 CRUD。 diff --git a/docs/原型设计/1.2.审核任务工作台原型设计.md b/docs/原型设计/1.2.审核任务工作台原型设计.md new file mode 100644 index 0000000..ea2f69e --- /dev/null +++ b/docs/原型设计/1.2.审核任务工作台原型设计.md @@ -0,0 +1,120 @@ +# 审核任务工作台原型设计 + +## 1. 页面目标 + +作为整套原型的首页,先把当前批次的审核进度、任务状态、关键风险和操作入口集中展示,让用户在 10 秒内理解平台价值和当前处理位置。 + +## 2. 适用角色 + +- 注册申报负责人 +- 项目经理 +- 复试演示讲解人 + +## 3. 页面布局分区 + +页面建议采用“总览头图 + 流程卡片 + 风险与待办双栏”。 + +分区如下: + +- 顶部 Hero:批次、产品、流程、总体结论 +- 中部七卡任务区 +- 下方左侧:风险总览 +- 下方右侧:待办动作与推荐下一步 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 批次总览 Hero + +展示: + +- 批次编号 +- 产品名称 +- 当前流程类型 +- 当前审核阶段 +- 最高风险等级 +- 是否允许正式导出 + +### 4.2 七个流程任务卡片 + +固定七张卡片: + +1. 资料包导入 +2. 目录汇总 +3. 法规完整性检查 +4. 字段抽取 +5. 一致性核查 +6. 风险预警 +7. Word 回填导出 + +每张卡片展示: + +- 任务名称 +- 当前状态 +- 关键指标 +- 最近执行时间 +- 进入页面按钮 + +### 4.3 风险总览区 + +展示: + +- 高 / 中 / 低风险数量 +- 当前阻断原因 +- 需要人工复核的字段数 + +### 4.4 待办动作区 + +展示: + +- 缺失项补充建议 +- 字段冲突待确认项 +- 推荐下一步操作 + +## 5. 关键字段定义 + +建议聚合使用以下对象: + +- `registration_overview_report` +- `registration_completeness_report` +- `registration_field_extraction_report` +- `registration_consistency_report` +- `registration_risk_report` +- `registration_word_export_report` + +工作台摘要字段: + +- `task_name` +- `task_status` +- `last_run_at` +- `summary_label` +- `summary_value` +- `entry_target` + +## 6. 关键交互 + +- 点击任务卡片进入对应页面。 +- 点击“查看总体风险”滚动到风险区。 +- 点击“打开治理台”查看规则版本、字段 Schema、模板版本。 +- 鼠标悬浮卡片显示“本任务输入来自哪里,输出流向哪里”。 + +## 7. 与上下游页面的数据关系 + +上游:汇总所有页面结果。 + +下游:为各页面提供统一入口,不产生独立业务结果。 + +## 8. 演示话术重点 + +- 先讲“流程闭环”,再讲某个点上的智能能力。 +- 突出这不是自由问答,而是受控的任务执行工作台。 +- 强调每个任务卡片都有状态、有输入输出、有结构化结果。 + +## 9. 与知识库 / 治理台的关联入口 + +工作台页右上角提供: + +- `规则版本总览` +- `模板版本总览` +- `责任人映射总览` + +适合作为讲解治理能力的总入口。 diff --git a/docs/原型设计/1.3.法规完整性检查页原型设计.md b/docs/原型设计/1.3.法规完整性检查页原型设计.md new file mode 100644 index 0000000..3c61fc9 --- /dev/null +++ b/docs/原型设计/1.3.法规完整性检查页原型设计.md @@ -0,0 +1,123 @@ +# 法规完整性检查页原型设计 + +## 1. 页面目标 + +对照 NMPA 法规要求,展示当前资料包的齐套性、错放情况、法规依据、风险等级和处理建议,让用户知道“缺了什么、为什么缺、依据是什么”。 + +## 2. 适用角色 + +- 注册申报负责人 +- 法规专员 +- 质控复核人员 + +## 3. 页面布局分区 + +推荐采用“三栏 + 底部证据表”布局: + +- 左栏:法规目录树与章节范围 +- 中栏:缺失项 / 错放项主列表 +- 右栏:法规依据和风险摘要 +- 底部:证据与建议表 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 法规目录树 + +展示: + +- `CH1 ~ CH6` +- 已匹配数量 +- 缺失数量 +- 待复核数量 + +### 4.2 问题列表 + +分标签展示: + +- 缺失项 +- 错放项 +- 疑似提供 +- 待人工复核 + +每条记录展示: + +- 章节 +- 资料名称 +- 当前状态 +- 风险等级 +- 命中文档或未命中说明 + +### 4.3 法规依据舱 + +展示: + +- 规则包名称 +- 规则版本 +- 法规原文来源 +- 证据片段 +- 适用流程 + +### 4.4 处理建议表 + +列建议: + +- 问题类型 +- 问题说明 +- 法规依据 +- 风险等级 +- 建议动作 +- 责任角色 + +## 5. 关键字段定义 + +页面主要消费 `registration_completeness_report`。 + +关键字段: + +- `required_item_count` +- `provided_item_count` +- `missing_item_count` +- `suspected_item_count` +- `misplaced_item_count` +- `manual_review_item_count` +- `highest_risk_level` +- `pass_status` +- `missing_items[]` +- `misplaced_items[]` +- `manual_review_items[]` +- `evidence_refs[]` +- `suggestions[]` + +## 6. 关键交互 + +- 点击目录树章节,筛选中部问题列表。 +- 点击缺失项,右侧法规依据自动切换。 +- 点击“查看证据片段”,展开 RAG 命中内容。 +- 点击“进入字段抽取”,继续主线。 + +## 7. 与上下游页面的数据关系 + +上游:消费 `registration_overview_report`。 + +下游: + +- 风险预警页复用完整性结论。 +- 飞书通知页可引用完整性问题摘要。 +- 治理台中的法规规则包和 RAG 文档源由本页进入最自然。 + +## 8. 演示话术重点 + +- 强调完整性判断由结构化规则决定,不由大模型自由发挥。 +- 强调 RAG 的职责是给证据,不是当裁判。 +- 强调风险等级和责任角色已经提前结构化,便于协同。 + +## 9. 与知识库 / 治理台的关联入口 + +本页应提供: + +- `查看规则包` +- `查看法规原文切片` +- `新增法规来源` +- `编辑章节要求` + +所有操作进入治理台对应 CRUD 视图。 diff --git a/docs/原型设计/1.4.字段抽取与字段池页原型设计.md b/docs/原型设计/1.4.字段抽取与字段池页原型设计.md new file mode 100644 index 0000000..5493172 --- /dev/null +++ b/docs/原型设计/1.4.字段抽取与字段池页原型设计.md @@ -0,0 +1,124 @@ +# 字段抽取与字段池页原型设计 + +## 1. 页面目标 + +展示从说明书、申请表、产品列表等资料中抽取出的结构化字段,并把来源、置信度、标准值、待复核状态和是否可回填统一展示出来。 + +## 2. 适用角色 + +- 注册资料专员 +- 数据校对人员 +- 模板回填使用人 + +## 3. 页面布局分区 + +建议采用“顶部摘要 + 中部字段池表格 + 右侧来源证据抽屉”。 + +分区如下: + +- 顶部:字段抽取统计 +- 中部:字段池主表 +- 下方:待复核字段区 +- 右侧:字段来源详情抽屉 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 抽取摘要卡 + +展示: + +- 目标字段数量 +- 已抽取数量 +- 待复核字段数量 +- 冲突候选数量 +- 可回填字段数量 + +### 4.2 字段池主表 + +列建议: + +- 字段编码 +- 中文字段名 +- 标准值 +- 原文值 +- 来源文档 +- 来源位置 +- 抽取方式 +- 置信度 +- 冲突状态 +- 待复核状态 +- 是否可回填 + +### 4.3 待复核区 + +重点突出: + +- 低置信度字段 +- 长文本归纳字段 +- 来源不唯一字段 + +## 5. 关键字段定义 + +页面主要消费 `registration_field_extraction_report`。 + +关键字段: + +- `target_field_count` +- `extracted_field_count` +- `manual_review_field_count` +- `conflict_candidate_count` +- `field_pool_status` +- `field_pool_items[]` +- `manual_review_fields[]` +- `evidence_refs[]` + +字段池条目关键字段: + +- `field_key` +- `field_label` +- `standard_value` +- `raw_value` +- `source_document_name` +- `source_location` +- `extract_method` +- `confidence` +- `conflict_status` +- `manual_review_required` +- `fillable` + +## 6. 关键交互 + +- 支持按“全部 / 可回填 / 待复核 / 高置信度”切换。 +- 点击字段行打开来源详情。 +- 点击“查看原文片段”展开证据区。 +- 点击“标记推荐值”模拟人工确认。 +- 点击“进入一致性核查”继续主线。 + +## 7. 与上下游页面的数据关系 + +上游: + +- 来自资料导入页的文档主数据 +- 来自完整性检查页的前置校验状态 + +下游: + +- 一致性核查页直接使用字段池 +- Word 回填导出页使用可回填字段集 + +## 8. 演示话术重点 + +- 强调统一字段池是后续一致性核查和回填导出的中间事实层。 +- 强调固定字段优先规则抽取,长文本才交给 LLM 辅助归纳。 +- 强调每个字段都有来源,不是“模型猜你要什么”。 + +## 9. 与知识库 / 治理台的关联入口 + +本页应提供: + +- `维护字段 Schema` +- `维护字段来源优先级` +- `查看字段映射规则` +- `重跑抽取策略` + +这些入口接入治理台的字段 Schema 和模板映射 CRUD。 diff --git a/docs/原型设计/1.5.一致性核查页原型设计.md b/docs/原型设计/1.5.一致性核查页原型设计.md new file mode 100644 index 0000000..355d25c --- /dev/null +++ b/docs/原型设计/1.5.一致性核查页原型设计.md @@ -0,0 +1,113 @@ +# 一致性核查页原型设计 + +## 1. 页面目标 + +基于统一字段池,对同一审核范围内不同文档的关键字段做完全一致比对,清楚展示冲突字段、来源对比和混档风险。 + +## 2. 适用角色 + +- 注册资料负责人 +- 复核人员 +- 项目经理 + +## 3. 页面布局分区 + +建议采用“范围确认条 + 冲突主表 + 对比视图 + 风险侧栏”。 + +分区如下: + +- 顶部:审核范围确认条 +- 中部:冲突字段表 +- 下部:来源对比面板 +- 右侧:混档风险与建议 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 范围确认条 + +展示: + +- 当前批次 +- 已纳入文档数量 +- 排除法规资料说明 +- 是否存在疑似跨产品文档 + +### 4.2 冲突字段主表 + +列建议: + +- 字段名 +- 比对结果 +- 冲突值数量 +- 来源文档数 +- 最高风险等级 +- 是否疑似混档 + +### 4.3 来源对比面板 + +按选中字段展示: + +- 文档 A 值 +- 文档 B 值 +- 来源章节 +- 来源页码 +- 标准化结果 + +### 4.4 风险侧栏 + +展示: + +- 冲突字段总数 +- 混档告警数量 +- 待复核字段数 +- 建议处理动作 + +## 5. 关键字段定义 + +页面主要消费 `registration_consistency_report`。 + +关键字段: + +- `checked_field_count` +- `consistent_field_count` +- `conflict_field_count` +- `manual_review_field_count` +- `mixed_package_warning_count` +- `highest_risk_level` +- `pass_status` +- `conflict_fields[]` +- `manual_review_fields[]` +- `mixed_package_warnings[]` +- `suggestions[]` + +## 6. 关键交互 + +- 点击字段行,在下方切换来源对比视图。 +- 点击“仅看冲突字段”过滤表格。 +- 点击混档告警可跳到相关文档范围说明。 +- 点击“进入风险预警页”继续主线。 + +## 7. 与上下游页面的数据关系 + +上游:消费字段池。 + +下游: + +- 风险预警页复用冲突结论 +- Word 回填导出页依据冲突状态做拦截 + +## 8. 演示话术重点 + +- 强调一致性核查不重新抽取字段,只对字段事实做比对。 +- 强调系统默认严格一致规则,避免模糊通过。 +- 强调混档风险是当前业务场景的关键价值点。 + +## 9. 与知识库 / 治理台的关联入口 + +本页应提供: + +- `维护强一致字段规则` +- `查看审核范围配置` +- `查看混档识别规则` + +这些入口进入治理台的规则包和字段规则维护视图。 diff --git a/docs/原型设计/1.6.风险预警页原型设计.md b/docs/原型设计/1.6.风险预警页原型设计.md new file mode 100644 index 0000000..85a71fb --- /dev/null +++ b/docs/原型设计/1.6.风险预警页原型设计.md @@ -0,0 +1,110 @@ +# 风险预警页原型设计 + +## 1. 页面目标 + +把完整性、字段抽取和一致性核查的结果统一归并成综合风险清单,给出总风险等级、是否通过、整改建议和责任角色。 + +## 2. 适用角色 + +- 注册申报负责人 +- 项目经理 +- 业务主管 + +## 3. 页面布局分区 + +建议采用“总风险头图 + 风险矩阵 + 整改建议 + 责任分发区”。 + +分区如下: + +- 顶部:总风险等级与通过结论 +- 左侧:风险分布矩阵 +- 中部:风险清单 +- 右侧:责任角色与建议动作 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 总风险头图 + +展示: + +- 当前批次 +- 最高风险等级 +- 是否通过 +- 高 / 中 / 低风险数量 +- 待人工复核数量 + +### 4.2 风险清单表 + +列建议: + +- 风险类型 +- 风险等级 +- 问题描述 +- 来源报告 +- 关联文档 +- 整改建议 +- 责任角色 + +### 4.3 责任分发区 + +展示: + +- 注册资料负责人 +- 注册申报负责人 +- 临床注册负责人 + +并显示每个角色对应待处理风险数。 + +## 5. 关键字段定义 + +页面主要消费 `registration_risk_report`。 + +关键字段: + +- `risk_item_count` +- `high_risk_count` +- `medium_risk_count` +- `low_risk_count` +- `manual_review_count` +- `highest_risk_level` +- `pass_status` +- `risk_items[]` +- `manual_review_items[]` +- `suggestions[]` +- `owner_notifications[]` + +## 6. 关键交互 + +- 点击风险类型过滤清单。 +- 点击责任角色查看该角色负责的风险。 +- 点击“生成通知摘要”跳转飞书通知视图。 +- 点击“查看导出影响”跳转 Word 回填导出页。 + +## 7. 与上下游页面的数据关系 + +上游: + +- 完整性报告 +- 字段抽取报告 +- 一致性报告 + +下游: + +- Word 回填导出页引用是否通过和阻断项 +- 飞书通知视图引用责任人和风险摘要 + +## 8. 演示话术重点 + +- 强调整个系统不是只找问题,而是把问题归并成“可执行风险”。 +- 强调是否通过和责任角色已经直接结构化,可以进入实际协同。 +- 强调高风险会影响后续导出和通知动作。 + +## 9. 与知识库 / 治理台的关联入口 + +本页应提供: + +- `维护风险规则` +- `维护责任角色映射` +- `查看准入判定规则` + +这些入口进入治理台的风险规则和责任人映射 CRUD。 diff --git a/docs/原型设计/1.7.Word回填导出页原型设计.md b/docs/原型设计/1.7.Word回填导出页原型设计.md new file mode 100644 index 0000000..93e50d0 --- /dev/null +++ b/docs/原型设计/1.7.Word回填导出页原型设计.md @@ -0,0 +1,118 @@ +# Word回填导出页原型设计 + +## 1. 页面目标 + +展示字段如何回填到注册申报表格或对照清单中,并说明哪些字段已回填、哪些字段被风险或冲突拦截、当前导出状态如何以及用户从哪里下载文件。 + +## 2. 适用角色 + +- 注册资料专员 +- 表格整理人员 +- 审核结果使用人 + +## 3. 页面布局分区 + +建议采用“模板与导出状态头部 + 回填字段表 + 拦截项区 + 下载区”。 + +分区如下: + +- 顶部:模板选择与导出结论 +- 中部:回填字段表 +- 右侧:拦截项和版式校验 +- 底部:导出记录与下载入口 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 导出头部 + +展示: + +- 模板名称 +- 模板版本 +- 当前导出状态 +- 是否允许正式版 +- 是否允许草稿版 + +### 4.2 回填字段表 + +列建议: + +- 占位符 +- 字段名 +- 字段值 +- 来源 +- 回填状态 +- 是否必填 + +### 4.3 拦截项区 + +展示: + +- 冲突字段拦截 +- 高风险拦截 +- 待复核字段拦截 +- 缺失必填字段拦截 + +### 4.4 导出记录区 + +展示: + +- 输出文件名 +- 输出版本 +- 导出时间 +- 版式校验结果 +- 下载入口 + +## 5. 关键字段定义 + +页面主要消费 `registration_word_export_report`。 + +关键字段: + +- `template_id` +- `export_status` +- `fillable_field_count` +- `filled_field_count` +- `blocked_field_count` +- `manual_review_field_count` +- `layout_check_status` +- `filled_fields[]` +- `blocked_fields[]` +- `output_file` + +## 6. 关键交互 + +- 点击模板下拉模拟切换模板。 +- 点击“生成草稿”切换导出状态。 +- 点击“尝试生成正式版”时展示阻断提示。 +- 点击某个拦截项,可查看其来源风险。 +- 点击下载按钮,展示 mock 下载反馈。 + +## 7. 与上下游页面的数据关系 + +上游: + +- 字段池 +- 一致性核查报告 +- 风险预警报告 + +下游: + +- 飞书通知页可引用“已生成草稿”或“正式导出被阻断”的状态 + +## 8. 演示话术重点 + +- 强调平台不仅能抽取字段,还能进入真正的交付动作。 +- 强调高风险不会被忽略,系统会阻止直接生成正式报送文件。 +- 强调模板、字段映射、拦截条件都可治理,不写死在 Prompt 里。 + +## 9. 与知识库 / 治理台的关联入口 + +本页应提供: + +- `维护 Word 模板` +- `维护字段映射` +- `查看导出版式校验规则` +- `查看导出记录` + +这些入口进入治理台的模板与映射 CRUD。 diff --git a/docs/原型设计/1.8.飞书通知视图原型设计.md b/docs/原型设计/1.8.飞书通知视图原型设计.md new file mode 100644 index 0000000..cb6e397 --- /dev/null +++ b/docs/原型设计/1.8.飞书通知视图原型设计.md @@ -0,0 +1,104 @@ +# 飞书通知视图原型设计 + +## 1. 页面目标 + +把风险预警和导出状态转成一张可发送的飞书消息卡片,展示责任人 `@`、消息摘要、Web 详情链接和发送回执,形成工作台外部协同闭环。 + +## 2. 适用角色 + +- 注册申报负责人 +- 协同群聊成员 +- 演示讲解人 + +## 3. 页面布局分区 + +建议采用“双栏布局”: + +- 左侧:飞书消息卡片预览 +- 右侧:通知配置与发送回执 + +底部补一条 Web 详情页入口说明。 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 飞书消息卡片预览 + +展示: + +- 批次编号 +- 风险摘要 +- 是否通过 +- 责任人 `@` +- 关键风险条目 +- Web 详情按钮 + +### 4.2 通知配置区 + +展示: + +- 触发来源 +- 飞书群聊 ID +- 消息类型 +- 是否包含责任人通知 +- 是否附带 Web 链接 + +### 4.3 发送回执区 + +展示: + +- 发送状态 +- 消息 ID +- 发送时间 +- 失败原因 + +## 5. 关键字段定义 + +页面主要消费 `feishu_notification_report`。 + +关键字段: + +- `send_status` +- `message_type` +- `mentioned_users[]` +- `web_detail_url` +- `receipt.message_id` +- `receipt.sent_at` + +同时复用风险页中的: + +- `highest_risk_level` +- `pass_status` +- `owner_notifications[]` + +## 6. 关键交互 + +- 点击“切换卡片样式”模拟不同消息模板。 +- 点击“发送通知”切换为已发送状态。 +- 点击责任人标签,查看角色映射详情。 +- 点击 Web 详情按钮,跳转到 mock 审计详情链接。 + +## 7. 与上下游页面的数据关系 + +上游: + +- 风险预警页提供责任角色和风险摘要 +- Word 回填导出页提供导出状态 + +下游:无,属于主线收尾页。 + +## 8. 演示话术重点 + +- 强调平台不止有 Web 界面,还有飞书协同入口。 +- 强调系统可以把风险结果直接转换成责任人可执行的通知载荷。 +- 强调通知里保留 Web 详情链接,便于追溯。 + +## 9. 与知识库 / 治理台的关联入口 + +本页应提供: + +- `维护责任人映射` +- `维护飞书机器人配置` +- `维护消息模板` +- `查看发送日志` + +这些入口进入治理台中的责任人映射和飞书通知配置 CRUD。 diff --git a/docs/原型设计/1.9.知识库与治理台原型设计.md b/docs/原型设计/1.9.知识库与治理台原型设计.md new file mode 100644 index 0000000..8657aaa --- /dev/null +++ b/docs/原型设计/1.9.知识库与治理台原型设计.md @@ -0,0 +1,222 @@ +# 知识库与治理台原型设计 + +## 1. 页面目标 + +作为整套原型的治理能力承载层,统一展示法规知识、RAG 证据、字段标准、模板映射、责任人和飞书配置如何被维护,并明确支持完整 CRUD。 + +本页在 HTML 中不独立占据主导航,而是以“治理台抽屉 / 配置弹窗 / 详情侧栏”的形式从各业务页面打开。 + +## 2. 适用角色 + +- 规则维护人员 +- 平台管理员 +- 注册资料平台主管 +- 演示讲解人 + +## 3. 治理台布局分区 + +建议采用“左侧治理对象导航 + 中部列表 + 右侧详情 / 编辑抽屉”的结构。 + +左侧对象导航固定包含: + +1. 法规规则包 +2. RAG 文档源 +3. RAG 切片 +4. 字段 Schema +5. Word 模板与字段映射 +6. 责任人映射 +7. 飞书通知配置 + +## 4. 法规规则包 CRUD + +### 4.1 列表字段 + +- 规则包名称 +- 适用流程 +- 版本号 +- 启用状态 +- 最近更新时间 +- 维护人 + +### 4.2 必备操作 + +- 新增规则包 +- 编辑规则包 +- 复制新版本 +- 启用 / 停用 +- 删除未生效草稿 +- 查看章节要求详情 + +### 4.3 原型交互要求 + +- 点击规则包行,右侧打开章节树与要求项详情。 +- 点击“新增规则包”,打开表单弹窗。 + +## 5. RAG 文档源 CRUD + +### 5.1 列表字段 + +- 文档名称 +- 文档类型 +- 来源类别 +- 版本号 +- 入库状态 +- 切片数量 +- 最近同步时间 + +### 5.2 必备操作 + +- 上传新文档源 +- 替换版本 +- 编辑元数据 +- 停用文档源 +- 删除失效文档源 +- 重新入库 + +### 5.3 原型交互要求 + +- 支持按“法规 / 模板 / 业务资料”过滤。 +- 点击文档源查看切片预览和召回配置。 + +## 6. RAG 切片 CRUD + +### 6.1 列表字段 + +- 切片 ID +- 所属文档 +- 章节 +- 片段摘要 +- 切片长度 +- 召回状态 +- 最近更新时间 + +### 6.2 必备操作 + +- 新增手工切片 +- 编辑切片摘要 +- 合并切片 +- 拆分切片 +- 删除切片 +- 重建向量 +- 调整召回阈值 + +### 6.3 原型交互要求 + +- 点击切片行,右侧展示原文预览和命中场景。 +- 支持“查看证据命中历史”的详情抽屉。 + +## 7. 字段 Schema CRUD + +### 7.1 列表字段 + +- 字段编码 +- 中文名 +- 字段类型 +- 是否可回填 +- 是否强一致 +- 启用状态 +- 版本号 + +### 7.2 必备操作 + +- 新增字段 +- 编辑字段 +- 启停字段 +- 删除草稿字段 +- 复制 schema 版本 + +### 7.3 原型交互要求 + +- 点击字段查看来源优先级和适用页面。 +- 支持切换“回填字段 / 强一致字段 / 全部字段”。 + +## 8. Word 模板与字段映射 CRUD + +### 8.1 列表字段 + +- 模板名称 +- 输出类型 +- 版本号 +- 占位符数量 +- 启用状态 +- 最近更新时间 + +### 8.2 必备操作 + +- 上传模板 +- 编辑模板元数据 +- 编辑占位符映射 +- 启用 / 停用版本 +- 删除未发布版本 +- 预览模板 + +### 8.3 原型交互要求 + +- 点击模板打开占位符和字段映射详情。 +- 支持查看“阻断条件影响哪些占位符”。 + +## 9. 责任人映射 CRUD + +### 9.1 列表字段 + +- 映射类型 +- 章节 / 风险类型 +- 责任角色 +- 飞书用户 ID +- 启用状态 +- 备注 + +### 9.2 必备操作 + +- 新增映射 +- 编辑映射 +- 启停映射 +- 删除映射 +- 批量导入映射 + +### 9.3 原型交互要求 + +- 点击某条映射可联动查看受影响风险项或飞书卡片预览。 + +## 10. 飞书通知配置 CRUD + +### 10.1 列表字段 + +- 配置名称 +- 群聊 / 机器人标识 +- 消息模板 +- Web 链接模板 +- 启用状态 +- 最近测试状态 + +### 10.2 必备操作 + +- 新增配置 +- 编辑配置 +- 切换消息模板 +- 启用 / 停用 +- 删除草稿配置 +- 发送测试消息 + +### 10.3 原型交互要求 + +- 支持查看 interactive card 模板预览。 +- 支持查看最近一次回执记录。 + +## 11. 与业务页面的入口关系 + +各主页面的治理入口分配如下: + +- 资料包导入页:RAG 文档源、章节点规则 +- 法规完整性检查页:法规规则包、RAG 切片 +- 字段抽取页:字段 Schema、字段来源优先级 +- 一致性核查页:强一致规则 +- 风险预警页:风险规则、责任人映射 +- Word 回填页:模板与字段映射 +- 飞书通知视图:责任人映射、飞书通知配置 + +## 12. 演示话术重点 + +- 强调这套系统不是一次性写死,而是可以被维护和演进。 +- 强调法规判断、RAG 证据、字段标准、模板映射和飞书配置都能被可视化治理。 +- 强调 CRUD 的存在,说明平台具备从 Demo 走向实际业务平台的治理基础。 diff --git a/docs/原型设计/1.整体原型设计.md b/docs/原型设计/1.整体原型设计.md new file mode 100644 index 0000000..af53e5b --- /dev/null +++ b/docs/原型设计/1.整体原型设计.md @@ -0,0 +1,231 @@ +# 注册审核平台整体原型设计 + +## 1. 产品定位与演示目标 + +本轮原型面向: + +```text +试剂盒临床注册文件准备与审核智能体平台 +``` + +原型不强调“通用 Agent 工具箱”,而是围绕 NMPA 体外诊断试剂注册申报资料场景,展示一条可讲解、可追溯、可协同的审核闭环。 + +本轮演示目标: + +1. 让评委在 1 分钟内理解平台解决什么问题。 +2. 让业务人员看到资料包导入、法规核查、字段抽取、一致性核查、风险预警、Word 回填、飞书协同的完整链路。 +3. 让技术评委看到系统具备规则优先、RAG 证据解释、结构化输出和治理后台能力。 +4. 为后续 Django 页面重构或前端实现提供可直接照做的页面规格。 + +## 2. 演示总动线 + +推荐演示顺序: + +1. 从“审核任务工作台”进入,先看 7 个流程任务卡片和当前批次状态。 +2. 跳到“资料包导入页”,解释资料包、目录、页数和章节点识别。 +3. 进入“法规完整性检查页”,展示缺失项、错放项和法规依据。 +4. 进入“字段抽取与字段池页”,展示统一字段池、置信度和待复核字段。 +5. 进入“一致性核查页”,展示字段冲突和混档风险。 +6. 进入“风险预警页”,说明总风险等级、是否通过、整改建议和责任角色。 +7. 进入“Word 回填导出页”,说明自动回填、导出拦截和下载入口。 +8. 最后展示“飞书通知视图”,形成协同闭环。 + +知识库与治理台不作为独立主线页面插入,而是作为上述页面的配置入口、侧边抽屉或管理弹层出现,用来回答“规则从哪里来、谁来维护、如何增删改查”。 + +## 3. 统一视觉风格 + +### 3.1 视觉关键词 + +- 监管科技 +- 专业可信 +- 高信息密度 +- 可解释工作台 +- 演示友好 + +### 3.2 色彩建议 + +- 主背景:浅灰蓝与米白渐变,形成轻量但不空泛的工作台底色。 +- 主强调色:深青蓝,用于导航、主按钮、激活态和重点数值。 +- 风险色:铜橙、深红,用于缺失、冲突、高风险、阻断状态。 +- 成功色:低饱和绿色,用于完成、可通过、已同步状态。 +- 中性色:冷灰,用于说明文字、边框、标签和禁用态。 + +### 3.3 组件风格 + +- 使用“带状布局 + 信息舱 + 分析表格”的组合,不做普通后台卡片堆砌。 +- 表格、目录树、证据侧栏、步骤时间线是核心表达方式。 +- 高风险结论必须同时展示证据来源和责任角色,避免只有颜色没有解释。 + +## 4. 统一交互规范 + +### 4.1 全局导航 + +- 顶部固定展示:平台名称、当前批次、产品名称、流程类型、全局风险状态。 +- 左侧流程导航固定展示 8 个主页面入口。 +- 每个页面右上角保留“打开治理台”入口。 + +### 4.2 统一交互规则 + +- 所有结果页都支持“查看来源证据”。 +- 所有关键对象都支持“打开详情抽屉”。 +- 所有治理对象都遵循“列表 -> 详情 -> 新增 / 编辑 / 启停 / 删除”的统一 CRUD 结构。 +- 风险阻断项必须在 Word 导出页和飞书通知视图里继续可见,保证前后呼应。 + +### 4.3 状态规范 + +统一状态口径: + +- `待导入` +- `处理中` +- `已完成` +- `待复核` +- `已阻断` +- `已发送` +- `失败` + +统一风险口径: + +- `高` +- `中` +- `低` +- `待确认` + +## 5. 统一 Mock 数据口径 + +本轮所有文档和 HTML 共用同一组演示数据,避免页面间口径冲突。 + +### 5.1 批次口径 + +- `batch_id`: `SUB-20260603-001` +- `workflow_type`: `registration` +- `product_name`: `新型冠状病毒 2019-nCoV 核酸检测试剂盒` +- `applicant_name`: `示例生物科技(上海)有限公司` +- `chapter_scope`: `CH1 ~ CH6` + +### 5.2 主线风险口径 + +固定演示问题: + +1. `CH1.11.4` 缺少一份必交声明类资料。 +2. 一份沟通记录疑似错放到 `CH1.9` 目录。 +3. 说明书与申请表中的产品名称存在文本不一致。 +4. 储存条件字段存在待人工复核状态。 +5. 风险等级为高,当前批次不允许正式导出,仅允许生成草稿。 +6. 飞书通知需要 `@注册资料负责人` 和 `@注册申报负责人`。 + +### 5.3 共用对象定义 + +文档和 HTML 共用以下结构化对象名称: + +- `registration_overview_report` +- `registration_completeness_report` +- `registration_field_extraction_report` +- `registration_consistency_report` +- `registration_risk_report` +- `registration_word_export_report` +- `feishu_notification_report` + +治理台对象: + +- `knowledge_rule_package` +- `rag_source_document` +- `rag_chunk_item` +- `field_schema_item` +- `template_mapping_item` +- `owner_mapping_item` +- `feishu_channel_config` + +## 6. 页面跳转关系 + +主页面跳转关系如下: + +```text +审核任务工作台 + -> 资料包导入页 + -> 法规完整性检查页 + -> 字段抽取与字段池页 + -> 一致性核查页 + -> 风险预警页 + -> Word 回填导出页 + -> 飞书通知视图 +``` + +跨页关系约束: + +- 资料包导入页产出 `registration_overview_report`。 +- 法规完整性检查页消费 `registration_overview_report`,产出 `registration_completeness_report`。 +- 字段抽取与字段池页消费导入结果和完整性结果,产出 `registration_field_extraction_report`。 +- 一致性核查页消费字段池,产出 `registration_consistency_report`。 +- 风险预警页消费前三类报告,产出 `registration_risk_report`。 +- Word 回填导出页消费字段池、一致性和风险报告,产出 `registration_word_export_report`。 +- 飞书通知视图消费风险报告和导出报告,产出 `feishu_notification_report`。 + +## 7. HTML 演示站说明 + +### 7.1 交付方式 + +交付一个单文件 HTML: + +`docs/原型设计/registration-prototype-demo.html` + +该文件仅展示 mock 内容,不接真实 Django 路由,不调用真实接口。 + +### 7.2 HTML 结构要求 + +- 一个全局 App Shell +- 八个主页面 section +- 一个治理台抽屉层 +- 一份统一 mock 数据对象 +- 一组轻量 JavaScript 交互 + +### 7.3 必备交互 + +- 切换 8 个页面视图 +- 展开 / 收起目录树 +- 切换流程任务卡片选中态 +- 打开治理台抽屉 +- 切换治理对象 CRUD 子视图 +- 模拟 Word 导出状态切换 +- 模拟飞书消息卡片预览 + +## 8. 文档拆分说明 + +本轮分页文档如下: + +1. [1.1.资料包导入页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.1.资料包导入页原型设计.md) +2. [1.2.审核任务工作台原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.2.审核任务工作台原型设计.md) +3. [1.3.法规完整性检查页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.3.法规完整性检查页原型设计.md) +4. [1.4.字段抽取与字段池页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.4.字段抽取与字段池页原型设计.md) +5. [1.5.一致性核查页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.5.一致性核查页原型设计.md) +6. [1.6.风险预警页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.6.风险预警页原型设计.md) +7. [1.7.Word回填导出页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.7.Word回填导出页原型设计.md) +8. [1.8.飞书通知视图原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.8.飞书通知视图原型设计.md) +9. [1.9.知识库与治理台原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.9.知识库与治理台原型设计.md) + +## 9. 实现边界 + +本轮原型只解决: + +1. 演示表达 +2. 页面结构 +3. 模块关系 +4. 数据口径 +5. 治理台 CRUD 展示 + +本轮原型不直接承诺: + +1. 后端真实接口联调 +2. Django 模板替换 +3. 真实 RAG 召回 +4. 真实 Word 文件生成 +5. 真实飞书 OpenAPI 调用 + +## 10. 结论 + +这套原型的核心讲法应统一为: + +```text +资料包治理 -> 法规完整性核查 -> 字段池沉淀 -> 一致性检查 -> 风险预警 -> Word 回填导出 -> 飞书协同闭环 +``` + +治理台负责回答“规则和知识如何维护”,工作台负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。