软件测试文档需求

要求：

1.按附件《M-1 测试方案.doc》、《M-3 测试计划模版.doc》、《测试用例模板（简化板）.docx》中规定的内容编写文档，因不符合规定导致文档验收不通过需持续改进。

2.本测试项目分两个小软件，每个小软件按上述附件单独编写文档。

3.截止2021年5月6日完成所有工作。

4.测试内容包括：2套软件UI展现、软件业务流程、软件涉及的服务端API调用（接口参考：《候诊屏服务端API》、《患者信息屏服务端API》）、软件涉及的服务端socket调用（接口参考：《候诊屏socket消息推送接口》、《患者信息屏socket消息推送接口》）。

特殊说明：

1.软件运行环境固定为win10系统

2.显示器固定为1080x1920及1920x1080两种显示器

3.候诊屏中的卡号验证功能正在等待医院接口，目前输入任何卡号都可以成功（这部分可以根据你们的经验来写接口测试文档）

4.患者信息屏中的电子病历、检查记录、影像记录在等待医院接口，数据为伪造的（这部分可以根据你们的经验来写接口测试文档）

5.软件UI及基本业务逻辑基于electron、nodejs。与硬件交互部分为c#实现（需要二维码扫码器，不好展示）

6.即时通信采用socketio

测试账号：

1.候诊屏：

账号：hz_big1    密码：123456

2.患者信息屏：

账号：hzxx_xwk   密码：123456

#################################################################

服务端API

1.状态码：0：成功 1：未登陆 <0:业务相关错误

2.POST参数：json

#################################################################

候诊屏服务端API：

1.候诊屏登陆：

描述：候诊屏有多个，每个候诊屏都有独立的账号，软件运行后需先进行设备登陆才能正常开启候诊屏功能

接口地址：User/Index/login

请求方法：POST

参数

    userName：用户名

    password：密码

返回值（error）：0：成功（成功后的返回值见data） 1：错误（具体见msg）

2.候诊屏基本信息：

描述：获取当天科室值班医生、用于登陆IM的token等信息

接口地址：Screen/Index/index

请求方法：GET

参数：无

返回值（error）：0：成功（成功后的返回值见data） 1：错误（具体见msg）

3.根据卡号登陆：

描述：用户选择卡类型并输入卡号后到后台查询当前患者今天是否有挂号记录，如有则返回患者信息

接口地址：Guide/Index/login

请求方法：POST

参数

    cardType：卡类型，idcard: 身份证号,cardid: 就诊卡号,ard: 医保卡号,id: 患者ID

    cardNum：卡号

返回值（error）：0：成功（成功后的返回值见data） -1：错误（具体见msg）

4.排号：

描述：用户填完基本资料，并完善当前症状、既往病史等信息后申请排号，申请成功后返回就诊排号。

接口地址：Guide/Index/submit

请求方法：POST

参数

    patient：患者基本信息

    departmentId：科室ID

    symptomVals：当前症状、既往病史等信息

返回值（error）：0：成功（成功后的返回值见data） -1：错误（具体见msg）

5.看报告：

描述：用户就诊后按医师要求做检查，检查完毕后点击看报告，申请成功后返回看报告的就诊排号。

接口地址：Guide/Index/viewReportSubmit

请求方法：POST

参数

    registerId：挂号ID

返回值（error）：0：成功（成功后的返回值见data） -1：错误（具体见msg）

#################################################################

患者信息屏服务端API：

1.患者信息屏登陆：

描述：患者信息屏有多个，每个患者信息屏都有独立的账号，软件运行后需先进行设备登陆才能正常开启患者信息屏功能

接口地址：User/Index/login

请求方法：POST

参数

    userName：用户名

    password：密码

返回值（error）：0：成功（成功后的返回值见data） 1：错误（具体见msg）

2.患者信息屏基本信息：

描述：获取科室信息、用于登陆IM的token等信息

接口地址：Screen/Index/index

请求方法：GET

参数：无

返回值（error）：0：成功（成功后的返回值见data） 1：错误（具体见msg）

3.获取患者基础信息：

描述：获取患者的基本资料、在导诊时填写的当前症状、既往病史、过敏史、个人史、传染病史等信息

接口地址：Patient/Index/baseInfo

请求方法：GET

参数

    uid：患者ID

    did：科室ID，1:呼吸内科 2:胸外科

返回值（error）：0：成功（成功后的返回值见data） 1：错误（具体见msg）

4.获取患者就诊记录：

描述：返回历次就诊记录，包含姓名、科室、就诊时间等信息

接口地址：Patient/Index/registerLog

请求方法：GET

参数

    uid：患者ID

    did：科室ID，1:呼吸内科 2:胸外科

