微流控化学发光分析仪用户软件优化需求清单(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。

用户权限(三级用户组)

  1. 普通用户(客户)
  2. 维护工程师(其他部门)= 普通用户 + 定标功能
  3. 研发工程师(仪器部) 四参数校准曲线仅研发工程师可见,历史四参数数据保存在板卡中。

日志与错误码

  • 新增错误码日志,普通用户可见(错误码说明分官方版/仪器部门版)。
  • 版本查询走通信协议的”版本查询”指令。

交付物约定

  • UML 系统分析文档(word+pdf)在需求说明第 16 项交付材料列表中已有约定(60+ 个类),不属新增需求。
  • 语言包(繁体、英文)由医工所提供翻译。

可行动点 / 工程启示

  1. 嵌入式上位机在无多线程能力硬件上做状态监测,只能在流程固定节点同步查询——查询点位设计要写入协议约定文档,本表就是范例。
  2. “下降高度”这类参数必须写清语义(单次 vs 累计),语义歧义是外包协作最常见的返工源。
  3. 需求 vs bug vs 新增需求的判定要显式记录(表中多处”不属于新增需求”的裁定),否则外包范围蔓延。

关联