医疗器械软件描述文档-文思海辉模板20190327
文档概要
- 文档名称:医疗器械软件描述文档
- 编制方:文思海辉(Pactera)
- 版本日期:2019-03-27
- 对应产品:化学发光免疫分析仪(MDA-20 系列)嵌入式软件
- 安全性级别:A 级
- 文档性质:NMPA 医疗器械软件注册申报模板 + 部分项目实际内容
- 原始文件:医疗器械软件描述20190327.docx(547.21KB,1424 段 + 10 个表格,约 1.8 万字)
- 相关笔记:
一、基本信息(实际项目内容)
1.1 产品标识
| 项 | 内容 |
|---|---|
| 产品名称 | 化学发光免疫分析仪 |
| 软件型号 | V1.0 |
| 软件版本号 | V1.0 |
| 安全性级别 | A 级 |
1.2 安全性分级理由(A级)
- 预期用途:用于血液样品浓度的鉴定和计数,对血液分析起到重要作用
- 使用环境:医院中使用,面向严重性血液疾病患者(成人/儿童/老年/女性),由经过设备操作培训的医师使用
- 核心功能:根据化学发光免疫原理控制驱动硬件系统,对硬件获得的数据进行检测分析并生成报告
- 分级结论:软件为医院使用,分析对象是人体血液,但在预期用途中,无论是对待检人员还是软件操作者的健康都不会有损害,故安全级别为 A 级
二、结构功能(实际项目内容)
2.1 体系结构
系统采用 MVC 模式架构,分为6大一级模块:
用户软件界面
├── 样本检测
│ ├── 样本登记(内部扫描/手持扫描/手动输入)
│ ├── 运行监控
│ └── 结果报告(查询/打印/上传LIS)
├── 试剂耗材
│ ├── 试剂管理(外部扫描/内部扫描)
│ └── 耗材管理(盘片/底物/清洗液/TIP)
├── 质量控制
│ ├── 质控信息(新增/删除/显示)
│ └── 质控数据(查询/打印报告)
├── 校准
│ ├── 校准信息 + 校准结果
│ └── 定标信息(工程师)+ 定标结果(工程师)
├── 维护
│ ├── 样本试剂区(样本区/试剂区)
│ ├── 机械臂测试(X/Z轴/ADP/取抛TIP/吸注液)
│ ├── 反应区(反应盘/PMT/磁座/其他动作)
│ ├── 状态监测(温度/光耦)
│ ├── 拟合曲线(新增/修改/删除/拟合/保存)
│ ├── 测试流程(新建/编辑/保存/删除)
│ └── 测试序列(增加/删除/开始/停止)
└── 系统设置
├── 用户管理(添加/编辑/删除/注销)
├── LIS管理(连接设置/上传设置)
├── 日志管理(查询/重置/导出)
└── 默认设置(样本/耗材/试剂高度/关于)
2.2 各模块核心功能要点
样本检测模块:
- 样本登记支持3种方式:内部扫描(给中位机发命令)、手持扫描(扫描枪)、手动输入
- 样本类型选择联动样本号显示方式(下拉框或文本框)
- 测试项目选择:样本号为下拉框时刷新最新10个样本列表
- 运行监控:显示样本/试剂/耗材/温育舱信息 + 当前检测步骤
- 结果报告:支持模糊查询(样本号)、按样本类型+日期筛选、最新200条、打印报告、LIS上传
试剂耗材模块:
- 试剂管理:选择试剂位后外部扫描(扫描枪)或内部扫描(给中位机发命令)
- 耗材管理:更换盘片/底物/清洗液均采用”舱盖打开→扫描→确认→舱盖关闭”流程
- TIP管理:更换TIP需先执行”样本TIP归零”操作
质量控制模块:
- 质控品信息:新增(手动输入/条码扫描)、删除、按项目筛选、最新200条
- 质控数据:按年月+项目查询质控折线图、支持日期下拉框查看光子数、打印报告
校准模块:
- 校准信息 + 校准结果:试剂批号、校准日期、校准品批号、校准曲线图、测试结果值
- 定标信息(工程师权限)+ 定标结果:原曲线参数、定标曲线参数、原曲线与定标曲线对比折线图
维护模块(工程级):
- 样本试剂区:样本扫描、清洗液/底物/TIP/样本位执行、电机速度、归零、补偿、光耦状态、试剂仓温度、试剂正反转、摇匀
- 机械臂:X/Z轴归零与执行、点位保存与载入、ADP初始化与查询、单独抛TIP、取TIP/抛TIP/吸液/注液动作
- 反应区:反应盘孔位保存、转动步数执行、归零、载入步骤、离心、振荡摇匀
- PMT:单独测量、开关控制、联动测试(显示结果)
- 磁座:ON/OFF、设置参数
- 其他动作:盘盖开关、电磁铁开关、加样口开关
- 状态监测:温度监测、光耦监测
- 拟合曲线:曲线名称、拟合方式、新增/修改/删除/开始拟合/保存
- 测试流程:新建流程、增删步骤、保存/删除/清空
- 测试序列:增删序列、开始测试/STOP停止
系统设置模块:
- 用户管理:账号<15位,密码6-8位,支持添加/编辑/删除/注销
- LIS管理:开启/关闭通讯、测试连接、实时/手动上传切换
- 日志管理:按时间+类型筛选、最新200条、导出文本文件
- 默认设置:样本默认类型、耗材余量警戒值、试剂/磁珠/清洗液/底物高度设置
- 关于软件:显示软件版本、中位机版本
2.3 外部接口
| 接口类型 | 技术方案 | 用途 |
|---|---|---|
| 数据库 | Qt + SQLite | 所有数据存储与访问 |
| 串口通信 | Qt 串口接口 | 与中位机信息交互,控制硬件操作并接收反馈 |
| LIS接口 | LIS协议 | 获取LIS服务器信息、上传检测结果 |
2.4 用户界面设计
文档列出了5类UI元素示例:
- 图1.3-1 微流控用户主界面
- 图1.3-2 微流控一级菜单
- 图1.3-3 微流控二级菜单
- 图1.3-4 微流控对话框
- 图1.3-5 微流控滚动条
注:文档中图片仅有标题文字,未提取到实际图像内容。
三、实现过程(模板框架)
3.1 开发综述(模板要求)
开发过程6个阶段:
- 可行性研究和项目开发计划
- 需求分析
- 概要设计
- 详细设计
- 编码
- 集成测试
需明确:开发语言、各类工具(需求/设计/构造/测试/维护/配置管理/缺陷管理)、开发方法、人员数量、开发周期、工作量(人月)、代码行数、控制文档数量。
3.2 风险管理(模板框架)
依据 YY/T 0708 / IEC 62304 标准,核心要点:
风险管理过程四要素:
- 风险分析 — 危害识别 + 风险估计
- 风险控制 — 控制措施 + 有效性评价
危害识别需考虑:
- 正常使用 + 不正确使用两种情景
- 对患者/操作者/维护人员/附近人员/环境的五类危害
- 人为因素(人体工程学)、硬件故障、软件故障、集成错误、环境条件
- 系统组件兼容性、用户界面(命令语言/警告/出错信息)、翻译准确性、数据保护、风险受益准则、第三方软件
- 方法:故障树分析法(FTA)、失效模式和效应分析(FMEA)
风险估计:严重度级别分类 + 可能性估计(定量或定性)
风险控制优先级(从高到低):
- 固有安全设计
- 保护措施(包括警报)
- 关于剩余风险的充分用户信息
3.3 需求规格(SRS)模板框架
SRS应包含:
- 引言(编写目的、项目背景、定义、参考资料)
- 总体描述(目标、产品描述、系统总体结构图、数据流图、用况图、约束、产品功能、用户特点、约束条件)
- 具体需求(外部接口:用户/硬件/软件/通信、功能需求、性能需求、安全需求、数据库逻辑需求、设计约束、软件系统属性)
参考标准清单(模板列出):
- GB/T 11457 软件工程术语
- GB 8566 计算机软件开发规范
- GB 8567 计算机软件产品开发文件编制指南
- GB/T 12504 计算机软件质量保证计划规范
- GB/T 12505 计算机软件配置管理计划规范
- GB/T 19001 / ISO9001 质量管理体系
- ISO/IEC 12207 软件生命周期过程标准
- ISO/IEC TR 15504 软件过程评估标准
- IEEE1058.1 软件项目管理计划标准
- CMM 2.0 能力成熟度模型
- PMBOK 项目管理知识体系
3.4 生存周期(模板框架)
需编制的计划文档:
- 《软件开发计划》(SDP)
- 《软件配制管理计划》(SCMP)
- 《软件维护计划》
- 《生存周期实施情况核查表》(YY/T 0708)
三种基线:功能基线、分配基线、产品基线
四类配置管理活动:配置标识、配置控制、配置状态记录与报告、配置检查与评审
维护四类:改正性维护、适应性维护、完善性维护、预防性维护
3.5 验证与确认(V&V)
V&V过程7类活动:
- 概念 V&V
- 需求 V&V
- 设计 V&V
- 实现 V&V
- 测试 V&V
- 安装和检验 V&V
- 运行 V&V
验证方法:走查和检查、静态/动态分析、白盒/黑盒测试
确认要求:确认小组负责人独立于开发小组,设计人员不能承担自己设计的确认职责
3.6 缺陷管理(模板框架)
缺陷管理流程:缺陷报告 → 评估 → 修复 → 验证 → 关闭 需记录:开发过程缺陷总数、上市后剩余缺陷数、剩余缺陷描述/严重度/整改计划/完成时间
3.7 修订历史(模板框架)
版本号命名规则:XX.XX.XXXXX 形式 需记录:软件版本、修订日期、修订类型、变更内容描述
3.8 核心算法概述
算法分类:
- 公认成熟算法:公开文献/专利/标准,原理简单明确,上市超过4年且无不良事件 → 列明名称、原理、用途
- 全新算法:源自科学研究和临床数据 → 列明名称、原理、用途,提供验证资料
实质首次注册需列明所有核心算法;实质重新注册仅需列明新增核心算法。
四、附件清单(模板框架)
| 附件编号 | 附件名称 | 说明 |
|---|---|---|
| 附件1 | 风险管理报告 | 全文引用 |
| 附件2 | 需求规格说明书(SRS) | 全文引用 |
| 附件3 | 软件开发计划(SDP)摘要 | 6大章节:引言/开发过程/总体计划/项目组织与资源/进度/工具 |
| 附件4 | 软件配置管理计划(SCMP)摘要 | 配置标识/配置控制/工具技术方法 |
| 附件5 | 软件维护计划摘要 | 维护范围/工作流程 |
| 附件6 | 生存周期实施情况核查表(YY/T 0708) | 对应IEC 62304第52章 |
| 附件7 | 软件验证与确认计划(SVVP) | V&V过程/活动/报告 |
| 附件8 | 软件测试文档 | 测试计划+测试用例+测试报告完整模板 |
| 附件9 | 临床评价报告 | 与注册资料7一致 |
五、测试计划模板详细结构(附件8示例)
测试计划16章结构:
- 测试计划标识符
- 引言(目标/背景/范围/引用文件)
- 测试项(程序模块/作业控制规程/用户规程/操作者规程)
- 要测试的特征
- 不要测试的特征
- 方法(转换测试/作业流测试/接口测试/安全/恢复/性能/回归/综合性/约束)
- 测试项通过准则
- 暂停准则和恢复要求
- 测试交付项(8类文档+测试数据)
- 测试任务
- 环境要求(硬件/软件/安全性/工具/出版物)
- 职责
- 人员和培训要求
- 进度
- 风险和应急
- 批准
测试报告结构:引言 → 测试结果概述 → 详细测试结果 → 评价(能力/缺陷/建议/结论)→ 测试活动总结
六、关键提炼
- 文档性质:这是一份”半实半模”的文档——前部(基本信息/结构功能)有化学发光免疫分析仪的实际项目内容,后部(实现过程/附件)为通用模板框架,可作为IVD软件注册申报的参考模板
- MVC四层架构:明确采用MVC模式,四层结构(用户界面层/业务逻辑层/数据访问层/硬件通信层)
- 化学发光软件功能全景:6大模块完整覆盖样本检测全流程,从样本登记到结果报告,含质控/校准/维护/系统设置
- 注册申报完整清单:9个附件覆盖风险管理/需求/开发计划/配置管理/维护/V&V/测试/临床评价
- 与MDA-20软件描述文档的关系:本文档为文思海辉编制的模板/初版,5.附件3 全自动化学发光免疫分析仪 MDA-20 软件描述文档 为苏州医工所正式注册版(A级II类,32人月,92万行代码,249条用例,131个缺陷)
七、价值评估
- 知识价值:高。既是化学发光免疫分析仪软件的功能规格说明书,又是IVD医疗器械软件注册申报的完整模板参考
- 实践价值:高。可直接用于参考IVD软件注册申报的文档结构和内容要求
- 关联度:与 共聚焦项目-软件需求规格说明书-化学发光免疫分析仪、微流控化学发光免疫分析仪-软件系统设计与调试、5.附件3 全自动化学发光免疫分析仪 MDA-20 软件描述文档 高度相关,可交叉验证