package jnpf.limsService;
|
|
import jnpf.limsEntity.LimsBaogaoSubmitParam;
|
|
/**
|
* 报告生命周期服务。
|
*
|
* <p>报告数据已合并进 lims_qingyandan（baogao_* 列），本服务所有动作都按请验单 id
|
* 在 lims_qingyandan 行上流转（baogao_zhuangtai 走 {@code BaogaoStatus}），
|
* 不再使用独立的 lims_qingyandan_report 表。
|
*/
|
public interface LimsQingyandanReportService {
|
|
/**
|
* 检验项全部 audited 后自动生成报告：在对应 lims_qingyandan 行上把
|
* baogao_zhuangtai 由空串推进到 created，并写入 baogao_shifou_hege、首次生成 baogao_bianhao。
|
* 幂等：仅当 baogao_zhuangtai 为空串且该请验单下所有 lims_jianyan_xiang 都 audited 时才生成。
|
*
|
* @param qingyandanId 请验单 id（lims_qingyandan.f_id，主键查）
|
* @return true 表示本次生成；false 表示条件不满足 / 已生成
|
*/
|
boolean generateReportData(String qingyandanId);
|
|
/**
|
* “生成报告”动作（baogao_zhuangtai: created → pending_audit）：
|
* 写 baogao_ren=当前用户、baogao_riqi=入参日期、baogao_beizhu=入参备注，并清空上一次退回痕迹。
|
*
|
* @param param 入参（id=请验单 id + baogaoRiqi + beizhu）
|
* @return true 更新成功；false 状态不符 / 不存在 / 已软删
|
*/
|
boolean submitReport(LimsBaogaoSubmitParam param);
|
|
/**
|
* “退回 / 不通过”动作：写 baogao_tuihui_yuanyin/ren/riqi 留痕 + 记业务日志，
|
* 把 baogao_zhuangtai 重置回空串、清空报告人/审核人/批准人等阶段字段（baogao_bianhao 保留），
|
* 并按报告当前状态把同流水号检验项推回：
|
* created → audit_rejected（重新录入）；pending_audit / audited → pending_audit（重新复核）。
|
* 报告处于 approved / 其它状态时不允许退回。
|
*
|
* @param qingyandanId 请验单 id
|
* @return true 更新成功；false 状态不符 / 不存在 / 已软删
|
*/
|
boolean rejectReport(String qingyandanId, String tuihuiYuanyin);
|
|
/**
|
* “审核通过”动作（baogao_zhuangtai: pending_audit → audited）：
|
* 写 baogao_shenhe_ren=当前用户、baogao_shenhe_riqi=当前时间。
|
*/
|
boolean auditPassReport(String qingyandanId);
|
|
/**
|
* “批准”动作（baogao_zhuangtai: audited → approved）：
|
* 写 baogao_pizhun_ren=当前用户、baogao_pizhun_riqi=当前时间。
|
*/
|
boolean approveReport(String qingyandanId);
|
}
|
