docs(原型设计): 补充注册审核平台分页原型方案
This commit is contained in:
231
docs/原型设计/1.整体原型设计.md
Normal file
231
docs/原型设计/1.整体原型设计.md
Normal file
@@ -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 回填导出 -> 飞书协同闭环
|
||||
```
|
||||
|
||||
治理台负责回答“规则和知识如何维护”，工作台负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。
|
||||
Reference in New Issue
Block a user