微流控化学发光分析仪用户软件优化需求清单(2019-07-11 备注版)
概要
这是 2019 年 7 月微流控化学发光(CMIA)分析仪用户软件注册后优化阶段的需求/问题跟踪表(备注版),三方协作记录:医工所(仪器方/需求方)、Pactera 文思海辉(软件外包开发方)、国科均豪(可能的渠道/用户代表)。表格按软件模块 → 子页面组织,共约 105 条条目,字段包括:升级列表(问题描述)、反馈(责任方/状态)、备注、细节疑问、医工所备注、国科均豪备注、预计完成时间、进度追踪。
它是”中位机通信协议 → UI 指令 → 用户软件”需求链的顶层文档,与 微流控化学发光中位机通信协议-20190903机械臂速度版 和 UI 指令参数表互为对照。
软件模块结构
用户软件共 7 大模块:样本检测(样本登记/运行监控/结果报告)、试剂耗材(试剂管理/耗材管理)、质量控制(质控信息/质控数据)、校准(校准信息/校准结果/定标信息/定标结果)、系统设置(用户管理/LIS管理/日志管理/默认设置/关于软件)、其他。
关键需求与决策(按主题归纳)
样本登记
- 内部扫描/手持扫描选中时应禁用手动输入(当时仍可手动输入,判定为 bug)。
- “样本登记”页面去掉扫描到条码后的确认对话框,其他页面保留。
- 测试项目共 11 个;单个样本加多个孔(单样本多指标)未实现,可能需推翻重做样本登记。
- 新增末梢血样本类型;样本下降高度当前写死在 Z 轴下位机,软件未开放设置。
- 吸液高度语义修正:默认设置里磁珠/酶标/清洗液/底物的下降高度当前是 8 次总高度,需改为每次下降高度。
- 开始检测前需初始化流程且保证磁座 ON(已在流程配置文件开头增加)。
运行监控(光耦/温度监测策略是精华)
各传感器状态查询的时机约定(上位机与下位机的交互节奏):
| 监测项 | 查询时机 |
|---|---|
| 稀释杯架/样本架光耦 | 点击开始检测、初始化完成后加样前查询一次 |
| 废料仓光耦 | 每次抛 TIP 后查询一次 |
| 舱盖光耦 | 初始化完成后、开始加样前查询一次 |
| 温育仓温度 | 下位机每 10 秒主动回传一次,上位机判断正常/异常 |
| 试剂仓温度 | 查询两次:加样前一次、出结果后一次 |
原因:硬件不支持多线程,只能在流程固定节点插入查询指令。
- 未取到 TIP 的处理从”原地重试 3 次”改为往后顺延取第 2 根。
- 需要检测中的急停按钮:直接停止发送指令、仪器立即停止、无法续测只能重头开始(与维护界面 STOP 功能相同)。
- 故障提示不准确问题:如 Z 轴电路板过热掉电却报”0212 吸液量过大”,需更新错误码。
结果报告
- 反求不出高发光值点浓度——已验证曲线存在上限(y>a);显示规则:>110 显示 “>110”,<0.05 显示具体值,<0.01 显示 0.01(按试剂项目)。
- 打印预览字体不清晰,纸张/预览格式统一改 B5。
- 日历控件必须中文显示(受制于开发板,医工所对应;Pactera 调查替换样式)。
定标/校准
- 拟合方式共 8 种:线性、指数、双对数、二次多项式、三次多项式、三次样条插值、四参数、分段拟合——接口由医工所提供,缺 R 值(接口中的”相关系数 K”)。
- 光子数单位统一为 RLU。
用户权限(三级用户组)
- 普通用户(客户)
- 维护工程师(其他部门)= 普通用户 + 定标功能
- 研发工程师(仪器部) 四参数校准曲线仅研发工程师可见,历史四参数数据保存在板卡中。
日志与错误码
- 新增错误码日志,普通用户可见(错误码说明分官方版/仪器部门版)。
- 版本查询走通信协议的”版本查询”指令。
交付物约定
- UML 系统分析文档(word+pdf)在需求说明第 16 项交付材料列表中已有约定(60+ 个类),不属新增需求。
- 语言包(繁体、英文)由医工所提供翻译。
可行动点 / 工程启示
- 嵌入式上位机在无多线程能力硬件上做状态监测,只能在流程固定节点同步查询——查询点位设计要写入协议约定文档,本表就是范例。
- “下降高度”这类参数必须写清语义(单次 vs 累计),语义歧义是外包协作最常见的返工源。
- 需求 vs bug vs 新增需求的判定要显式记录(表中多处”不属于新增需求”的裁定),否则外包范围蔓延。
关联
- 微流控化学发光中位机通信协议-20190903机械臂速度版 —— 本表多数条目的底层协议
- 化学发光用户软件UI指令参数表-样本登记与指令合集1217 —— UI 指令层落地文档