安阳县直医院学生体检信息化管理系统功能明细

1.1 系统定位

本系统面向医院组织实施的学生健康体检业务，以体检批次和学生体检编号为主线， 将学校、年级、班级、学生档案、特殊人群、导检单、医生项目权限、现场设备采集、 复测质控、报告生成、家长查询、数据导出和日志审计纳入统一业务平台。

1.2 能力概况

3.1 角色分类

3.2 医生项目权限跳转机制

4.1 标准业务步骤

1. 总后台维护学校、年级、班级和体检项目基础资料。
2. 新增学生档案或通过 Excel 批量导入在校学生、初升高毕业生和散检人员；系统记录导入批次、成功明细和失败原因。
3. 创建体检批次，设置体检类型、日期、项目范围、报告开放和 AI 健康提示规则。
4. 将学生加入批次，系统生成体检编号、导检单编号和导检单识别凭证。
5. 总后台单个或批量打印导检单；二维码仅承载可校验识别凭证，不直接写入敏感身份信息。
6. 后台配置医生项目权限，并根据现场工位分配欧姆龙血压计或 Topcon RM-1 屈光仪。
7. 医生在小程序工作台完成设备连接；设备身份、绑定关系和当前连接状态同步到系统。
8. 医生扫描导检单，后端校验账号、批次、学生、项目权限和项目完成状态。
9. 系统进入授权项目采集页，设备项目自动接收数据；设备异常时可使用手动录入兜底。
10. 首次提交形成体检记录和测量明细；再次提交要求填写复测原因，并保留历史测量。
11. 复核质控端处理异常数据、复测结果、AI健康提示、报告开放和明文导出申请。
12. 报告任务生成个人报告，AI任务按队列逐条生成健康提示；完成复核后开放家长查询。
13. 家长通过导检单二维码或小程序查询入口完成身份验证，查看已开放报告和防伪信息。
14. 后台按批次、学校、年级、班级、学生、项目和状态筛选统计并规范化导出。

5.16 列表筛选检索与查询后导出

5.17 特殊人群处理规则

6.1 小程序首页与未登录状态

6.2 医生登录与账号找回

• 医生在小程序体检模块内先采用账号密码登录，暂不建设手机号验证码登录。
• 医生账号同时支持小程序端登录和网页端医生后台登录。
• 登录后展示医生姓名、所属机构、负责项目、今日采集人数。
• 登录态与后端权限绑定，接口请求必须携带医生身份凭证。
• 医生忘记账号或密码时，可通过医生姓名和身份证号码找回账号或重置密码，找回过程需记录操作日志。
• 所有账号密码按当前需求采用 MD5 散列存储，并预留后续升级为更安全密码算法的字段空间。

• 工作台显示医生姓名、授权体检项目、今日采集数量和项目完成情况。
• 显示身高体重秤、欧姆龙血压计和 Topcon RM-1 屈光仪的真实连接状态，不以“扫描到设备”代替“已连接”。
• 未连接设备显示连接入口，分别进入身高体重秤、欧姆龙血压计和屈光仪设备页面。
• 已登记设备保存设备身份；同一小程序运行会话内保持连接，重新进入采集页可直接复用，冷启动后按登记信息自动重连。
• 欧姆龙支持单工位和 A/B 双工位；屈光仪支持医生首次配对自动绑定和后台预分配两种方式。

6.3 医生工作台与设备中心

6.4 扫码体检

• 调用小程序扫码能力识别导检单二维码。
• 后端校验二维码 token、学生状态、批次状态和医生权限。
• 扫码后展示学生基础信息核验字段：学校名称、年级、班级、学籍号、姓名、性别、出生日期。
• 根据医生项目权限进入对应体检项目采集页面；若医生拥有多个项目权限，则进入学生项目入口页后选择采集项目。

6.5 基础信息与体检项目字段

6.5.1 学生基础信息核验字段

6.5.2 既往重要病史

6.5.3 眼科与屈光检查项（统一归入眼科）

6.5.4 常规体检项目

6.5.5 结核分枝杆菌感染检测

7.1 设备接入总览

7.2 设备连接与状态管理通用规则

• 医生工作台显示设备真实连接状态、绑定状态和设备入口。
• “已登记”表示设备身份已保存，“已连接”表示当前小程序进程已建立连接并完成数据订阅，两者分开判断。
• 设备连接成功后保存设备名称、设备标识、服务特征、医院设备编号和最后验证时间。
• 同一小程序运行会话内在设备页、医生工作台和采集页之间切换时复用连接；冷启动后按已登记身份重新连接。
• 设备采集失败时允许手动录入，但必须保存采集方式、设备状态、操作人和必要备注。

7.3 欧姆龙 J735 血压计

7.4 身高体重秤

7.5 Topcon RM-1 屈光仪接入

7.5.1 硬件与通信参数

7.5.2 医生配对、设备登记与独占绑定

