40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
|
# 项目文档：库房地址受控展示 v1.0
|
|||
|
|
|
|||
|
|
## 1. 项目概述
|
|||
|
|
|
|||
|
|
本次修改解决平台总后台库房地址已保存但无法显示的问题。库房继续使用自身的 `product_warehouse.address` 字段，地址保持可选，不修改数据库结构或历史数据。
|
|||
|
|
|
|||
|
|
## 2. 目录结构说明
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
platforms/
|
|||
|
|
├── backend/api/internal/logic/platform/product/
|
|||
|
|
│ ├── warehouse.go # 库房列表、详情及地址受控恢复
|
|||
|
|
│ └── warehouse_test.go # 库房地址响应测试
|
|||
|
|
├── backend/api/internal/routers/
|
|||
|
|
│ └── platform.go # 平台库房管理路由
|
|||
|
|
├── frontend/platform_admin/src/api/
|
|||
|
|
│ └── resources.ts # 库房地址空值展示配置
|
|||
|
|
└── docs/
|
|||
|
|
├── 项目文档_库房地址受控展示_v1.0.md
|
|||
|
|
└── 操作日志_库房地址受控展示_20260813.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 3. 核心文件说明
|
|||
|
|
|
|||
|
|
- `warehouse.go`：列表与详情先执行通用响应投影和敏感字段保护，再按当前查询记录恢复库房自身地址。
|
|||
|
|
- `warehouse_test.go`：覆盖列表顺序、单条详情及空地址场景。
|
|||
|
|
- `platform.go`：GET 使用库房专用处理器；创建、更新和状态修改继续沿用通用资源能力。
|
|||
|
|
- `resources.ts`：空地址显示“未填写”，编辑输入提示为“请输入地址”。
|
|||
|
|
|
|||
|
|
## 4. 变更记录
|
|||
|
|
|
|||
|
|
- 修复库房列表地址显示 `-`。
|
|||
|
|
- 支持详情和编辑页面读取已保存库房地址。
|
|||
|
|
- 保持地址可选，并为未填写状态提供明确文案。
|
|||
|
|
- 未新增依赖、数据库迁移或历史数据修改。
|
|||
|
|
|
|||
|
|
## 5. 维护指南
|
|||
|
|
|
|||
|
|
新增需要受控展示地址的管理资源时，应采用资源专用恢复逻辑，不得从全局敏感字段集合中移除 `address`。修改后至少运行平台产品逻辑测试、路由测试和平台前端构建。
|