新增配送点资料只读卡片

This commit is contained in:
czl231
2026-08-22 19:49:28 +08:00
parent 79749685ee
commit da0185d1aa
9 changed files with 401 additions and 4 deletions

View File

@@ -0,0 +1,52 @@
# 操作日志:配送点资料只读卡片
操作时间2026-08-22 19:42:41
操作类型:扩展
影响模块:配送点后台本点资料、配送点 API 资料响应、HTTP 错误处理
## 操作前状态
- 本点资料套用通用列表页面,只显示 ID、唯一标识和“详情”按钮。
- 点击详情请求不存在的 `/delivery_profile/:identity`,纯文本 404 被当作 JSON 解析并显示底层异常。
- 页面未直接展示需求规定的配送点资料字段。
## 具体操作
1. 根据需求文档确认本点资料是 JWT 范围内的单一只读视图。
2. 新增专用资料卡并在资源页面入口中进行兼容分发。
3. 扩展现有 `/delivery_profile` 响应,补充所属气站名称。
4. 增强 HTTP 客户端的非 JSON 响应处理。
5. 增加后端单元测试和前端专项静态检查。
6. 执行构建、测试和浏览器核心路径回归。
## 操作后状态
- 页面直接展示本点资料,不再发起不存在的详情请求。
- 刷新成功且不再出现 JSON 解析异常。
- 后端保持 JWT 数据范围、现有接口路径和列表响应结构。
- HTTP 404 或非 JSON 响应转换为可读错误。
## 代码变更
- `backend/api/internal/logic/delivery/base.go`:新增资料视图与字段组装。
- `backend/api/internal/logic/delivery/profile_test.go`:新增资料字段映射测试。
- `frontend/delivery_admin/src/views/shared/DeliveryProfilePage.vue`:新增专用资料卡。
- `frontend/delivery_admin/src/views/shared/ResourcePage.vue`:扩展本点资料页面分发。
- `frontend/delivery_admin/src/api/http.ts`:增强响应解析。
- `frontend/delivery_admin/scripts/check-delivery-profile-page.mjs`:新增专项检查。
- `frontend/delivery_admin/package.json`:新增 `profile:check` 命令。
## 验证结果
- `go test ./internal/logic/delivery`:通过。
- `npm run profile:check`:通过。
- `npm run build`:通过,共转换 2606 个模块。
- 浏览器回归:资料卡正常展示;查询、分页、详情入口已移除;刷新正常;控制台无错误或警告。
- 后端运行态:已备份旧二进制、部署新版本并恢复 `12426` 端口监听;重新登录后确认所属气站名称正确显示为“薛海”,刷新正常且控制台无错误或警告。
## 风险评估
- 影响范围仅限配送点后台的本点资料页面和通用 HTTP 错误文案。
- API 仅新增响应字段,旧客户端可忽略,兼容性风险低。
- HTTP 客户端仍保持 `request<T>` 签名;成功 JSON 响应行为不变。
- 缓解措施:已增加专项检查、单元测试、完整构建和浏览器回归;后端重启后需补验气站名称。