package cn.iocoder.yudao.module.crm.controller.admin.receivable;
|
|
import cn.hutool.core.collection.CollUtil;
|
import cn.hutool.core.lang.Assert;
|
import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
|
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
|
import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
|
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
|
import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractRespVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.invoice.vo.invoice.CrmInvoiceRespVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable.CrmReceivableItemRespVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable.CrmReceivablePageReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable.CrmReceivableRespVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable.CrmReceivableSaveReqVO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.invoice.CrmInvoiceDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.receivable.CrmReceivableDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.receivable.CrmReceivableItemDO;
|
import cn.iocoder.yudao.module.crm.enums.receivable.CrmReceivableBizTypeEnum;
|
import cn.iocoder.yudao.module.crm.service.contract.CrmContractService;
|
import cn.iocoder.yudao.module.crm.service.customer.CrmCustomerService;
|
import cn.iocoder.yudao.module.crm.service.invoice.CrmInvoiceService;
|
import cn.iocoder.yudao.module.crm.service.receivable.CrmReceivableService;
|
import cn.iocoder.yudao.module.system.api.dept.DeptApi;
|
import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
|
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
|
import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
|
import io.swagger.v3.oas.annotations.Operation;
|
import io.swagger.v3.oas.annotations.Parameter;
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
import jakarta.annotation.Resource;
|
import jakarta.servlet.http.HttpServletResponse;
|
import jakarta.validation.Valid;
|
import org.springframework.security.access.prepost.PreAuthorize;
|
import org.springframework.validation.annotation.Validated;
|
import org.springframework.web.bind.annotation.*;
|
|
import java.io.IOException;
|
import java.util.Collections;
|
import java.util.List;
|
import java.util.Map;
|
import java.util.stream.Stream;
|
|
import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
|
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
|
import static cn.iocoder.yudao.framework.common.pojo.PageParam.PAGE_SIZE_NONE;
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertListByFlatMap;
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
|
import static cn.iocoder.yudao.framework.common.util.collection.MapUtils.findAndThen;
|
import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
|
|
@Tag(name = "管理后台 - CRM 回款")
|
@RestController
|
@RequestMapping("/crm/receivable")
|
@Validated
|
public class CrmReceivableController {
|
|
@Resource
|
private CrmReceivableService receivableService;
|
@Resource
|
private CrmContractService contractService;
|
@Resource
|
private CrmCustomerService customerService;
|
@Resource
|
private CrmInvoiceService invoiceService;
|
|
@Resource
|
private AdminUserApi adminUserApi;
|
@Resource
|
private DeptApi deptApi;
|
|
@PostMapping("/create")
|
@Operation(summary = "创建回款")
|
@PreAuthorize("@ss.hasPermission('crm:receivable:create')")
|
public CommonResult<Long> createReceivable(@Valid @RequestBody CrmReceivableSaveReqVO createReqVO) {
|
return success(receivableService.createReceivable(createReqVO));
|
}
|
|
@PutMapping("/update")
|
@Operation(summary = "更新回款")
|
@PreAuthorize("@ss.hasPermission('crm:receivable:update')")
|
public CommonResult<Boolean> updateReceivable(@Valid @RequestBody CrmReceivableSaveReqVO updateReqVO) {
|
receivableService.updateReceivable(updateReqVO);
|
return success(true);
|
}
|
|
@DeleteMapping("/delete")
|
@Operation(summary = "删除回款")
|
@Parameter(name = "id", description = "编号", required = true)
|
@PreAuthorize("@ss.hasPermission('crm:receivable:delete')")
|
public CommonResult<Boolean> deleteReceivable(@RequestParam("id") Long id) {
|
receivableService.deleteReceivable(id);
|
return success(true);
|
}
|
|
@GetMapping("/get")
|
@Operation(summary = "获得回款")
|
@Parameter(name = "id", description = "编号", required = true, example = "1024")
|
public CommonResult<CrmReceivableRespVO> getReceivable(@RequestParam("id") Long id) {
|
CrmReceivableDO receivable = receivableService.getReceivable(id);
|
return success(buildReceivableDetail(receivable));
|
}
|
|
private CrmReceivableRespVO buildReceivableDetail(CrmReceivableDO receivable) {
|
if (receivable == null) {
|
return null;
|
}
|
return buildReceivableDetailList(Collections.singletonList(receivable)).get(0);
|
}
|
|
@GetMapping("/page")
|
@Operation(summary = "获得回款分页")
|
public CommonResult<PageResult<CrmReceivableRespVO>> getReceivablePage(@Valid CrmReceivablePageReqVO pageReqVO) {
|
PageResult<CrmReceivableDO> pageResult = receivableService.getReceivablePage(pageReqVO, getLoginUserId());
|
return success(new PageResult<>(buildReceivableDetailList(pageResult.getList()), pageResult.getTotal()));
|
}
|
|
@GetMapping("/page-by-customer")
|
@Operation(summary = "获得回款分页，基于指定客户")
|
public CommonResult<PageResult<CrmReceivableRespVO>> getReceivablePageByCustomer(@Valid CrmReceivablePageReqVO pageReqVO) {
|
Assert.notNull(pageReqVO.getCustomerId(), "客户编号不能为空");
|
PageResult<CrmReceivableDO> pageResult = receivableService.getReceivablePageByCustomerId(pageReqVO);
|
return success(new PageResult<>(buildReceivableDetailList(pageResult.getList()), pageResult.getTotal()));
|
}
|
|
@GetMapping("/export-excel")
|
@Operation(summary = "导出回款 Excel")
|
@PreAuthorize("@ss.hasPermission('crm:receivable:export')")
|
@ApiAccessLog(operateType = EXPORT)
|
public void exportReceivableExcel(@Valid CrmReceivablePageReqVO exportReqVO,
|
HttpServletResponse response) throws IOException {
|
exportReqVO.setPageSize(PAGE_SIZE_NONE);
|
List<CrmReceivableDO> list = receivableService.getReceivablePage(exportReqVO, getLoginUserId()).getList();
|
// 导出 Excel
|
ExcelUtils.write(response, "回款.xls", "数据", CrmReceivableRespVO.class,
|
buildReceivableDetailList(list));
|
}
|
|
private List<CrmReceivableRespVO> buildReceivableDetailList(List<CrmReceivableDO> receivableList) {
|
if (CollUtil.isEmpty(receivableList)) {
|
return Collections.emptyList();
|
}
|
// 1.1 获取客户列表
|
Map<Long, CrmCustomerDO> customerMap = customerService.getCustomerMap(
|
convertSet(receivableList, CrmReceivableDO::getCustomerId));
|
// 1.2 获取创建人、负责人列表
|
Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(convertListByFlatMap(receivableList,
|
contact -> Stream.of(NumberUtils.parseLong(contact.getCreator()), contact.getOwnerUserId())));
|
Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(userMap.values(), AdminUserRespDTO::getDeptId));
|
// 1.3 获得合同列表
|
Map<Long, CrmContractDO> contractMap = contractService.getContractMap(
|
convertSet(receivableList, CrmReceivableDO::getContractId));
|
// 1.4 获得关联开票列表
|
Map<Long, CrmInvoiceDO> invoiceMap = invoiceService.getInvoiceMap(
|
convertSet(receivableList, CrmReceivableDO::getInvoiceId));
|
// 2. 拼接结果
|
return BeanUtils.toBean(receivableList, CrmReceivableRespVO.class, (receivableVO) -> {
|
// 2.1 拼接客户名称
|
findAndThen(customerMap, receivableVO.getCustomerId(), customer -> receivableVO.setCustomerName(customer.getName()));
|
// 2.2 拼接负责人、创建人名称
|
MapUtils.findAndThen(userMap, NumberUtils.parseLong(receivableVO.getCreator()),
|
user -> receivableVO.setCreatorName(user.getNickname()));
|
MapUtils.findAndThen(userMap, receivableVO.getOwnerUserId(), user -> {
|
receivableVO.setOwnerUserName(user.getNickname());
|
MapUtils.findAndThen(deptMap, user.getDeptId(), dept -> receivableVO.setOwnerUserDeptName(dept.getName()));
|
});
|
// 2.3 拼接合同信息
|
findAndThen(contractMap, receivableVO.getContractId(), contract ->
|
receivableVO.setContract(BeanUtils.toBean(contract, CrmContractRespVO.class)));
|
// 2.4 拼接关联开票信息
|
findAndThen(invoiceMap, receivableVO.getInvoiceId(), invoice ->
|
receivableVO.setInvoice(BeanUtils.toBean(invoice, CrmInvoiceRespVO.class)));
|
});
|
}
|
|
@PutMapping("/submit")
|
@Operation(summary = "提交回款审批")
|
@PreAuthorize("@ss.hasPermission('crm:receivable:update')")
|
public CommonResult<Boolean> submitReceivable(@RequestParam("id") Long id,
|
@RequestParam(value = "remark", required = false) String remark) {
|
receivableService.submitReceivable(id, remark, getLoginUserId());
|
return success(true);
|
}
|
|
@PutMapping("/update-status")
|
@Operation(summary = "更新回款的状态（审核/反审核）")
|
@PreAuthorize("@ss.hasPermission('crm:receivable:update')")
|
public CommonResult<Boolean> updateReceivableStatus(@RequestParam("id") Long id,
|
@RequestParam("status") Integer status) {
|
receivableService.updateReceivableStatus(id, status);
|
return success(true);
|
}
|
|
@GetMapping("/audit-count")
|
@Operation(summary = "获得待审核回款数量")
|
public CommonResult<Long> getAuditReceivableCount() {
|
return success(receivableService.getAuditReceivableCount(getLoginUserId()));
|
}
|
|
@GetMapping("/item-list")
|
@Operation(summary = "获得回款的核销明细")
|
@Parameter(name = "receivableId", description = "回款编号", required = true)
|
public CommonResult<List<CrmReceivableItemRespVO>> getReceivableItemList(@RequestParam("receivableId") Long receivableId) {
|
CrmReceivableDO receivable = receivableService.getReceivable(receivableId);
|
return success(buildReceivableItemList(receivableService.getReceivableItemList(receivableId),
|
receivable == null ? Collections.emptyList() : Collections.singletonList(receivable)));
|
}
|
|
@GetMapping("/item-list-by-customer")
|
@Operation(summary = "获得客户下全部回款的核销明细")
|
@Parameter(name = "customerId", description = "客户编号", required = true)
|
@PreAuthorize("@ss.hasPermission('crm:receivable:query')")
|
public CommonResult<List<CrmReceivableItemRespVO>> getReceivableItemListByCustomerId(
|
@RequestParam("customerId") Long customerId) {
|
List<CrmReceivableItemDO> items = receivableService.getReceivableItemListByCustomerId(customerId);
|
if (CollUtil.isEmpty(items)) {
|
return success(Collections.emptyList());
|
}
|
Map<Long, CrmReceivableDO> receivableMap = receivableService.getReceivableMap(
|
convertSet(items, CrmReceivableItemDO::getReceivableId));
|
return success(buildReceivableItemList(items, receivableMap.values()));
|
}
|
|
private List<CrmReceivableItemRespVO> buildReceivableItemList(List<CrmReceivableItemDO> items,
|
java.util.Collection<CrmReceivableDO> receivables) {
|
if (CollUtil.isEmpty(items)) {
|
return Collections.emptyList();
|
}
|
Map<Long, CrmReceivableDO> receivableMap = receivables.stream()
|
.collect(java.util.stream.Collectors.toMap(CrmReceivableDO::getId, item -> item, (a, b) -> a));
|
return BeanUtils.toBean(items, CrmReceivableItemRespVO.class, vo -> {
|
vo.setBizTypeName(CrmReceivableBizTypeEnum.getNameByType(vo.getBizType()));
|
CrmReceivableDO receivable = receivableMap.get(vo.getReceivableId());
|
if (receivable != null) {
|
vo.setReceivableNo(receivable.getNo());
|
vo.setCustomerId(receivable.getCustomerId());
|
vo.setReturnTime(receivable.getReturnTime());
|
}
|
});
|
}
|
|
}
|
