新冠检测辅助平台v1.0.0需求说明书

新冠检测辅助平台需求说明书

版本 v1.0.0

2022-06 created by 黄磊
设计宗旨：最小化用户操作/功能实用/简洁至上

背景

全员核酸，每日一检，检测标本爆发的背景下，检测过程加上软件协助，可以极大的提高检测效率（每以个pcr板可以节省人工10-15分钟）的同时，减少过程误差，详细记录检测过程数据方便回溯，减轻检测工作人员工作强度

传统检测流程图（采用excel记录过程数据）

1.需求模块划分

• PR1-用户角色权限
• PR2-首页
• PR3-编辑布板
• PR4-结果上传省网
• PR5-紧急事项面板
• PR6-消息面板
• PR7-检索与统计
• PR8-文件归档

2.需求详情

PR1-用户角色权限

PR1-用户

​ 在登录页面保留注册入口、但不用实现。系统上线的时候初始化所有用户。

PR1-登录

​ 登录页面输入手机号和密码、点击登录进入系统首页。默认session时间为6小时，6小时无操作视为自动退出登录

PR1-修改密码

​ 在登录页面点击修改密码、输入手机号、原密码、新密码即可修改。如果忘记原密码、请联系国地的运维团队

PR1-操作权限

v1.0.0 版本里面采用用户、角色、按钮权限设计，考虑到快速上线、不给与权限管理功能实现。但在用户操作层面上做好日志记录。以便使用过程中出现问题进行追溯

PR2-首页

注：几乎所有的功能都和**时间批次**紧密关联！！！

PR2-查询当天时间批次的所有pcr板

• 初始化并绑定当天日期、以当前时间为准、例如现在是2022-08-30 14:25，那查询的时间就是20220830这一批号的PCR板
• 卡片内的展示信息有 布板编号、检验流程（详情见备注:PCR板检验流程状态）、复检状态（详情见备注PCR板复检状态）、创建时间、上传结果时间、备注
• 检验流程和复检状态有自己的颜色标识，详见附加说明
• 卡片内的操作按钮有编辑、查看详情。点击编辑按钮用于编辑布板、详见需求PR3-编辑布板

编号的生成规则为 日期批号+板号，板号由3位数字标识、最高999、不足3位的用0补充。例如2022-8-30 第34板 编号为 20220830034

PR2-新增布板

• 点击新增布板按钮、则新建一个空PCR布板卡片。自动生成编号（日期批号+板号）、检验流程状态（待扫码布板）、复检状态（暂无）、创建时间
• 板号生成规则是按首页显示的时间批次自增、是前端传过去、不是后端自动以当前时间为准，从1开始

注：检验流程状态和复检状态列表详情查看附加说明

PR2-删除布板

• 最后一个卡片右上角会多一个删除按钮、点击立即删除、无需确认
• 仅仅检验流程和复检状态分别是待扫码布板和暂无的时候才可以删除、其余的都不可以
• 删除后最大编号将减一，下次新增布板的时候依然是连续的，只能从后往前删除布板文件、目的是避免板号断层不连续

PR2-查看详情

• 点击查看详情按钮，打开详情模态框
• 标题展示板号，96孔表格每一个单元格里面显示检验编码,检验结果,孔位编号,外部质控 、阴阳性对照用蓝色底色突出显示。检验结果复检或者阳性用黄色底色显示，上传省网失败用橙色底色显示
• 阳性结果用红色文字显示
• 最下方的展示信息分别有：编号，检验流程，创建人，复检状态，创建时间，复检编码数量，结果上传人，检验编码总数，上传时间，结果上传

PR3-编辑布板

PR3-布板数据回显

• 点击编辑PCR板按钮、进入编辑布板页面。
• 查询隶属于该编号下所有的标本信息、并且回显。展示标本条码、孔位

PR3-布板数据编辑或扫码

• 可支持手动输入和扫码枪输入。回车后携带录入的条码请求后端接口、后端接口会返回成功或者失败来告诉前端此条码是否正常、如果正常前端拿后端传回来的条码进行赋值、然后跳到下一格。如果异常、显示红色消息、不跳下一格
• 自动填5个特殊的孔位，后端来实现该功能。假如输入的是字符串AUTO或者留空直接回车、根据空的位置分别填充 外部质控 、阴性对照1、 阴性对照2 、阴性对照3、阳性对照。这项配置项存在数据库中，可以修改
• 只有状态为待扫码布板的时候才能显示结束布板按钮
• 点击结束布板按钮会将该编号的布板检验状态更改为待上传结果，同时该按钮消失，同时状态更改为待上传结果
• 备注依然可以编辑保存

PR3-备注信息记录

• 用于PCR板特殊标识和提示
• 失去焦点自动保存