1. 医生账号必须具备“眼科（含屈光）”项目权限。
2. 医生进入屈光仪设备页，搜索附近 BT578V2；系统按设备名称、IRXON/BT578、FFE0/FFE1 广播信息和信号强度排序。
3. 选择设备后先连接 BLE，再遍历服务和特征值；只有确认 FFE1 支持 Notify/Indicate 后才认定为有效屈光仪模块。
4. 小程序将蓝牙名称、DeviceId、服务 UUID、特征 UUID 和终端标识提交后端确认。
5. 后端优先匹配后台已建立的设备台账；首次出现的新模块可自动登记，并生成 RF-xxxx 医院内部设备编号。
6. 一套 Topcon RM-1 + BT578V2 只允许绑定一个医生账号；一个医生眼科工位只保留一个 REF 屈光仪绑定。
7. 已被其他医生占用、后台停用或与当前预分配设备不一致的模块，系统拒绝连接并写入审计日志。
8. 管理员可在后台预分配、解除绑定、停用设备或维护主机序列号、蓝牙名称、DeviceId 和备注。

7.5.3 连接保持与自动重连

• 首次配对成功后，本机保存设备身份、服务特征和后台设备编号。
• 同一小程序进程内从设备页返回工作台或进入眼科页面时，不主动关闭 BLE 连接，持续保持 FFE1 通知订阅。
• 小程序冷启动后不会把历史缓存误判为当前已连接，而是重新建立 BLE 连接并再次订阅 FFE1。
• 眼科页面加载时自动尝试连接已绑定屈光仪；直连失败后自动扫描并优先匹配已登记的 DeviceId 或蓝牙名称。
• 连接完成后持续监听串口数据，不需要医生在小程序中点击“读取数据”按钮。

7.5.4 首次测量自动接收与串口分包处理

• BT578V2 通过 FFE1 Notify 主动推送 RM-1 串口数据，程序不主动读取特征缓存，避免把历史数据误认为当前学生结果。
• 接收层支持 BLE 多包拼接；遇到 ETX/EOT 结束符立即成帧，没有结束符时按约 900 毫秒无新数据完成一帧。
• 支持 RM-1 将右眼和左眼拆分为两个串口帧的情况，在 30 秒窗口内自动合并左右眼结果。
• 支持 R/L 眼别后纵向输出 S、C、A，支持带 S/C/A 标签、同一行左右眼、固定宽度 ASCII、JSON 和 XML 等格式。
• 只有左右眼 S/C/A 完整且解析可信度达到安全阈值时才自动填写；低可信度数据保留为诊断信息，不写入医疗结果。
• 系统使用测量指纹去重，避免同一组结果被蓝牙重复通知后重复填入。
• 开始新学生、作废重测或断开连接时清理接收缓冲和左右眼临时合并状态，防止上一名学生数据串入。

7.5.5 眼科页面采集规则

7.5.6 异常处理与现场诊断

• 未搜索到设备：检查 BT578V2 供电、蓝灯状态、手机蓝牙和微信位置/蓝牙权限。
• 发现多台设备：设备页显示候选列表，由医生选择当前 RM-1 配套模块；已绑定设备优先匹配。
• 找不到 FFE1：系统不保存候选设备身份，并提示该模块未提供 BT578V2 串口透传特征。
• 连接断开：眼科页面显示断开状态，可按已登记设备重新连接。
• 收到数据但无法识别：保留可见文本和 HEX 原始报文，支持一键复制诊断数据，不自动写入结果。
• 设备已被其他医生绑定：后端拒绝连接，需由管理员在“屈光仪设备分配”中核对或解除原绑定。

7.5.7 后台设备台账

• 一条设备记录表示一台 Topcon RM-1 与一只 IRXON BT578V2 的固定配套关系。
• 展示医院编号、主机型号和序列号、蓝牙名称、DeviceId、当前医生、账号、状态和最后连接时间。
• 支持新增配套设备、维护资料、分配眼科医生、解除绑定和停用设备。
• 医生端首次配对、连接冲突、后台分配、解除和资料变更均写入审计日志。

8.1 复测记录机制

8.2 血压复测

• 血压结果异常、体动、不规则脉搏、袖带异常、房颤提示或现场医生判断需要复核时，可重新测量。
• 单工位和双工位均保留设备工位、插件设备身份、收缩压、舒张压、脉搏和异常标识。
• 已有体检记录再次提交时，复测备注输入框必须填写，后端再次校验。

8.3 眼科屈光作废重测

• 设备自动写入或医生手动修改后，当前屈光结果进入锁定状态，防止后续串口数据覆盖。
• 医生点击“作废本次屈光结果，重新测量”，确认后清空本次未提交的左右眼 S/C/A。
• 系统同步清除蓝牙接收缓冲、左右眼临时结果、测量指纹和上一帧诊断数据，立即恢复自动监听。
• 已提交记录进行复测时，新的屈光结果作为复测记录保存，并要求填写复测原因。

8.4 复核质控

• 复核质控端和总后台可查看异常体检结果、复测记录、最终采用值、AI健康提示、报告开放和导出申请。
• 处理结果包括通过、驳回、退回修改、标记复测和确认最终采用值。
• 每次复核保存复核人、时间、意见、业务对象、前后状态和操作日志。
• 体检结果或采用值变化后，关联报告进入重新生成或版本更新流程。