返回值（error）：0：成功（成功后的返回值见data） 1：错误（具体见msg）

5.获取患者电子病历：

描述：返回历次电子病历，包含科室、医生、处方详情、时间等信息

接口地址：Patient/Index/medicalRecord

请求方法：GET

参数

    uid：患者ID

    did：科室ID，1:呼吸内科 2:胸外科

返回值（error）：0：成功（成功后的返回值见data） 1：错误（具体见msg）

6.获取患者检查记录：

描述：返回检查记录，包含科室、医生、检查项目、检查结果、时间等信息

接口地址：Patient/Index/checkLog

请求方法：GET

参数

    uid：患者ID

    did：科室ID，1:呼吸内科 2:胸外科

返回值（error）：0：成功（成功后的返回值见data） 1：错误（具体见msg）

#################################################################

候诊屏socket消息推送接口：

1.初始化消息推送

描述：客户端通过token连接服务器成功后，服务端会发起init回调，返回当前科室所有等待就诊的患者（包含就诊及看报告两类患者）

数据流向：服务端->客户端

回调名：init

回调参数

    patients：当前科室所有等待就诊的患者

2.患者挂号成功后的消息推送

描述：患者挂号成功后服务端会向对应的候诊屏推送消息，用以更新候诊患者列表

数据流向：服务端->客户端

回调名：registerUpdate

回调参数

    departmentId：科室ID

    step：register:就诊挂号 report:看报告挂号

    patients：当前科室的所有候诊患者

3.医生叫号（下一位）成功后的消息回调

描述：医生叫号（下一位）成功后服务端会发起callNextUpdate回调，用以更新候诊患者列表并语音提示患者就诊

数据流向：服务端->客户端

回调名：callNextUpdate

回调参数

    departmentId：科室ID

    step：register:就诊挂号 report:看报告挂号

    patients：当前科室的所有候诊患者

4.医生叫号（重新叫号）成功后的消息回调

描述：医生叫号（重新叫号）成功后服务端会发起recallUpdate回调，用以语音提示患者就诊

数据流向：服务端->客户端

回调名：recallUpdate

回调参数

    departmentId：科室ID

    step：register:就诊挂号 report:看报告挂号

5.扫码成功消息回调

描述：患者通过就诊卡二维码扫码成功后，服务端会发起notify回调

数据流向：患者扫码->服务端->客户端

回调名：notify

回调参数

    info：json对象，info.cardId为扫码识别出来的患者就诊卡ID

#################################################################

患者信息屏socket消息推送接口：

1.初始化消息推送

描述：客户端通过token连接服务器成功后，服务端会发起init回调，返回当前科室所有等待就诊的患者（包含就诊及看报告两类患者）

数据流向：服务端->客户端

回调名：init

回调参数

    patients：当前科室所有等待就诊的患者

2.患者挂号成功后的消息推送

描述：患者挂号成功后服务端会向对应的患者信息屏推送消息，用以更新候诊患者列表

数据流向：服务端->客户端

回调名：registerUpdate

回调参数

    departmentId：科室ID

    step：register:就诊挂号 report:看报告挂号

    patients：当前科室的所有候诊患者

3.医生叫号（下一位）成功后的消息回调

描述：医生叫号（下一位）成功后服务端会发起callNextUpdate回调，用以更新候诊患者列表

数据流向：服务端->客户端

回调名：callNextUpdate

回调参数

    departmentId：科室ID

    step：register:就诊挂号 report:看报告挂号

    patients：当前科室的所有候诊患者

4.医生叫号（重新叫号）成功后的消息回调

描述：医生叫号（重新叫号）成功后服务端会发起recallUpdate回调

数据流向：服务端->客户端

回调名：recallUpdate

回调参数

    departmentId：科室ID

    step：register:就诊挂号 report:看报告挂号

5.叫号接口

描述：医生可以点击患者信息屏上的叫号按钮呼叫下一位患者

数据流向：客户端->服务端->客户端

接口名称：callNext

接口参数：

    departmentId：科室ID

    step：患者信息屏上的叫号按钮分就诊叫号及看报告叫号。register:就诊叫号 report:看报告叫号

接口返回参数

    b：true:操作成功 false:操作失败

    err: 若b=false,err包含具体错误

6.重新叫号接口

描述：医生可以点击患者信息屏上的重新呼叫按钮重新呼叫患者

数据流向：客户端->服务端->客户端

接口名称：recall

接口参数：

    departmentId：科室ID

    step：患者信息屏上的重新叫号按钮分就诊叫号及看报告叫号。register:就诊叫号 report:看报告叫号

接口返回参数

    b：true:操作成功 false:操作失败

    err: 若b=false,err包含具体错误

联系我时，请说是在 互站网 看到的，谢谢！