冷链设备主档(PC)
- 功能：新增、修改、删除、查询、保存、确定
- 字段内容：
设备类型：1-保温箱；2-冰排；3-温度计；4-预冷容器；系统下拉框
类型说明：
1-保温箱用于存放货品、无温度计箱子的需要关联温度计组合使用；
4-预冷容器用于放置冰排，统一预冷、释冷、包装、回收使用，
可为小车，周转箱等容器；
设备ID：自动生成
设备名称：手工输入
设备型号：下拉框，新增用户选项字典
设备编号：手工输入或扫描收集
预冷时长（分钟）：手工输入，number(16)
释冷时长（分钟）：手工输入，number(16)
释冷待使用时长（分钟）：手工输入，number(16)
是否集成温度计：（仅类型1-保温箱可用，勾选项，默认不勾选）
勾选：1，是；不勾选：0，否
是否条码管理：（仅类型2-冰排可用，勾选项，默认不勾选）
勾选：1，是；不勾选：0，否
状态：1-临时；2-确定
创建人：当前登录人 （关联人员信息）
创建人ID：当前登录人ID
创建时间：创建时系统当前时间
确定人：当前登录人 （关联人员信息）
确定人ID：当前登录人ID
确定时间：确定时系统当前日期 - 处理要求：
(1) 在【冷链设备主档】中录入设备信息；
(2) 点击“新增”，填写设备信息，点击“保存”，保存信息，状态为临时，
类型为：2-冰排，必须填写“预冷时长（分钟）、释冷时长（分钟）、释冷待使用时长（分钟）”；
(3) 点击“修改”，可修改状态：0、临时的信息；
(4) 点击“删除”，可修改状态：0、临时的信息；
(5) 点击“确定”,可确定状态：0、临时的信息，修改状态为1、正式，记录确定人员及时间；
冷链设备入库报废管理(PC) - 功能：新增、删除、修改、保存、确定
- 字段内容：
创建时间：系统当前日期
业务类型：1-采购入库；２-报废；下拉选择，系统选项字典
设备编号：HOV-【冷链设备主档】或扫描带出 （关联冷链设备主档）
设备名称：HOV-【冷链设备主档】或自动带出 （关联冷链设备主档）
设备型号：自动带出 （关联冷链设备主档）
设备ID：HOV-【冷链设备主档】或自动带出
是否条码管理：自动带出 （关联冷链设备主档）
入库数量：手工输入，必填，空或0时不可保存，number(16)；
状态：０：临时；１：正式；
操作人：系统当前登录人 （关联人员信息）
操作人ID：系统当前登录人ID
确定人：系统当前登录人 (关联人员信息）
确定人ID：系统当前登录人ID
确定时间：系统当前时间 - 处理要求：
(1) 点击“新增”，选择业务类型，填写或扫描 设备编号，选择 设备名称或设备ID，带出设备型号、是否条码管理、填写或自动更新入库数量
入库数量手工填写逻辑：类型＝２且“是否条码管理”=０时；
入库数量自动更新逻辑：类型＝２且“是否条码管理”=１时；入库数量默认为1
(2) 点击“保存”，保存数据，状态为临时；
(3) 点击“修改”，可修改状态：0、临时的信息；
(4) 点击“删除”，可修改状态：0、临时的信息；
(5) 点击“确定”,可确定状态：0、临时的信息，修改状态为1、正式，记录确定人员及时间；确定后新增/更新【冷链设备库存表】：业务类型：１-采购入库，增加库存数量、正式数量；２-报废，减少库存数量、正式数量；
冷链设备库存表(PC) - 功能：查询
- 字段内容：
设备类型：（关联冷链设备主档）
设备ID
设备名称：（关联冷链设备主档）
设备编号：（关联冷链设备主档）
设备型号：（关联冷链设备主档）
库存数量：number(16)
正式数量：number(16)
冷链设备使用记录(PC)和冷链设备使用记录his - 功能：查询：联合查询正式表和历史表、强制回收：按钮可权限设置，0：不显示；1：显示；
- 字段内容：
记录ID：主键-自增序列
设备类型：（关联冷链设备主档）
设备ID :保温箱、冰排、温度计设备ID
容器ID：预冷容器设备ID，非冰排设备可以为空
包装记录ID：包装时记录，其他记录类型为空
设备名称：（关联冷链设备主档）
设备编号：（关联冷链设备主档）
设备型号：（关联冷链设备主档）
初始数量：当前设备创建时数量
预冷中数量：界面不展示
释冷中数量：界面不展示
可用数量：
使用数量：界面不展示
回收数量：
回收时间：多次回收覆盖此字段
回收标志：0-未回收，1-部分回收，2-全部回收
记录类型：1-预冷；2-释冷；3-使用；
开始时间
结束时间
备注
操作人：系统当前登录人 （关联人员信息）
操作人ID：系统当前登录人ID
创建时间：系统当前时间
删除时间：系统当前时间 his表独有字段
数据来源：0-历史（历史表），1-正式（正式表）非数据库字段，视图区分即可 - 强制回收业务点：
(1) “强制回收”即将选择的冷链设备使用记录，记录类型：2-释冷，可用数量>0的库存的可用数量扣减
① 强制回收每次只能选择一条可用数量大于0的使用记录信息进行回收；
② 点击“强制回收”，弹框输入“回收数量”，默认：选择使用记录的可用数量，输入数量只能为正整数，不能大于使用记录的可用数量，异常给与提示；
③ 按照记录ID+设备ID更新【冷链设备使用记录】可用数量=可用数量-输入回收数量，回收数量=回收数量+入参回收数量，回收标志：0-未回收（回收数量为空或零），1-部分回收（回收数量<初始数量），2-全部回收（回收数量=初始数量）
④ 修改选择设备的【冷链设备库存表】：正式数量=正式数量+输入回收数量；
⑤ 删除使用记录到历史：删除【冷链设备使用记录】记录类型：2-使用，使用数量为0的记录到历史表；
冷链包装方案(PC) - 功能：新增、修改、删除、保存、确定
- 字段内容：
方案ID：自动生成
方案名称：手工输入
保温箱型号：设备主档-保温箱型号 下拉选择用户选项字典
温区上限：手工输入，number(16.6)
温区下限：手工输入，number(16.6)
时间上限按月：手工输入，只支持1-12正整数，number(16)
时间下限按月：手工输入，只支持1-12正整数，number(16)
线路配送时长（小时）：手工输入，number(16.6)
冰排放置数量：手工输入，number(16)
状态：0、临时；1、正式
创建人：系统当前登录人 (关联人员信息）
创建人ID：系统当前登录人ID
创建时间：系统当前时间
确定人：系统当前登录人 (关联人员信息）
确定人ID：系统当前登录人ID
确定时间：系统当前时间 - 处理要求：
(1) 点击“新增”，填写包装方案，点击“保存”，保存信息，状态为临时；
(2) 点击“修改”，可修改状态：0、临时的包装；
(3) 点击“删除”，可修改状态：0、临时的包装；
点击“确定”,可确定状态：0、临时的包装，修改状态为1、正式，记录确定人员及时间；
冷链设备预冷(RF) - 按设备信息查询冷链设备库存接口
(1) 入参：设备编号、设备名称、设备ID
(2) 按设备信息正式数量大于0的设备类型为1-保温箱；3-温度计；4-预冷容器；冷链设备的库存信息，返回list;
(3) 返回字段：设备ID、设备名称、设备编号、设备类型、设备型号、预冷时长、是否条码管理、释冷时长、释冷待使用时长、是否集成温度计、正式数量 - 查询冷链设备预冷使用记录接口
(1) 入参：空
(2) 查询【冷链设备使用记录】指定记录类型：1-预冷、预冷中数量>0的list；
(1) 返回字段：记录ID、设备ID、设备名称、设备编号、设备类型、设备型号、预冷时长、是否条码管理、释冷时长、释冷待使用时长、是否集成温度计、记录类型、开始时间、结束时间、预冷中数量 - 冰排查询接口
(1) 入参：设备类型（2-冰排），是否条码管理（0，否）
(2) 查询正式数量大于0冷链设备库存信息，返回list；
(3) 返回字段：设备ID、设备名称、设备编号、设备类型、设备型号、预冷时长、是否条码管理、释冷时长、释冷待使用时长、是否集成温度计、正式数量 - 预冷接口
(1) 入参：预冷设备-数量信息list-chidlist(预冷容器-冰排子列表)
(2) 入参字段list：设备ID、设备类型、是否集成温度计、数量
(3) 入参字段childlist：设备ID、设备类型、是否条码管理、数量
(4) 入参检查1：有chidlist的父元素设备类型必须为4-预冷容器，chidlist的元素设备类型必须为2-冰排，否则提示前台“只能预冷容器挂载冰排”；
(5) 入参检查2：当list中存在设备类型=1-保温箱且是否集成温度计=0的设备时，需要检查是否有设备类型=3-温度计的同时存在且保温箱数量小于等于温度计的数量；
(6) 业务逻辑1：list、childlist中每条设备信息记录一条【冷链设备使用记录】，设备类型为4-预冷容器的自身不生成记录，只做为容器ID记录在冰排使用记录上，记录类型：1-预冷，开始时间为当前时间，操作人为当前登录人员，初始数量=预冷中数量=入参预冷数量；
(7) 业务逻辑2：按照设备类型ID扣减【冷链设备库存表】正式数量=正式数量-入参预冷数量，入参数量不能大于对应【冷链设备库存表】正式数量；
冷链设备释冷(RF) - 按设备信息查询预冷使用记录接口
(1) 入参：设备编号/设备名称/设备ID
(2) 按设备信息查询【冷链设备使用记录】指定记录类型、预冷中数量>0的list，如果设备设备类型为4-预冷容器，同时按照【冷链设备使用记录】容器ID查询预冷的冰排list返回；
(1) 返回list字段：记录ID、设备ID、容器ID、设备名称、设备编号、设备类型、设备型号、预冷时长、是否条码管理、释冷时长、释冷待使用时长、是否集成温度计、预冷中数量； - 查询冷链设备释冷使用记录接口
(1) 入参：空
(2) 查询【冷链设备使用记录】指定记录类型1-预冷、预冷中数量>0的list；
(3) 返回字段：记录ID、设备ID、容器ID、设备名称、设备编号、设备类型、设备型号、预冷时长、是否条码管理、释冷时长、释冷待使用时长、是否集成温度计、记录类型、开始时间、结束时间、预冷中数量 - 释冷
(1) 入参：预冷设备-数量信息list；
(2) 入参字段list：记录ID、设备ID、容器ID、设备类型、是否集成温度计、数量；
(3) 入参检查1：当设备类型=4-预冷容器时，预冷容器中的冰排开始预冷时间+设备主档维护的“预冷时长”大于等于当前时间，否则，则提示“预冷时间不足，请继续预冷”；
(4) 入参检查2：当设备类型=1-保温箱时，保温箱的开始预冷时间+设备主档维护的“预冷时长”大于等于当前时间，否则，则提示“预冷时间不足，请继续预冷”；
(5) 入参检查3：当设备类型=3-温度计时，温度计的开始预冷时间+设备主档维护的“预冷时长”大于等于当前时间，否则，则提示“预冷时间不足，请继续预冷”；
(6) 入参检查4：释冷数量不能大于对应的使用记录ID+设备ID+记录类型：1-预冷的使用记录的可用数量；
(7) 业务逻辑1：按照list中每条记录ID+设备ID+记录类型：1-预冷，更新结束时间为当前时间，按照使用记录ID+设备ID更新可用数量，预冷中数量=预冷中数量-入参释冷数量；
(8) 业务逻辑2：list中每条设备信息记录一条【冷链设备使用记录】，记录类型：2-释冷，开始时间为当前时间，操作人为当前登录人员，初始数量=释冷中数量=入参释冷数量，容器ID为预冷记录容器ID；
(9) 当选择设备类型=2-冰排时，无论前端传入冰排是否为关联容器的全部冰排，都要找到关联的预冷容器，将预冷容器关联的所有冰排要统一释冷
(10) 删除使用记录到历史：删除【冷链设备使用记录】记录类型：1-释冷，预冷中数量为0（不为空）的记录到历史表； - 按设备信息查询释冷过的使用记录接口
(1) 入参：空
(2) 查询【冷链设备使用记录】指定记录类型2-释冷、释冷中数量>0的list；
(3) 返回字段：记录ID、设备ID、容器ID、设备名称、设备编号、设备类型、设备型号、预冷时长、是否条码管理、释冷时长、释冷待使用时长、是否集成温度计、记录类型、开始时间、结束时间、释冷中数量 - 结束释冷
(1) 入参：释冷设备-数量信息list；
(2) 入参字段list：记录ID、设备ID、容器ID、设备类型、数量；
(3) 入参检查1：设备开始释冷时间+设备维护的“释冷时长”必须大于等于当前时间，否则，则提示“释冷时间不足，请继续释冷”；
(4) 业务逻辑1：当选择设备类型=2-冰排时，无论前端传入冰排是否为关联容器的全部冰排，都要找到关联的预冷容器，将预冷容器关联的所有冰排要统一释冷；
(5) 业务逻辑2：按照list中每条记录ID+记录类型：2-释冷，更新结束时间为当前时间，按照使用记录ID更新：释冷中数量=释冷中数量-结束释冷数量，可用数量=可用数量+结束释冷数量；
冷链设备包装(RF) - 按设备信息查询可用冷链设备使用记录接口
(1) 入参：设备编号/设备名称/设备ID
(2) 按设备信息查询【冷链设备使用记录】记录类型：2-释冷，可用数量>0的list，如果设备设备类型为4-预冷容器，同时按照【冷链设备使用记录】容器ID查询预冷的冰排list返回；
(3) 返回list字段：记录ID、设备ID、容器ID、设备名称、设备编号、设备类型、设备型号、预冷时长、是否条码管理、释冷时长、释冷待使用时长、是否集成温度计、可用数量； - 包装方案查询接口（此接口只支持一个保温箱+一个箱号查询包装方案）
(1) 入参：保温箱设备编号、装箱信息-箱号
(2) 入参检查：按保温箱编号查询冷链设备使用记录：记录类型：3-待使用状态的数据，查询不到返回“此冷链设备不是待使用状态不允许包装”
(3) 方案匹配：获取保温箱-保温箱型号，获取装箱信息对应订单线路的-配送时间（小时），获取装箱信息中货品的-温控分类中的温度上限、温控分类中的温度下限，与包装信息进行匹配，匹配规则如下：
① 保温箱查询出的保温箱型号=【冷链包装方案】中保温箱型号;
② 箱号查询出的配送时间小于等于【冷链包装方案】中的线路配送时长，优先等于；
③ 箱号查询出的温控分类中的温度上限小于等于【冷链包装方案】温区上限，箱内多个货品取最大值；
④ 箱号查询出的温控分类中的温度下限大于等于【冷链包装方案】温区下限，箱内多个货品取最小值；
⑤ 当前时间月份小于等于【冷链包装方案】时间上限按月且大于等于【冷链包装方案】时间下限按月，如果时间上限按月<时间下限按月意味着跨年，应该支持匹配，举个例子：常规设置——时间下限按月：1，时间上限按月：4，当前时间月份：2，即1-4月，2月份在其中应该匹配；非常规设置——时间下限按月：11，时间上限按月：4，当前时间月份：12，即11月份到来年4月份，12月份在其中也应该匹配。
(4) 匹配到的方案状态必须为正式的；
(5) 返回list字段：方案ID、方案名称、冰排放置数量； - 冰排可使用检查
(1) 入参：设备编号/设备名称/设备ID
(2) 按设备信息查询【预冷容器-冰排关联关系表】中的冰排对应的【冷链设备使用记录】，记录类型：3-待使用，开始时间+设备维护的待使用开始时间小于等于当前时间，是返回ture，否返回false; - 包装结束接口
(1) 入参：使用冷链设备list，箱号list
(2) 入参字段：记录ID、设备ID、容器ID、设备类型、数量；
(3) 前置设置：装箱信息增加“冷链包装记录ID”字段
(4) 业务逻辑1：按照list每条记录ID+设备ID+记录类型：2-释冷，更新结束时间为当前时间，可用数量=可用数量-入参使用数量；
(5) 业务逻辑2：list中每条设备信息记录一条【冷链设备使用记录】，记录类型：3-使用，开始时间为当前时间，操作人为当前登录人员，同一次包装结束请求生成一个包装记录ID记录在每一条【冷链设备使用记录】包装记录ID上，初始数量=使用数量=入参数量，容器ID为预冷记录容器ID；
(6) 业务逻辑3：按照箱号更新包装记录ID到每一条装箱信息的“冷链包装记录ID”；
(7) 删除使用记录到历史：删除【冷链设备使用记录】记录类型：2-释冷，可用数量为0（不为空）的记录到历史表；
冷链设备回收(RF)-使用 - 查询使用冷链设备接口
(1) 入参：保温箱号/装箱箱号
(2) 按入参查询保温箱号对应的【冷链设备使用记录】记录类型：3-使用的包装记录ID，若查询不到按入参查询装箱箱号对应的包装记录ID，都查询不到返回空；
(3) 按查询到的包装记录ID，查询设备使用记录信息；
(4) 返回冷链设备使用记录list
(5) 返回字段：记录ID、设备ID、设备名称、设备编号、设备类型、设备型号、使用数量； - 回收
(1) 入参：使用冷链设备list
(2) 入参字段：记录ID、设备ID、设备类型、数量；
(3) 业务逻辑1：回收数量不能大于对应的【冷链设备使用记录】，记录类型：3-使用的记录数量，匹配字段：使用记录ID；
(4) 业务逻辑2：按照list中每条记录ID+记录类型：3-使用，更新结束时间为当前时间，使用数量=使用数量-入参回收数量，回收数量=回收数量+入参回收数量；
(5) 业务逻辑4：按照使用记录中的设备ID+数量更新【冷链设备库存表】数据：正式数量=正式数量+入参回收数量；
(6) 删除使用记录到历史：删除【冷链设备使用记录】记录类型：3-使用，使用数量为0的记录到历史表；
文档更新时间: 2024-03-20 11:08 作者：陈柯任