​

PR4-结果上传省网

PR4-源文件上传和转换

• 点击上传结果按钮，弹出此模态框。拖入或者点击上传荧光PCR源文件
• 系统会根据源文件的文件名自动匹配一个默认的板号（文件名一般会带板号标识）
• 选择试剂模板，默认选择第一个试剂，当前为 达安
• 点击转换后打开结果处理页面

PR4-结果展示和修改

• 转换完成以后，回显 孔位，坐标，检验编码，通道1，通道2，通道3，结果，异常处理，上传状态，上传失败原因

• 外控，阴阳性对照这5行背景色蓝色

• 阳性结果用红色文字显示

• 异常处理有4种 单孔单试剂复检、双孔单试剂复检、双孔双试剂复检、空。如果不是空的，代表需要复检，那一行要黄色背景标出来。

• 异常处理可以修改、右击修改还是下拉选择框看实现情况

• 上传状态 默认为 未上传 失败原因默认为空

• 点击一键同步省网按钮会上传所有合法标本到省网、统计结果后回显同步省网状态和异常原因

• 重新布板按钮

• 二区有时候会扫码出错，导致转换出来的结果 外控，阴阳性对照都对不上
• 清空前面的布板数据，同时检验流程状态变为待扫码布板，复检状态变为暂无
• 发送待处理事项的确认通知、让二区重新扫码布板

• 整版复检按钮

• 整版复检会将检验流程设置为检验完成、复检状态设置为整版复检待扫码
• 同时发送待处理事项的约束通知

• 完成按钮

• 点击此按钮是文件上传省网这一系列操作的一个完结。点击完成代表本板PCR实验在人为可控范围内，这一板实验正式完结，不会再对它进行操作。
• 检验流程状态将设置为检验完成，如果有复检条码或者上传省网失败条码，复检状态将变成 部分复检待扫码
• 统计复检检验编码发送待处理事项的约束通知
• 统计阳性检验编码发送待处理事项的确认通知
• 统计上传省网失败检验编码发送待处理事项的确认通知

PR5-待处理事项面板

1. 复检约束
2. 整版复检确认
3. 阳性标本确认
4. 重新布板确认
5. 上传省网失败确认

PR6-消息面板

1. 用于二区，三区，统筹区的对话 例如：第10板为黄码，优先上机
2. 用户关键操作提示
3. 检索和统计交互窗口 例如：导出今天所有的复检条码 => 20220830批号的所有复检条码已统计完成，点击下载

PR7-检索与统计

统计当前时间批号到目前时间为止的数据，有可能实验还在进行中，数据会一直变化

1. 已扫码布板标本总条目
2. 已上传结果到省网标本总条目
3. 所有的复检条码明细汇总
4. 所有的上传省网失败条码汇总
5. 当日广东省新冠检测平台已录入的标本
6. 还未上传结果到省网的条码汇总（5-2）— 小辉

PR8-文件自动归档

1. 文件目录按照 月份 日期 板号 进行分类归档，归档文件有 布板文件 源文件 结果文件
2. 每天有 所有复检标本汇总，上传省网异常条码汇总（无条码/已上传结果/上传结果异常等），今日统计汇总（总共检验xxxx个标本 阳性标本xxx个 复检标本xxx个 上传省网成功xxx个 失败xxx个 ）
3. 归档的文件可以用ftp或者smb提供访问和下载、例如：
   

3.附加说明

1. PCR板检验流程状态（check_status）

编号	code	流程状态	文字颜色
1	CS101	待扫码布板	黄色
2	CS201	待上传结果	黄色
3	CS301	检验完成	绿色

2. PCR板复检状态 （recheck_status）

编号	code	复检状态	文字颜色
1	RCS000	暂无	灰色
2	RCS201	部分复检待扫码	黄色
3	RCS202	整板复检待扫码	黄色
4	RCS301	部分复检待上传结果	黄色
5	RCS302	整板复检待上传结果	黄色
6	RCS401	部分复检完成	绿色
7	RCS402	整板复检完成	绿色
8	RCS501	无复检	绿色

3. 文字颜色标识

编号	结果	背景颜色
1	阴性	黑色
2	阳性	红色
3	复检	黄色
4	上传省网成功	黑色
5	上传省网失败	红色
6	上传省网失败原因	黑色

如果和背景色冲突就调黑色、后期有时间了再去优化这个东西

4. 特殊标本背景颜色标识

编号	code	结果	背景颜色
1	P_C_COLOR	阳性对照	蓝色
2	Q_C_COLOR	外部质控	蓝色
3	N_C_COLOR	阴性对照	蓝色
4	P_COLOR	阳性	黄色
6	R_COLOR	复检	黄色