微流控化学发光分析仪用户软件 QA 问题管理记录(2019-08-05)

来源:云盘 /工作相关/全自动化学发光/文思海辉 文件/注册后优化/[CASS SPAM]回覆_ 【微流控】20190819样本登记/QA问题管理20190805记录.xlsx(同名文件在 0817样本登记-重复性/ 目录还有一份 76KB 副本)。 单 Sheet,139 行记录:137 条 QA 问答(日期序列号 43672≈2019-07-26 / 43677≈2019-07-31)+ 2 条新旧版本 Bug 移交记录。

项目背景

  • 三方协作模式:均豪(仪器方/需求方,提供 UI 草图和业务规则)→ pactera 文思海辉(用户软件外包开发)→ 医工所(中位机/下位机、协议、函数接口提供方)。
  • 本表是 pactera 对医工所/均豪测试反馈的逐条答复台账:No. | 日期 | 分类 | 问题 | 回答 | 答复(结论) | 状态 | 范围(补充备注)。
  • 分类只有三种:修改说明、新增需求、旧/新版本出现问题。
  • 结论标记体系很有工程味:明确,按照回答,待修改 / 已修改,待确认 / 完了 / 新需求,不对应 / 超时对象外(给医工所/均豪定了硬deadline:协议、UI草图、条码规则、函数接口限期 8月20-23日提供,逾期即出范围不做——外包合同管理的典型手法)。

界面模块结构(用户软件信息架构)

从问题前缀可还原整机软件的功能树:

  • 样本检测:样本登记 → 运行监控 → 结果报告
  • 试剂耗材:试剂管理 / 耗材管理(盘片、TIP、底物、清洗液)
  • 质量控制:质控信息 / 质控数据
  • 校准:校准信息/结果、定标信息/结果(校准与定标是两套独立流程)
  • 系统设置:用户管理 / LIS管理 / 日志管理 / 默认设置(截面积)/ 关于软件
  • 维护(工程师模式):样本试剂区 / 机械臂试剂区 / 反应区 / 曲线拟合 / 流程测试

核心业务规则(有复用价值的领域知识)

样本与检测流程

  • 样本类型:全血、血清、血浆(多选项目,平铺表勾选);质控、校准、定标为单选;后新增末梢血类型(流程/下降高度与全血一致)。
  • 流程进度固定九步:开始检测→加入磁珠→加入酶标→加入样本→培育中→加入清洗液→加入底物→反应中→检测结束(顺序固定不变,按步骤顺序对指令类别判断刷新)。
  • 结果排序必须与 PMT 读数顺序一致(曾按孔位序导致乱序)。
  • 浓度反求显示规则:<0 显示 0;[0,上限] 显示数值(保留3位小数);>上限显示 >上限值(上限=光子数浓度组最大浓度,如 >110)。
  • 急停语义:用户软件只停止发送下一条指令,当前动作由下位机执行完才停;再次检测从头开始发送。

试剂管理

  • 在机稳定性:试剂 2-8℃ 取出后可在机上存 7 天(可修改),从扫描当天起算,超期后每天第一次检测弹警告但可选择继续。
  • 过期试剂/底物:禁止录入(条码含有效期信息)。
  • 批号显示要去掉条码前缀数字(如”11xxxx”只显示真实批号)。

校准/质控曲线

  • 同批号试剂共用同一条校准曲线(原始曲线相同);对同一盒试剂重复校准应后者覆盖前者。
  • 质控范围由条码中的靶值、SD 值、SD 倍数计算得出(条码规则由均豪修订)。
  • 曲线拟合方式 8 种:线性、指数、双对数、二次多项式、三次多项式、三次样条插值、四参数、分段拟合——函数接口由医工所提供(对应云盘中”曲线拟合 多项式+指数+双对数 IMITATE2 工程文件”)。
  • 曲线可见性分级:光子数 RLU 和普通用户不可见的原始曲线仅研发工程师角色可见;用户组三级:普通用户(客户)/维护工程师(其他部门)/研发工程师(仪器部)。
  • 所有曲线页统一显示:公式连带参数 + r 值。

硬件交互约定

  • 液面侦测:吸液高度(mm)= 吸液量/截面积 + 修正项(公式由医工所提供);截面积按液体种类分别设定(磁珠、酶标、稀释液、样本、稀释杯、清洗液、底物、末梢血)。
  • 吸液动作:液面下高度逐次下降,不得一次下到位(防吸空/碰底)。
  • 取 TIP 失败策略:自动顺延两根重试,两次取不到才报错。
  • 点动控制(jog):按住即动、松开即停;因中位机不支持,按键保留但功能不实现——UI 先行的妥协。
  • 光耦/温度状态:硬件不支持时软件先行发送查询指令占位,硬件就绪后再补显示。
  • 清洗液人份:一个盘片孔位计一份。
  • 参数一键导出:机械臂全部位置参数+反应仓位置参数+液面高度参数可导出到板卡配置文件(新需求)。

日志与错误码

  • 日志只记录错误码(编号),弹出框显示全部错误描述;错误码说明分官方版/仪器部门版两套,普通用户可见日志记录本身。
  • 日志编码定义放在日志配置文件中,新增错误码不改代码。
  • 错误码提示同样走配置文件修改,不动代码——错误码/日志/默认参数全部配置化是这个版本的美容策略。

LIS

可行动点 / 经验提炼

  1. 外包 QA 台账的好格式:问题(带界面模块前缀)+ 回答 + 结论 + 状态四列,加”超时对象外”的 deadline 条款,能把扯皮变成可追踪项。
  2. 配置化吸收变更:错误码、日志编码、流程稀释步骤、复位参数全部放配置文件,“无需修改代码”在本表出现 6 次以上,是应对需求频繁变更的核心手段。
  3. 硬件未就绪时的软件占位策略:先发指令、保留按钮、待协议补齐——三方项目(UI方/上位机/下位机)推进的实用手法。
  4. 与既有笔记关联:样本录入与试剂规范190321(同期需求文档)、流式细胞仪-SA软件测试计划(同项目群测试体系)。

疑点标注

  • 表中日期列为 Excel 序列号(43672=2019-07-26,43677=2019-07-31),文件名 20190805 应为台账定稿日。
  • 第 138-139 行为 Bug 移交:“更新盘片后检测 4 样本可用数量显示 1/8”、“温育仓温度无返回导致检测中止”,均”提到 BugList 中”,后续 BugList 文件未在队列中发现,待确认。