53 lines
2.6 KiB
Markdown
53 lines
2.6 KiB
Markdown
# 操作日志：配送点资料只读卡片
|
||
|
||
操作时间：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 响应行为不变。
|
||
- 缓解措施：已增加专项检查、单元测试、完整构建和浏览器回归；后端重启后需补验气站名称。
|