package cn.iocoder.yudao.module.crm.service.contract;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractPageReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractSaveReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractTransferReqVO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractProductDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO;
|
import jakarta.validation.Valid;
|
|
import java.time.LocalDateTime;
|
import java.util.Collection;
|
import java.util.List;
|
import java.util.Map;
|
import java.util.Set;
|
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
|
|
/**
|
* CRM 合同 Service 接口
|
*
|
* @author dhb52
|
*/
|
public interface CrmContractService {
|
|
/**
|
* 创建合同
|
*
|
* @param createReqVO 创建信息
|
* @param userId 用户编号
|
* @return 编号
|
*/
|
Long createContract(@Valid CrmContractSaveReqVO createReqVO, Long userId);
|
|
/**
|
* 更新合同
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateContract(@Valid CrmContractSaveReqVO updateReqVO);
|
|
/**
|
* 删除合同
|
*
|
* @param id 编号
|
*/
|
void deleteContract(Long id);
|
|
/**
|
* 合同转移
|
*
|
* @param reqVO 请求
|
* @param userId 用户编号
|
*/
|
void transferContract(CrmContractTransferReqVO reqVO, Long userId);
|
|
/**
|
* 更新合同相关的更进信息
|
*
|
* @param id 合同编号
|
* @param contactNextTime 下次联系时间
|
* @param contactLastContent 最后联系内容
|
*/
|
void updateContractFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent);
|
|
/**
|
* 提交合同审批（未提交 / 审核不通过 → 审批中）
|
*
|
* 审批人由「系统管理 - 审批配置」按业务类型统一配置（业务编码 contract_approve），
|
* 提交时无需指定；未启用审批或未配置有效审批人时抛出业务异常。
|
*
|
* @param id 合同编号
|
*/
|
void submitContract(Long id);
|
|
/**
|
* 获得合同审批的审批人编号集合
|
*
|
* 供前端判断当前登录用户是否应展示「审核」按钮；未配置时返回空集合。
|
*
|
* @return 审批人用户编号集合
|
*/
|
Set<Long> getContractApproverUserIds();
|
|
/**
|
* 审核合同（审批中 → 审核通过 / 审核不通过）
|
*
|
* 仅业务编码 contract_approve 配置的审批人可操作（多人时或签）；审核不通过时必须填写不通过原因。
|
*
|
* @param id 合同编号
|
* @param pass 是否通过：true=审核通过 / false=审核不通过
|
* @param reviewRemark 审核意见（不通过时即不通过原因，必填）
|
*/
|
void auditContract(Long id, Boolean pass, String reviewRemark);
|
|
/**
|
* 获得合同
|
*
|
* @param id 编号
|
* @return 合同
|
*/
|
CrmContractDO getContract(Long id);
|
|
/**
|
* 校验合同是否合法
|
*
|
* @param id 编号
|
* @return 合同
|
*/
|
CrmContractDO validateContract(Long id);
|
|
/**
|
* 获得合同列表
|
*
|
* @param ids 编号
|
* @return 合同列表
|
*/
|
List<CrmContractDO> getContractList(Collection<Long> ids);
|
|
/**
|
* 获得合同 Map
|
*
|
* @param ids 编号
|
* @return 合同 Map
|
*/
|
default Map<Long, CrmContractDO> getContractMap(Collection<Long> ids) {
|
return convertMap(getContractList(ids), CrmContractDO::getId);
|
}
|
|
/**
|
* 获得合同分页
|
*
|
* 数据权限：基于 {@link CrmContractDO} 读取
|
*
|
* @param pageReqVO 分页查询
|
* @param userId 用户编号
|
* @return 合同分页
|
*/
|
PageResult<CrmContractDO> getContractPage(CrmContractPageReqVO pageReqVO, Long userId);
|
|
/**
|
* 获得合同分页，基于指定客户
|
*
|
* 数据权限：基于 {@link CrmCustomerDO} 读取
|
*
|
* @param pageReqVO 分页查询
|
* @return 合同分页
|
*/
|
PageResult<CrmContractDO> getContractPageByCustomerId(CrmContractPageReqVO pageReqVO);
|
|
/**
|
* 获得合同分页，基于指定商机
|
*
|
* 数据权限：基于 {@link CrmBusinessDO} 读取
|
*
|
* @param pageReqVO 分页查询
|
* @return 合同分页
|
*/
|
PageResult<CrmContractDO> getContractPageByBusinessId(CrmContractPageReqVO pageReqVO);
|
|
/**
|
* 查询属于某个联系人的合同数量
|
*
|
* @param contactId 联系人ID
|
* @return 合同
|
*/
|
Long getContractCountByContactId(Long contactId);
|
|
/**
|
* 获取关联客户的合同数量
|
*
|
* @param customerId 客户编号
|
* @return 数量
|
*/
|
Long getContractCountByCustomerId(Long customerId);
|
|
/**
|
* 根据商机编号，获取关联客户的合同数量
|
*
|
* @param businessId 商机编号
|
* @return 数量
|
*/
|
Long getContractCountByBusinessId(Long businessId);
|
|
/**
|
* 根据合同编号，获得合同的产品列表
|
*
|
* @param contactId 合同编号
|
* @return 产品列表
|
*/
|
List<CrmContractProductDO> getContractProductListByContractId(Long contactId);
|
|
/**
|
* 获得待审核合同数量
|
*
|
* @param userId 用户编号
|
* @return 提醒数量
|
*/
|
Long getAuditContractCount(Long userId);
|
|
/**
|
* 获得即将到期（提醒）的合同数量
|
*
|
* @param userId 用户编号
|
* @return 提醒数量
|
*/
|
Long getRemindContractCount(Long userId);
|
|
/**
|
* 获得合同列表
|
*
|
* @param customerId 客户编号
|
* @param ownerUserId 负责人编号
|
* @return 合同列表
|
*/
|
List<CrmContractDO> getContractListByCustomerIdOwnerUserId(Long customerId, Long ownerUserId);
|
|
/**
|
* 根据合同生成销售订单
|
*
|
* @param id 合同编号
|
* @param userId 用户编号
|
* @return 销售订单编号
|
*/
|
Long generateSaleOrder(Long id, Long userId);
|
|
/**
|
* 更新合同状态
|
*
|
* @param id 合同编号
|
* @param status 状态
|
*/
|
void updateContractStatus(Long id, Integer status);
|
|
/**
|
* 根据销售订单编号更新合同状态
|
*
|
* @param orderId 销售订单编号
|
* @param status 状态
|
*/
|
void updateContractStatusByOrderId(Long orderId, Integer status);
|
|
}
|
