package jnpf.limsService;

import jnpf.base.service.SuperService;
import jnpf.exception.DataException;
import jnpf.limsEntity.LimsShebeiYiqiXinxiEntity;

import java.time.LocalDateTime;
import java.util.List;

public interface LimsShebeiYiqiXinxiService extends SuperService<LimsShebeiYiqiXinxiEntity> {

    /**
     * 将设备仪器状态标记为已报废。
     *
     * @param yiqiId 设备仪器信息主键（lims_shebei_yiqi_xinxi.f_id）
     * @throws DataException 主键为空、数据不存在或更新失败时抛出
     */
    void baofei(String yiqiId) throws DataException;

    /**
     * 批量将设备仪器性能状态标记为准用。
     *
     * @param yiqiIds 设备仪器信息主键列表（lims_shebei_yiqi_xinxi.f_id）
     * @return 实际更新的记录数
     * @throws DataException 主键列表为空或更新失败时抛出
     */
    int qiyong(List<String> yiqiIds) throws DataException;

    /**
     * 校验仪器在指定校准日期是否已有校准记录。
     *
     * @param yiqiId 设备仪器信息主键
     * @param jiaoyanShijian 校准时间
     * @throws DataException 主键、校准时间为空或当天已经校准时抛出
     */
    void checkTodayJiaoyan(String yiqiId, LocalDateTime jiaoyanShijian) throws DataException;

    /**
     * 校验仪器是否完成当日日常校准且未处于使用中。
     *
     * @param yiqiId 设备仪器信息主键
     * @throws DataException 仪器ID为空、未完成日常校准或仪器正在使用时抛出
     */
    void checkShiyong(String yiqiId) throws DataException;

    /**
     * 确认仪器验证，并将验证记录中的业务字段同步到关联仪器信息。
     *
     * @param yanzhengId 仪器验证主键（lims_shebei_yiqi_yanzheng.f_id）
     * @throws DataException 验证记录、关联仪器不存在或无可同步字段时抛出
     */
    void confirmYanzheng(String yanzhengId) throws DataException;

    /**
     * 确认仪器计量，并将计量记录中的业务字段同步到关联仪器信息。
     *
     * @param jiliangId 仪器计量主键（lims_shebei_yiqi_jiliang.f_id）
     * @throws DataException 计量记录、关联仪器不存在或无可同步字段时抛出
     */
    void confirmJiliang(String jiliangId) throws DataException;
}