package jnpf.limsService;

import jnpf.base.service.SuperService;
import jnpf.exception.DataException;
import jnpf.limsEntity.LimsHaocaiChukuEntity;
import jnpf.limsEntity.LimsHaocaiChukuShenqingZixiangEntity;
import jnpf.limsEntity.LimsHaocaiJiechuEntity;
import jnpf.limsEntity.LimsHaocaiRukuEntity;
import jnpf.limsEntity.LimsHaocaiRukuSubmitResult;
import jnpf.limsEntity.LimsHaocaiRukuZixiangEntity;

import java.util.List;

/**
 * 耗材业务服务：出入库等耗材相关逻辑统一放这里（按需要再拆分）。
 * 主表挂 lims_haocai_ruku，子表 lims_haocai_ruku_zixiang 经 Mapper 直接读写。
 */
public interface LimsHaocaiService extends SuperService<LimsHaocaiRukuEntity> {

    /**
     * 入库提交：按主表数据取条码号并批量生成子表记录。
     *
     * <p>是否一个条码 = yes：插 1 条，总量 = 入库数量 × 容量；
     * 否则整数数量部分每单位插 1 条，小数部分按容量比例插入最后 1 条。编号 = 条码编码-序号。
     * 不防重：重复调用会生成新条码的新一批记录。
     *
     * @param ruku 已查出的主表记录
     * @return 本批条码与编号列表
     * @throws DataException 主表数据无效（数量/容量解析失败）或条码取号失败
     */
    LimsHaocaiRukuSubmitResult submitRuku(LimsHaocaiRukuEntity ruku) throws DataException;

    /**
     * 耗材借出：按条码编码标记入库批次为已出库，并写入耗材借出日志。
     *
     * <p>不写入 lims_haocai_jiechu，在线表单提交会自动保存借出单。
     *
     * @param jiechu 借出表单数据
     * @throws DataException 条码为空、批次不存在或已出库时抛出
     */
    void submitJiechu(LimsHaocaiJiechuEntity jiechu) throws DataException;

    /**
     * 耗材归还：按条码编码找到已借出的借出单，标记为已归还；
     * 同步将入库批次状态恢复为未出库，并写入耗材归还日志。
     *
     * @param guihuan 归还表单数据
     * @throws DataException 条码为空、无已借出记录或批次不存在时抛出
     */
    void submitGuihuan(LimsHaocaiJiechuEntity guihuan) throws DataException;

    /**
     * 耗材出库：按表单子表条码扣减入库批次剩余量，标记申领子项已出库并写日志。
     *
     * <p>不写入 lims_haocai_chuku / lims_haocai_chuku_zixiang，在线表单提交会自动保存出库单。
     *
     * @param chuku 出库表单数据
     * @throws DataException 表单数据为空、条码/数量无效或库存状态不满足时抛出
     */
    void submitChuku(LimsHaocaiChukuEntity chuku) throws DataException;

    /**
     * 耗材销毁：按销毁单号读取申请与子表条码，销毁对应入库批次并写日志。
     *
     * @param xiaohuiDanhao 销毁单号
     * @throws DataException 单号为空、申请不存在、子表为空或条码无效时抛出
     */
    void submitXiaohui(String xiaohuiDanhao) throws DataException;

    /**
     * 批量转待销毁：按入库主表主键批量查关联子项，仅将剩余量大于 0 的子项改为待销毁。
     *
     * @param rukuIds 入库主表主键列表（lims_haocai_ruku.f_id）
     * @return 实际更新的子项记录数
     * @throws DataException 主键列表为空时抛出
     */
    int batchMarkRukuZixiangDaixiaohui(List<String> rukuIds) throws DataException;

    /**
     * 耗材销毁申请发起：按流程参数读取销毁申请主表与子表条码，
     * 将对应入库子项标记为待销毁并写入销毁单号。
     *
     * @param flowId 流程 id（lims_haocai_xiaohui_shenqing.f_flow_id）
     * @param taskId 流程任务 id（lims_haocai_xiaohui_shenqing.f_flow_task_id）
     * @return 实际更新的入库子项记录数
     * @throws DataException 流程参数为空、申请不存在、子表为空或条码无效时抛出
     */
    int startXiaohuiShenqing(String flowId, String taskId) throws DataException;

    /**
     * 按条码编码查询入库子项记录。
     *
     * @param tiaomaBianma 条码编码
     * @return 未删除的匹配子项；条码编码应唯一
     */
    List<LimsHaocaiRukuZixiangEntity> listRukuZixiangByTiaomaBianma(String tiaomaBianma);

    /**
     * 根据申领单号和条码编码查询可出库的申领子项。
     *
     * @param shenlingDanhao 申领单号
     * @param tiaomaBianma 条码编码
     * @return 已校验可出库且属于该申领单的申领子项
     * @throws DataException 条码不存在、状态/剩余量不满足、申领单不存在或未通过时抛出
     */
    LimsHaocaiChukuShenqingZixiangEntity getChukuShenqingZixiangForChuku(String shenlingDanhao,
                                                                         String tiaomaBianma) throws DataException;

    /**
     * 耗材入库验收提交：按流程定位验收记录，并将其主键回写至关联验收申请。
     *
     * @param flowId 验收记录流程 id（lims_haocai_ruku_yanshou.f_flow_id）
     * @param taskId 验收记录流程任务 id（lims_haocai_ruku_yanshou.f_flow_task_id）
     * @throws DataException 流程参数为空、验收记录或关联申请不存在时抛出
     */
    void submitRukuYanshou(String flowId, String taskId) throws DataException;

    /**
     * 耗材入库验收完成：根据验收记录流程状态更新或重置关联验收申请。
     *
     * @param flowId 验收记录流程 id（lims_haocai_ruku_yanshou.f_flow_id）
     * @param taskId 验收记录流程任务 id（lims_haocai_ruku_yanshou.f_flow_task_id）
     * @throws DataException 流程参数为空、验收记录或关联申请不存在时抛出
     */
    void finishRukuYanshou(String flowId, String taskId) throws DataException;

    /**
     * 领取待验收的耗材验收申请，并将其置为验收中。
     *
     * @param shenqingId 耗材验收申请主键（lims_haocai_yanshou_shenqing.f_id）
     * @throws DataException 申请不存在、已删除或当前不是待验收状态时抛出
     */
    void lingquYanshouShenqing(String shenqingId) throws DataException;
}