9.1 学生个人报告

9.2 腾讯云 TokenHub Hy3 配置

• 后台配置 AI 供应商、Chat API 地址、API Key、Key名称/ID和模型名称，现行模型为 Hy3。
• 可配置连接超时、总超时、最大输出 Token、温度、自动重试次数和规则健康提示回退。
• 后台直接维护“AI健康提示词”正文和“自定义表达要求”，程序固定附加医疗安全、隐私保护和禁止诊断规则。
• 支持保存配置、保存并测试、仅测试已保存配置，并记录连接测试返回、HTTP状态、请求ID和Token用量。
• TokenHub 未配置、调用失败或重试耗尽时，可自动回退到本地规则健康提示，避免报告流程整体阻塞。

9.3 AI任务队列

• 每份报告建立独立 AI 任务，记录任务类型、目标报告、模型、状态、返回内容、失败原因和重试次数。
• 任务按顺序逐条处理，每次只锁定并执行一条，防止重复调用和并发冲突。
• 宝塔计划任务调用 /corn/process_ai_task.php，持续处理待处理任务。
• AI任务页面筛选条件与报告管理保持一致，并可按任务状态、模型和失败原因进一步查询。
• 批次配置要求人工复核时，AI成功结果进入待复核状态；复核通过后写入报告健康提示。

9.4 去标识化和医疗安全规则

• 发送给 TokenHub 的数据不包含姓名、学校、班级、学籍号、证件号、手机号、医生姓名和设备原始报文。
• AI仅根据必要体检指标生成健康教育提示，不修改体检数值、异常标识或医生结论。
• 输出不得形成疾病诊断、用药方案或替代医生判断的表述。
• 报告固定显示健康提示免责声明。

10.1 查看方式一：扫码导检单二维码直达

1. 家长使用微信扫描学生导检单二维码。
2. 小程序直达该学生的报告验证页面。
3. 系统要求补充或确认学生信息，防止二维码被他人直接查看。
4. 验证通过后展示学生体检报告。
5. 家长可查看体检结果、健康提示和报告说明。
6. 支持保存或导出报告。

10.2 查看方式二：普通打开小程序后查询

10.3 访问控制

• 报告未审核或未开放时，家长不能查看。
• 二维码 token 不应直接包含身份证号、手机号等敏感信息。
• 查询验证不使用“证件号后四位”；在校学生可使用学校、年级、班级、姓名、性别、出生日期组合验证，初升高毕业生和散检人员使用体检编号/导检单编号、姓名、性别、出生日期组合验证。
• 当姓名和出生日期匹配到多名学生时，系统提示补充性别、体检编号、学校或其他辅助信息，不直接展示报告。
• 验证失败次数过多时，系统进行临时限制。
• 家长查看报告的时间、IP、验证结果应记录日志。

11.1 全流程数据脱敏机制

11.2 三维日志审计体系

日志字段建议

• 操作人ID、操作人姓名、角色、所属机构。
• 操作类型、业务对象、学校、体检批次、学生体检号、体检项目。
• 修改前数据、修改后数据、修改原因。
• IP地址、终端信息、设备信息、请求编号、操作时间。
• 风险等级、处理状态、备注说明。

11.3 报告防伪溯源机制

11.4 基础安全要求

• 采用 HTTPS 进行接口访问。
• 后台账号、医生账号、复核质控账号均支持角色权限控制。
• 所有账号密码按当前需求采用 MD5 散列存储；数据库不保存明文密码。
• 医生端按体检项目授权访问。
• 家长查看报告需完成学生信息验证。
• 敏感导出、明文查看、报告重新生成等操作需记录日志。
• 系统定期备份数据库和报告文件。

11.5 简化落地建议

12.1 导出类型

12.2 统计维度

• 按学生类型、学校、年级、班级统计体检完成率；支持单独统计初升高毕业生、散检人员等特殊人群。
• 按项目统计完成数量、异常数量和复测数量。
• 按设备统计采集成功率和手动录入比例。
• 按批次统计报告生成数量、已开放数量、家长查看数量。
• 按 AI 任务统计生成中、生成成功、生成失败、待复核、已复核数量。

• 学校、年级、班级、学生档案、体检记录、复测记录、报告等列表按当前筛选条件导出，不导出未命中的数据。
• 导出文件包含正式标题、导出条件、导出时间、字段表头、适当列宽、边框、冻结表头和统一日期/数值格式。
• 学校、年级、班级等基础档案页面的导出与页面搜索条件保持一致。
• 体检编号、导检单编号、报告编号等标识字段按文本格式导出，避免 Excel 自动转科学计数法。

12.3 查询结果导出规范

12.4 明文导出复核

• 医院最终导出 Excel 暂无固定模板，由系统按规范字段顺序生成。
• 不需要按教育局、卫健委或第三方平台格式上报。
• 字段名称、字段顺序、单位格式由系统开发时统一规范，数据表字段注释需完善。
• 明文导出审批由复核质控医生在网页复核质控端复核，总后台也可按权限执行复核。

14.1 微信小程序前端

14.2 后端与数据库