Files
tms-erp-web/docs/backend-stubs/transit/risk-disposal/RiskDisposalBackend.md
T
b2894lxlx 6554ad80dd 1、新增应付明细
2、新增应收明细
3、新增异常处置
4、新增风险处置
5、新增在途追踪
6、修复业务模块bug
2026-08-13 00:01:23 +08:00

2.2 KiB

风险处置后端接口契约

当前仓库为前端工程,无 Java 后端源码。本文件提供 BladeX 后端落库与接口实现契约,路径需放入 blade-transport 服务。

Controller

@RestController
@AllArgsConstructor
@RequestMapping("/risk-disposal")
@Api(value = "风险处置", tags = "风险处置")
public class RiskDisposalController {

	private final IRiskDisposalService riskDisposalService;

	@GetMapping("/list")
	public R<IPage<RiskDisposalVO>> list(RiskDisposalQuery query, Query page) {
		IPage<RiskDisposalVO> pages = riskDisposalService.selectRiskDisposalPage(Condition.getPage(page), query);
		return R.data(pages);
	}

	@GetMapping("/detail")
	public R<RiskDisposalVO> detail(Long id) {
		return R.data(riskDisposalService.detail(id));
	}

	@PostMapping("/dispose")
	public R<Boolean> dispose(@Valid @RequestBody RiskDisposalDTO dto) {
		return R.status(riskDisposalService.dispose(dto));
	}

	@PostMapping("/batch-dispose")
	public R<Boolean> batchDispose(@Valid @RequestBody RiskDisposalBatchDTO dto) {
		return R.status(riskDisposalService.batchDispose(dto));
	}
}

字段约定

  • riskLevel: low 低,medium 中,high
  • disposalStatus: pending 待处理,processed 已处理,ignored 已忽略
  • disposalMethod: process 处理,ignore 忽略
  • 列表默认按 create_time DESC 返回
  • riskNo 由后端生成:RK + yyyyMMdd + 3位流水号

接口

  • GET /blade-transport/risk-disposal/list
  • GET /blade-transport/risk-disposal/detail?id=
  • POST /blade-transport/risk-disposal/dispose
  • POST /blade-transport/risk-disposal/batch-dispose

DTO

@Data
public class RiskDisposalDTO {
	@NotNull(message = "风险ID不能为空")
	private Long id;
	@NotBlank(message = "请选择处理方式")
	private String disposalMethod;
	@Length(max = 500, message = "处置说明不能超过500个字符")
	private String disposalRemark;
}

@Data
public class RiskDisposalBatchDTO {
	@NotEmpty(message = "风险ID不能为空")
	private List<Long> ids;
	@NotBlank(message = "请选择处理方式")
	private String disposalMethod;
	@Length(max = 500, message = "处置说明不能超过500个字符")
	private String disposalRemark;
}