44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
# 配送点地址保存修复操作日志
|
||
|
||
操作时间：2026-08-10 11:49:03
|
||
|
||
操作类型：修改
|
||
影响模块：平台总后台配送点管理、平台 API 配送点资源
|
||
|
||
## 操作前状态
|
||
|
||
配送点地址可以通过更新接口写入数据库，但平台资源的通用敏感字段投影会从列表和详情响应中移除 `address`。页面保存后重新加载列表仍显示 `-`，再次编辑时也无法回填已保存地址，用户感知为保存失败。
|
||
|
||
## 具体操作
|
||
|
||
1. 保留全局敏感字段投影规则，不放宽用户地址、订单地址等其他资源的数据范围。
|
||
2. 在已受平台 JWT、角色菜单和资源权限保护的 `delivery_basic` 列表与详情接口中，按查询结果恢复配送点组织地址。
|
||
3. 保留原有分页、关键字搜索、气站筛选、归档过滤和精确位置保护行为。
|
||
4. 新增列表及详情地址恢复回归测试。
|
||
|
||
## 操作后状态
|
||
|
||
配送点地址保存后会在列表中显示，并可在后续编辑时正确回填。其他资源仍沿用原有敏感字段保护规则。
|
||
|
||
## 代码变更
|
||
|
||
- `backend/api/internal/logic/platform/delivery/delivery.go`
|
||
- `ListDeliveryBasic`：扩展受保护列表响应，恢复配送点地址。
|
||
- `GetDeliveryBasic`：扩展受保护详情响应，返回编辑所需地址。
|
||
- `restoreDeliveryBasicAddresses`：新增资源级地址恢复函数。
|
||
- `backend/api/internal/logic/platform/delivery/delivery_test.go`
|
||
- 新增列表和详情地址恢复测试。
|
||
|
||
## 验证结果
|
||
|
||
- `go test ./internal/logic/platform/delivery ./internal/logic/common`：通过。
|
||
- `go test ./...`：通过。
|
||
- `git diff --check`：通过。
|
||
- 边界验证：空列表、列表顺序、单条详情和全局脱敏规则均未改变。
|
||
|
||
## 风险评估
|
||
|
||
- 影响范围仅限平台总后台的配送点资源响应。
|
||
- 配送点地址会对拥有配送点管理菜单权限的平台账号可见，符合该页面已有地址列和编辑能力。
|
||
- 未修改数据库结构、公共路由、更新接口或其他资源响应；回滚时仅需撤销本次资源级响应扩展。
|