| | |
|---|
| | | import cn.iocoder.yudao.module.mes.controller.admin.pd.techconfirm.vo.ProductTechConfirmSaveReqVO; |
|---|
| | | import cn.iocoder.yudao.module.mes.dal.dataobject.pd.techconfirm.ProductTechConfirmDO; |
|---|
| | | |
|---|
| | | import java.util.Set; |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * MES 产品技术确认函 Service 接口 |
|---|
| | | * |
|---|
| | | * 状态流转完全由业务流程驱动，不接受前端直接指定状态： |
|---|
| | | * <pre> |
|---|
| | | * 0 草稿 --提交审核--> 1 待审核 --审核通过--> 2 已审核 --客户确认--> 3 客户已确认 |
|---|
| | | * ^ | |
|---|
| | | * | +--审核不通过--> 4 审核不通过 |
|---|
| | | * | | |
|---|
| | | * +----------------------------------------+ 审核不通过可修改后重新提交 |
|---|
| | | * </pre> |
|---|
| | | * 只有草稿与审核不通过状态允许修改业务字段，待审核 / 已审核 / 客户已确认为锁定或终态。 |
|---|
| | | * |
|---|
| | | * @author 超级管理员 |
|---|
| | | */ |
|---|
| | | public interface ProductTechConfirmService { |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 创建技术确认函 |
|---|
| | | * |
|---|
| | | * 状态固定为草稿，编制人 / 编制时间取当前登录用户与当前时间。 |
|---|
| | | * |
|---|
| | | * @param createReqVO 创建信息 |
|---|
| | | * @return 编号 |
|---|
| | | */ |
|---|
| | | Long createTechConfirm(ProductTechConfirmSaveReqVO createReqVO); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 修改技术确认函 |
|---|
| | | * |
|---|
| | | * 仅草稿与审核不通过状态允许修改，其余状态一律拒绝。 |
|---|
| | | * |
|---|
| | | * @param updateReqVO 修改信息 |
|---|
| | | */ |
|---|
| | | void updateTechConfirm(ProductTechConfirmSaveReqVO updateReqVO); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 删除技术确认函 |
|---|
| | | * |
|---|
| | | * 仅草稿与审核不通过状态允许删除。 |
|---|
| | | * |
|---|
| | | * @param id 编号 |
|---|
| | | */ |
|---|
| | | void deleteTechConfirm(Long id); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 获得技术确认函 |
|---|
| | | * |
|---|
| | | * @param id 编号 |
|---|
| | | * @return 技术确认函 |
|---|
| | | */ |
|---|
| | | ProductTechConfirmDO getTechConfirm(Long id); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 获得技术确认函分页 |
|---|
| | | * |
|---|
| | | * @param pageReqVO 分页查询 |
|---|
| | | * @return 技术确认函分页 |
|---|
| | | */ |
|---|
| | | PageResult<ProductTechConfirmDO> getTechConfirmPage(ProductTechConfirmPageReqVO pageReqVO); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 提交审核（草稿 / 审核不通过 → 待审核） |
|---|
| | | * |
|---|
| | | * 审核人由「系统管理 - 审批配置」按业务类型统一配置（业务编码 pd_tech_confirm_approve）， |
|---|
| | | * 提交时无需指定；未启用审批或未配置有效审核人时抛出业务异常。 |
|---|
| | | * |
|---|
| | | * @param id 编号 |
|---|
| | | */ |
|---|
| | | void submitTechConfirmAudit(Long id); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 获得技术确认函审核的审核人编号集合 |
|---|
| | | * |
|---|
| | | * 供前端判断当前登录用户是否应展示「审核」按钮；未配置时返回空集合。 |
|---|
| | | * |
|---|
| | | * @return 审核人用户编号集合 |
|---|
| | | */ |
|---|
| | | Set<Long> getTechConfirmApproverUserIds(); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 审核技术确认函（待审核 → 已审核 / 审核不通过） |
|---|
| | | * |
|---|
| | | * 仅业务编码 pd_tech_confirm_approve 配置的审核人可操作（多人时或签），且仅在待审核状态下允许。 |
|---|
| | | * 审核通过记录审核人与审核时间；审核不通过必须填写不通过原因， |
|---|
| | | * 使单据退回可修改状态，由编制人修改后重新提交。 |
|---|
| | | * |
|---|
| | | * @param id 编号 |
|---|
| | | * @param pass 是否通过，true=通过 / false=不通过 |
|---|
| | | * @param reviewRemark 审核意见，审核不通过时必填 |
|---|
| | | */ |
|---|
| | | void auditTechConfirm(Long id, Boolean pass, String reviewRemark); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 客户确认（已审核 → 客户已确认） |
|---|
| | | * |
|---|
| | | * 由业务员代客户执行，记录客户确认人与客户确认时间。 |
|---|
| | | * |
|---|
| | | * @param id 编号 |
|---|
| | | * @param customerConfirmUser 客户确认人姓名 |
|---|
| | | */ |
|---|
| | | void confirmTechConfirmByCustomer(Long id, String customerConfirmUser); |
|---|
| | | |
|---|
| | | } |
|---|
