# 库房地址受控展示操作日志

操作时间：2026-08-13  
操作类型：修改  
影响模块：平台总后台库房管理、平台管理 API

## 操作前状态

库房地址已保存于 `product_warehouse.address`，新建与编辑接口也允许写入地址，但通用敏感字段保护会删除列表和详情响应中的 `address`，导致页面统一显示 `-`。

## 具体操作

1. 为库房管理增加专用列表与详情处理器。
2. 保留全局敏感字段保护，并在保护后仅恢复当前库房资源自身的地址。
3. 创建与编辑继续复用原有通用白名单写入逻辑。
4. 未填写地址时在页面显示“未填写”。
5. 新增列表、详情和空地址回归测试。

## 操作后状态

- 库房列表、详情和编辑页面可取得已保存地址。
- 未填写地址时显示“未填写”。
- 其他资源和公共接口继续执行原有地址保护。
- 数据库结构与历史数据均未修改。

## 代码变更

- `backend/api/internal/logic/platform/product/warehouse.go`：新增库房地址受控列表、详情和恢复逻辑。
- `backend/api/internal/logic/platform/product/warehouse_test.go`：新增地址恢复测试。
- `backend/api/internal/routers/platform.go`：库房 GET 路由改用专用处理器，POST/PUT 保持通用处理器。
- `frontend/platform_admin/src/api/resources.ts`：配置库房地址空值文案。

## 验证结果

- `go test ./internal/logic/platform/product ./internal/routers`：通过。
- `npm.cmd run resource-pages:check`：通过，详情 46 类、新建 25 类、编辑 23 类。
- `npm.cmd run build`：通过，TypeScript 检查与 Vite 生产构建成功。
- 本地后端重新编译并重启，健康接口返回 `platform-api`、`ok`。
- `git diff --check`：通过。

## 风险评估

完整库房地址仅在已鉴权的平台库房管理接口中恢复。全局敏感字段规则未放宽，数据库与其他终端不受影响。