| | |
|---|
| | | import cn.iocoder.yudao.module.mes.dal.dataobject.wm.miscreceipt.MesWmMiscReceiptDO; |
|---|
| | | import jakarta.validation.Valid; |
|---|
| | | |
|---|
| | | import java.util.Set; |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * MES 杂项入库单 Service 接口 |
|---|
| | | * |
|---|
| | | * @author 芋道源码 |
|---|
| | | * @author 超级管理员 |
|---|
| | | */ |
|---|
| | | public interface MesWmMiscReceiptService { |
|---|
| | | |
|---|
| | |
|---|
| | | PageResult<MesWmMiscReceiptDO> getMiscReceiptPage(MesWmMiscReceiptPageReqVO pageReqVO); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 提交审批（草稿 → 已审批） |
|---|
| | | * 提交杂项入库单审批（草稿 → 审批中） |
|---|
| | | * |
|---|
| | | * 审核人由「系统管理 - 审批配置」按业务类型统一配置（业务编码 misc_receipt_approve）， |
|---|
| | | * 提交时无需指定；未启用审批或未配置有效审核人时抛出业务异常。 |
|---|
| | | * |
|---|
| | | * @param id 编号 |
|---|
| | | */ |
|---|
| | | void submitMiscReceipt(Long id); |
|---|
| | | void submitMiscReceiptApproval(Long id); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 获得杂项入库单审批的审核人编号集合 |
|---|
| | | * |
|---|
| | | * 供前端判断当前登录用户是否应展示「审核」按钮；未配置时返回空集合。 |
|---|
| | | * |
|---|
| | | * @return 审核人用户编号集合 |
|---|
| | | */ |
|---|
| | | Set<Long> getMiscReceiptApproverUserIds(); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 审核杂项入库单（审批中 → 已审批 / 草稿） |
|---|
| | | * |
|---|
| | | * 仅业务编码 misc_receipt_approve 配置的审核人可操作（多人时或签），且仅在审批中状态下允许。 |
|---|
| | | * 审核通过置为已审批（可执行入库）；审核不通过必须填写原因，退回草稿可修改后重新提交。 |
|---|
| | | * |
|---|
| | | * @param id 编号 |
|---|
| | | * @param pass 是否通过，true=通过 / false=不通过 |
|---|
| | | * @param reviewRemark 审核意见，审核不通过时必填 |
|---|
| | | */ |
|---|
| | | void auditMiscReceipt(Long id, Boolean pass, String reviewRemark); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 执行入库（已审批 → 已完成），更新库存台账 |
|---|
