package jnpf.limsService;
|
|
import jnpf.limsEntity.LimsFenjianItem;
|
import jnpf.limsEntity.LimsJianceTaskAcceptParam;
|
import jnpf.limsEntity.LimsJianyanAssignParam;
|
import jnpf.limsEntity.LimsJianyanAuditFailParam;
|
import jnpf.limsEntity.LimsJianyanAuditOutcome;
|
import jnpf.limsEntity.LimsJianyanAuditParam;
|
import jnpf.limsEntity.LimsJianyanResultParam;
|
import jnpf.limsEntity.LimsSignUsageTarget;
|
import jnpf.limsEntity.LimsSubmitResultOutcome;
|
|
import java.util.List;
|
|
/**
|
* LIMS 检测任务服务：分检 → 分配检验员 → 录入结果 → 审核 / 退回。
|
*/
|
public interface LimsJianceTaskService {
|
|
/**
|
* 样品分检：把请验单 submit 时创建的检验项（jianyan_zhuangtai=created +
|
* fenjian_zhuangtai=wei_fenjian）推进到 pending_assign，并标记 fenjian_zhuangtai=fenjian，
|
* 同时回写操作员录入的 4 个分检字段（分检量 / 分检单位 / 分装容器 / 分检后保存条件）。
|
*
|
* <p>按 lims_jianyan_xiang.f_id 逐条 UPDATE，带状态 / 软删过滤：仅 created 行被推进，
|
* 其余状态自动跳过；4 个分检字段行级必填（缺失抛 DataException）。
|
*
|
* @param param 分检入参（共享 bizSign + data 列表，见 {@link LimsFenjianItem}）
|
* @return 实际被推进的业务目标（非 created / 已软删 / 不存在 的行不计入）
|
*/
|
List<LimsSignUsageTarget> fenjianSamples(LimsJianceTaskAcceptParam param);
|
|
/**
|
* 分配（含改派）检验任务：每行可指定不同的检验员 / 要求完成日期，
|
* bizSign 共享（一次操作只签一次名）。按 id 逐条 UPDATE。
|
*
|
* <p>每条 SQL 带状态 / 软删过滤：允许 pending_assign（初次分配）或
|
* pending_test（改派）的行被更新，pending_audit / audited 禁止直接改派
|
* （需走退回流程），软删行跳过。
|
*
|
* @param param 分配入参（bizSign + data 列表）
|
* @return 实际被更新的业务目标（可能小于 data.size()，表示部分行被跳过）
|
*/
|
List<LimsSignUsageTarget> assignJianyanXiang(LimsJianyanAssignParam param);
|
|
/**
|
* 批量录入检验结果：把 pending_test 且属于当前登录检验员的行置为 pending_audit，
|
* 写入 jianyan_jieguo / jianyan_jielun / biz_files（签名仅审计在 lims_sign）。
|
*
|
* <p>每行结果各异，按 id 逐条 UPDATE；每条 SQL 都带 3 个过滤条件：
|
* 状态 pending_test + jiancha_ren = 当前用户 + 未软删，
|
* 状态不对 / 非本人任务 / 被软删的行自动跳过。
|
*
|
* @param param 录入入参（共享 bizSign + data 列表）
|
* @return 执行结果（含实际更新行数 + 异常调查流程发起失败的流水号列表）
|
*/
|
LimsSubmitResultOutcome submitJianyanResult(LimsJianyanResultParam param);
|
|
/**
|
* 批量审核通过检验结果：把选中的 pending_audit 行置为 audited，
|
* 写入 renwu_shenheren（当前登录用户）；签名仅审计在 lims_sign。
|
*
|
* <p>业务校验（每行独立判断，不满足的行被跳过）：
|
* <ul>
|
* <li>审核人 ≠ 录入人（jiancha_ren），不能审核自己录入的任务</li>
|
* <li>审核人必须属于该行的 jiancha_banzu 班组（即在部门成员内）</li>
|
* </ul>
|
*
|
* @param param 审核入参（共享 bizSign + data 列表）
|
* @return 执行结果明细（含未通过行按原因分桶，便于 controller 给出针对性错误）
|
*/
|
LimsJianyanAuditOutcome passJianyanAudit(LimsJianyanAuditParam param);
|
|
/**
|
* 批量项目退回：把选中的 audited 行置为 audit_rejected，
|
* 每行写入退回原因（note → tuihui_yuanyin），并写入退回人 / 签名。
|
*
|
* <p>业务校验（同 passJianyanAudit）：
|
* <ul>
|
* <li>退回人 ≠ 录入人（jiancha_ren）</li>
|
* <li>退回人必须在该行的 jiancha_banzu 班组内</li>
|
* </ul>
|
*
|
* @param param 退回入参（共享 bizSign + data 每行 id + note）
|
* @return 执行结果明细（含未通过行按原因分桶，便于 controller 给出针对性错误）
|
*/
|
LimsJianyanAuditOutcome failJianyanAudit(LimsJianyanAuditFailParam param);
|
}
|
