1、新增应付明细

2、新增应收明细 3、新增异常处置 4、新增风险处置 5、新增在途追踪 6、修复业务模块bug
2026-08-13 00:01:23 +08:00
parent 748dd80d4a
commit 6554ad80dd
33 changed files with 7868 additions and 1657 deletions
@@ -0,0 +1,76 @@
+# 风险处置后端接口契约
+
+> 当前仓库为前端工程，无 Java 后端源码。本文件提供 BladeX 后端落库与接口实现契约，路径需放入 `blade-transport` 服务。
+
+## Controller
+
+```java
+@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
+
+```java
+@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;
+}
+```
@@ -0,0 +1,27 @@
+# 在途追踪后端接口契约
+
+## 接口
+
+- `GET /blade-transport/track-tracking/map`
+- `GET /blade-transport/track-tracking/ship`
+
+## 建议返回
+
+```json
+{
+  "code": 200,
+  "success": true,
+  "data": {
+    "siteName": "XX园区A门",
+    "address": "南宁市邕宁区龙岗大道21号",
+    "coordinates": "108.348610;22.721864",
+    "records": []
+  }
+}
+```
+
+## 说明
+
+- `map` 用于轨迹查询
+- `ship` 用于船舶查询
+- 当前前端先做高德地图占位，后端可先只返回基础信息和轨迹点数组