# 配送点地址保存修复操作日志

操作时间：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`：通过。
- 边界验证：空列表、列表顺序、单条详情和全局脱敏规则均未改变。

## 风险评估

- 影响范围仅限平台总后台的配送点资源响应。
- 配送点地址会对拥有配送点管理菜单权限的平台账号可见，符合该页面已有地址列和编辑能力。
- 未修改数据库结构、公共路由、更新接口或其他资源响应；回滚时仅需撤销本次资源级响应扩展。