platforms/docs/操作日志_配送点资料只读卡片_20260822.md

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

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