# 操作日志：配送点资料只读卡片

操作时间：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 响应行为不变。
- 缓解措施：已增加专项检查、单元测试、完整构建和浏览器回归；后端重启后需补验气站名称。