DEMO-AGENT/docs/原型设计/1.整体原型设计.md

注册审核平台整体原型设计

1. 产品定位与演示目标

本轮原型面向：

试剂盒临床注册文件准备与审核智能体平台

原型不强调“通用 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. 页面跳转关系

主页面跳转关系如下：

审核任务工作台
  -> 资料包导入页
  -> 法规完整性检查页
  -> 字段抽取与字段池页
  -> 一致性核查页
  -> 风险预警页
  -> 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.资料包导入页原型设计
2. 1.2.审核任务工作台原型设计
3. 1.3.法规完整性检查页原型设计
4. 1.4.字段抽取与字段池页原型设计
5. 1.5.一致性核查页原型设计
6. 1.6.风险预警页原型设计
7. 1.7.Word回填导出页原型设计
8. 1.8.飞书通知视图原型设计
9. 1.9.知识库与治理台原型设计

9. 实现边界

本轮原型只解决：

1. 演示表达
2. 页面结构
3. 模块关系
4. 数据口径
5. 治理台 CRUD 展示

本轮原型不直接承诺：

1. 后端真实接口联调
2. Django 模板替换
3. 真实 RAG 召回
4. 真实 Word 文件生成
5. 真实飞书 OpenAPI 调用

10. 结论

这套原型的核心讲法应统一为：

资料包治理 -> 法规完整性核查 -> 字段池沉淀 -> 一致性检查 -> 风险预警 -> Word 回填导出 -> 飞书协同闭环

治理台负责回答“规则和知识如何维护”，工作台负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。