54 lines
2.4 KiB
Markdown
54 lines
2.4 KiB
Markdown
# 配送点重复编码提醒
|
||
|
||
## 项目概述
|
||
|
||
- 功能：新增配送点时，将目标唯一键冲突转换为中文业务提醒。
|
||
- 技术栈：Go、Gin、GORM、PostgreSQL。
|
||
- 运行环境：项目现有 Go 1.26.1 环境。
|
||
|
||
## 目录结构说明
|
||
|
||
```text
|
||
platforms/backend/api/internal/logic/
|
||
├── common/
|
||
│ ├── delivery_error.go # 配送点创建错误转换
|
||
│ └── delivery_error_test.go # 错误转换单元测试
|
||
├── gas/delivery.go # 气站端配送点新增入口
|
||
└── platform/delivery/delivery.go # 平台端配送点新增入口
|
||
```
|
||
|
||
## 核心文件说明
|
||
|
||
- `common/delivery_error.go`：精确识别 PostgreSQL `23505` 与约束 `idx_delivery_basic_delivery_code`，返回“配送点编码已存在，请更换后重试”；其他错误保持原样。
|
||
- `platform/delivery/delivery.go`：平台端创建失败时调用公共转换函数。
|
||
- `gas/delivery.go`：气站端创建失败时调用同一公共转换函数。
|
||
- `common/delivery_error_test.go`：覆盖目标约束、普通数据库错误、其他唯一约束三个分支。
|
||
|
||
## 变更记录
|
||
|
||
- 新增配送点重复编码的中文提醒。
|
||
- 平台端和气站端行为保持一致。
|
||
- 保留数据库全局唯一约束、归档占用规则和现有前端顶部提醒。
|
||
- 未新增依赖，未修改公共接口、数据库结构或配送点编码编辑规则。
|
||
|
||
## 维护指南
|
||
|
||
- 若数据库约束名称调整，需要同步更新 `deliveryCodeUniqueConstraint`。
|
||
- 新增其他唯一字段提示时，应按约束名精确映射，不能将全部 `23505` 错误统一解释为配送点编码重复。
|
||
- 验证命令：`go test ./internal/logic/common ./internal/logic/platform/delivery ./internal/logic/gas`。
|
||
|
||
## 操作日志
|
||
|
||
```text
|
||
操作时间：2026-08-10 12:24:49
|
||
操作类型：扩展
|
||
影响模块：配送点创建错误处理
|
||
|
||
操作前状态：数据库唯一键原始英文错误直接返回前端，暴露 SQLSTATE 与约束名。
|
||
具体操作：新增精确错误映射并接入平台端、气站端创建入口；新增三个单元测试。
|
||
操作后状态：目标配送点编码冲突返回中文提醒，其他错误行为不变。
|
||
代码变更：delivery_error.go、delivery_error_test.go、platform/delivery/delivery.go、gas/delivery.go。
|
||
验证结果：三个相关 Go 包测试通过。
|
||
风险评估：依赖既有 PostgreSQL 约束名；约束重命名后需同步更新常量。未改变数据库唯一规则。
|
||
```
|