Files
shanxia2.0/docs/crm-migration/reference/java/quote/controller/CrmQuoteController.java
T
2026-06-01 08:21:21 +08:00

384 lines
14 KiB
Java

package org.dromara.crm.controller;
import cn.dev33.satoken.annotation.SaCheckPermission;
import jakarta.servlet.http.HttpServletResponse;
import jakarta.validation.constraints.NotEmpty;
import jakarta.validation.constraints.NotNull;
import lombok.RequiredArgsConstructor;
import org.dromara.common.core.domain.R;
import org.dromara.common.core.validate.AddGroup;
import org.dromara.common.core.validate.EditGroup;
import org.dromara.common.excel.utils.ExcelUtil;
import org.dromara.common.idempotent.annotation.RepeatSubmit;
import org.dromara.common.log.annotation.Log;
import org.dromara.common.log.enums.BusinessType;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.common.web.core.BaseController;
import org.dromara.crm.domain.bo.CrmQuoteBo;
import org.dromara.crm.domain.vo.CrmQuoteVo;
import org.dromara.crm.service.ICrmQuoteService;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.Map;
/**
* 报价单管理Controller
*
* @author 系统管理员
* @date 2025-01-03
*/
@Validated
@RequiredArgsConstructor
@RestController
@RequestMapping("/crm/quote")
public class CrmQuoteController extends BaseController {
private final ICrmQuoteService quoteService;
/**
* 查询报价单列表(分页)
*/
// @SaCheckPermission("crm:quote:list")
@GetMapping("/list")
public TableDataInfo<CrmQuoteVo> list(CrmQuoteBo bo, PageQuery pageQuery) {
return quoteService.queryPageList(bo, pageQuery);
}
/**
* 查询报价单详情
*/
// @SaCheckPermission("crm:quote:query")
@GetMapping("/{id}")
public R<CrmQuoteVo> getInfo(@NotNull(message = "主键不能为空") @PathVariable Long id) {
return R.ok(quoteService.queryById(id));
}
/**
* 新增报价单
*/
// @SaCheckPermission("crm:quote:add")
@Log(title = "报价单管理", businessType = BusinessType.INSERT)
@RepeatSubmit()
@PostMapping()
public R<Long> add(@Validated(AddGroup.class) @RequestBody CrmQuoteBo bo) {
boolean success = quoteService.insertByBo(bo);
if (success) {
return R.ok("新增成功", bo.getId());
}
return R.fail("新增失败");
}
/**
* 修改报价单
*/
// @SaCheckPermission("crm:quote:edit")
@Log(title = "报价单管理", businessType = BusinessType.UPDATE)
@RepeatSubmit()
@PutMapping()
public R<Void> edit(@Validated(EditGroup.class) @RequestBody CrmQuoteBo bo) {
return toAjax(quoteService.updateByBo(bo));
}
/**
* 删除报价单
*/
// @SaCheckPermission("crm:quote:remove")
@Log(title = "报价单管理", businessType = BusinessType.DELETE)
@DeleteMapping("/{ids}")
public R<Void> remove(@NotEmpty(message = "主键不能为空") @PathVariable Long[] ids) {
return toAjax(quoteService.deleteWithValidByIds(List.of(ids), true));
}
/**
* 提交报价单
*/
// @SaCheckPermission("crm:quote:submit")
@Log(title = "提交报价单", businessType = BusinessType.UPDATE)
@RepeatSubmit()
@PutMapping("/submit")
public R<Void> submit(@RequestBody Map<String, Object> params) {
// 验证ID参数
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
// 安全转换approverIds,支持Integer、Long、String等类型
@SuppressWarnings("unchecked")
List<Object> approverIdsRaw = (List<Object>) params.get("approverIds");
List<Long> approverIds = null;
if (approverIdsRaw != null) {
approverIds = approverIdsRaw.stream()
.map(obj -> {
if (obj instanceof Number) {
return ((Number) obj).longValue();
} else {
return Long.valueOf(obj.toString());
}
})
.collect(java.util.stream.Collectors.toList());
}
String remark = (String) params.get("remark");
return toAjax(quoteService.submitQuote(id, approverIds, remark));
}
/**
* 保存报价单模板内容
*/
// @SaCheckPermission("crm:quote:edit")
@Log(title = "保存报价单模板", businessType = BusinessType.UPDATE)
@RepeatSubmit()
@PostMapping("/saveTemplate")
public R<Void> saveTemplate(@RequestBody Map<String, Object> params) {
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
String templateContent = (String) params.get("templateContent");
return toAjax(quoteService.saveTemplate(id, templateContent));
}
/**
* 获取报价单模板内容
*/
// @SaCheckPermission("crm:quote:query")
@GetMapping("/getTemplate/{id}")
public R<String> getTemplate(@NotNull(message = "主键不能为空") @PathVariable Long id) {
String templateContent = quoteService.getTemplate(id);
// 使用 R.ok(msg, data) 确保数据在 data 字段中
return R.ok("获取模板成功", templateContent);
}
/**
* 生成PDF
*/
// @SaCheckPermission("crm:quote:edit")
@Log(title = "生成PDF", businessType = BusinessType.UPDATE)
@PostMapping("/generatePdf")
public R<String> generatePdf(@RequestBody Map<String, Object> params) {
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
String pdfUrl = quoteService.generatePdf(id);
return R.ok(pdfUrl);
}
/**
* 生成分享链接
*/
// @SaCheckPermission("crm:quote:share")
@Log(title = "生成分享链接", businessType = BusinessType.UPDATE)
@PostMapping("/generateShare")
public R<String> generateShare(@RequestBody Map<String, Object> params) {
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
Integer validityDays = params.get("validityDays") != null
? Integer.valueOf(params.get("validityDays").toString())
: 7;
String password = (String) params.get("password");
String shareLink = quoteService.generateShare(id, validityDays, password);
return R.ok(shareLink);
}
/**
* 通过分享码查看报价单
*/
@GetMapping("/share/{shareCode}")
public R<CrmQuoteVo> viewByShareCode(@PathVariable String shareCode,
@RequestParam(required = false) String password,
jakarta.servlet.http.HttpServletRequest request) {
String ipAddress = getClientIp(request);
String userAgent = request.getHeader("User-Agent");
return R.ok(quoteService.viewByShareCode(shareCode, password, ipAddress, userAgent));
}
/**
* 获取客户端IP地址
*/
private String getClientIp(jakarta.servlet.http.HttpServletRequest request) {
String ip = request.getHeader("X-Forwarded-For");
if (ip == null || ip.isEmpty() || "unknown".equalsIgnoreCase(ip)) {
ip = request.getHeader("Proxy-Client-IP");
}
if (ip == null || ip.isEmpty() || "unknown".equalsIgnoreCase(ip)) {
ip = request.getHeader("WL-Proxy-Client-IP");
}
if (ip == null || ip.isEmpty() || "unknown".equalsIgnoreCase(ip)) {
ip = request.getRemoteAddr();
}
return ip;
}
/**
* 接受报价单
*/
// @SaCheckPermission("crm:quote:edit")
@Log(title = "接受报价单", businessType = BusinessType.UPDATE)
@PutMapping("/accept")
public R<Void> accept(@RequestBody Map<String, Object> params) {
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
String remark = (String) params.get("remark");
return toAjax(quoteService.acceptQuote(id, remark));
}
/**
* 拒绝报价单
*/
// @SaCheckPermission("crm:quote:edit")
@Log(title = "拒绝报价单", businessType = BusinessType.UPDATE)
@PutMapping("/reject")
public R<Void> reject(@RequestBody Map<String, Object> params) {
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
String rejectReason = (String) params.get("rejectReason");
String remark = (String) params.get("remark");
return toAjax(quoteService.rejectQuote(id, rejectReason, remark));
}
/**
* 转为合同
*/
// @SaCheckPermission("crm:quote:toContract")
@Log(title = "转为合同", businessType = BusinessType.INSERT)
@PostMapping("/toContract")
public R<Long> toContract(@RequestBody Map<String, Object> params) {
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
String contractNo = (String) params.get("contractNo");
String contractTitle = (String) params.get("contractTitle");
// 可选参数
java.time.LocalDate signDate = params.get("signDate") != null
? java.time.LocalDate.parse(params.get("signDate").toString())
: null;
java.time.LocalDate startDate = params.get("startDate") != null
? java.time.LocalDate.parse(params.get("startDate").toString())
: null;
java.time.LocalDate endDate = params.get("endDate") != null
? java.time.LocalDate.parse(params.get("endDate").toString())
: null;
Long contractId = quoteService.toContract(id, contractNo, contractTitle, signDate, startDate, endDate);
return R.ok(contractId);
}
/**
* 创建新版本
*/
// @SaCheckPermission("crm:quote:add")
@Log(title = "创建新版本", businessType = BusinessType.INSERT)
@PostMapping("/newVersion")
public R<Long> newVersion(@RequestBody Map<String, Object> params) {
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
String version = (String) params.get("version");
String remark = (String) params.get("remark");
Long newId = quoteService.createNewVersion(id, version, remark);
return R.ok(newId);
}
/**
* 查询版本历史
*/
// @SaCheckPermission("crm:quote:query")
@GetMapping("/versions")
public R<List<CrmQuoteVo>> queryVersions(@RequestParam String quoteNo) {
return R.ok(quoteService.queryVersions(quoteNo));
}
/**
* 导出报价单列表
*/
// @SaCheckPermission("crm:quote:export")
@Log(title = "报价单管理", businessType = BusinessType.EXPORT)
@PostMapping("/export")
public void export(CrmQuoteBo bo, HttpServletResponse response) {
List<CrmQuoteVo> list = quoteService.queryList(bo);
ExcelUtil.exportExcel(list, "报价单数据", CrmQuoteVo.class, response);
}
/**
* 报价单统计概览
*/
// @SaCheckPermission("crm:quote:list")
@GetMapping("/statistics/overview")
public R<Map<String, Object>> statisticsOverview(@RequestParam(required = false) Long ownerUserId,
@RequestParam(required = false) String beginTime,
@RequestParam(required = false) String endTime) {
return R.ok(quoteService.statisticsOverview(ownerUserId, beginTime, endTime));
}
/**
* 报价单状态分布
*/
// @SaCheckPermission("crm:quote:list")
@GetMapping("/statistics/status")
public R<List<Map<String, Object>>> statisticsStatus() {
return R.ok(quoteService.statisticsStatus());
}
/**
* 报价单趋势分析
*/
// @SaCheckPermission("crm:quote:list")
@GetMapping("/statistics/trend")
public R<List<Map<String, Object>>> statisticsTrend(@RequestParam(defaultValue = "month") String type,
@RequestParam(required = false) String beginTime,
@RequestParam(required = false) String endTime) {
return R.ok(quoteService.statisticsTrend(type, beginTime, endTime));
}
/**
* 撤回审批
*/
// @SaCheckPermission("crm:quote:edit")
@Log(title = "撤回审批", businessType = BusinessType.UPDATE)
@PutMapping("/withdrawApproval")
public R<Void> withdrawApproval(@RequestBody Map<String, Object> params) {
Long id = Long.valueOf(params.get("id").toString());
String remark = (String) params.get("remark");
return toAjax(quoteService.withdrawApproval(id, remark));
}
/**
* 作废报价单
*/
// @SaCheckPermission("crm:quote:invalid")
@Log(title = "作废报价单", businessType = BusinessType.UPDATE)
@PutMapping("/invalid")
public R<Void> invalid(@RequestBody Map<String, Object> params) {
Object idObj = params.get("id");
if (idObj == null) {
return R.fail("报价单ID不能为空");
}
Long id = Long.valueOf(idObj.toString());
String remark = (String) params.get("remark");
return toAjax(quoteService.invalidQuote(id, remark));
}
}