platforms/docs/操作日志_配送点地址保存修复_20260810.md

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

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

风险评估

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