完善配送端详情字段中文化

docs/操作日志_配送点详情字段中文化_20260823.md

@@ -0,0 +1,39 @@
+# 操作日志：配送点详情字段中文化
+
+操作时间：2026-08-23
+操作类型：新增、修改
+影响模块：5176 标准资源详情、合同关联记录、合同动作区
+
+## 操作前状态
+
+详情组件按响应对象键顺序动态展示字段。合同详情出现 `user_account_display_name`、`user_service_active`、`bound_at`、`product_name`、`product_params` 等英文键；合同状态显示数字，JSON 参数在表格中被截断。
+
+## 具体操作
+
+1. 新增配送端聚合详情契约，固定合同、订单的主字段和关联记录列序。
+2. 建立主详情与集合上下文中文标签，未知响应键默认不展示。
+3. 将用户名称合并到用户唯一标识行，将设备和操作人名称与唯一标识组合展示。
+4. 增加合同状态、合同动作、订单状态、布尔、金额和时间格式化。
+5. 为 JSON 参数增加“查看参数”弹层，支持对象、合法 JSON 字符串和历史普通文本。
+6. 明确当前设备名称与合同绑定快照的语义区别。
+7. 当签约用户不再属于合同气站时，仅保留终止合同操作。
+
+## 行为变化
+
+- 变更前：未知英文键直接成为标签，子表列序随响应漂移。
+- 变更后：只显示具有中文业务契约的字段；合同气瓶和修订记录使用固定列与完整参数查看器。
+- 兼容性：不修改 API、数据库和原始业务值，未知历史状态或动作仍保留原编码用于排障。
+
+## 验证结果
+
+- `npm.cmd run type:check`：通过。
+- `npm.cmd run resource-pages:check`：通过，详情 17、新建 9、编辑 5，并覆盖详情白名单、固定列序、关系合并、JSON 查看器和动作限制。
+- `npm.cmd run contract:check`、`npm.cmd run profile:check`：通过。
+- `npm.cmd run build`：通过，2643 个模块完成生产构建。
+- 应用内浏览器当前没有已登录的 5176 标签页，自动视觉回归被登录状态阻挡；用户提供的修复前截图已用于定位，不替代修复后回归。
+
+## 风险评估
+
+- 新后端字段默认隐藏：通过自动检查和维护规范要求先补中文契约，避免内部字段意外暴露。
+- 当前设备名称可能变化：页面说明其非历史快照，编码和类型继续作为绑定快照展示。
+- 子表字段较多：保留固定列宽和横向滚动，避免压缩导致内容不可读。

docs/项目文档_配送点独立资源页面_v1.0.md

@@ -87,6 +87,7 @@ npm.cmd run build
 - 新增配送人员资质的强制人员范围、上下文展示、关系预填锁定和安全返回链路。
 - 新增后端生成的资源搜索契约，隐藏无效搜索并支持枚举中文名称与稳定编码。
 - 新增配送合同受控 PDF 附件上传、鉴权预览、下载、替换和移除流程，列表及接口均不暴露内部路径。
+- 新增详情字段中文白名单和聚合子表固定契约，未知响应键不再直接回显；合同状态、动作和 JSON 参数对齐 5173。
 - 保持配送点资料专用只读页面和现有公共后端接口不变。
 
 ## 7. 已知边界

docs/项目文档_配送点详情字段中文化_v1.0.md

@@ -0,0 +1,39 @@
+# 项目文档：配送点详情字段中文化 v1.0
+
+## 1. 项目概述
+
+本项目将 5176 配送点管理端的标准资源详情展示对齐 5173。所有管理员可见字段必须来自显式中文契约；后端辅助键、内部 ID 和未知响应字段不得直接成为页面标签。
+
+技术栈：Vue 3、TypeScript、Arco Design。功能仅修改展示层和前端动作可见性，不修改数据库及聚合详情接口。
+
+## 2. 目录结构
+
+```text
+frontend/delivery_admin/src/
+├── api/resource-detail-contract.ts       # 聚合详情字段、列序和 JSON 契约
+├── api/resource-display.ts               # 中文标签、状态、动作、金额与时间格式化
+├── views/resource/ResourceDetailContent.vue # 白名单详情与关联表渲染
+└── views/resource/ResourceRecordPage.vue # 服务关系失效时的动作限制
+```
+
+## 3. 核心规则
+
+- 普通详情仅展示资源定义或公共中文字典中已声明的字段，未知响应键默认隐藏。
+- `*_display_name` 只作为对应 `*_identity` 的可读名称，不重复显示独立字段。
+- 合同状态显示“草稿、待处理、生效中、已过期、已终止”；未知值显示原编码。
+- 合同动作显示“启用合同、续签合同、终止合同”；未知动作保留原编码。
+- `user_service_active` 显示为“签约用户仍属合同气站：是/否”；为否时只保留终止合同操作。
+- 合同气瓶和修订记录使用固定中文列序，超宽表格横向滚动。
+- 名称字段与唯一标识组合展示；`product_params` 通过弹层完整查看格式化 JSON。
+
+## 4. 合同气瓶语义
+
+“智能气阀名称”读取当前设备资料，可能随设备改名变化；气瓶编码和气瓶类型名称是合同绑定时保存的快照。页面必须明确说明这一差异，避免把当前名称误认为历史审计快照。
+
+## 5. 维护与验证
+
+后端新增详情字段时，应先在资源字段字典或资源专属详情契约中声明中文名称和展示语义，再开放页面显示。禁止回退到 `Object.keys()` 后直接使用未知键名。修改后运行 `type:check`、`resource-pages:check`、`contract:check` 和生产构建，并抽查合同、订单及用户详情。
+
+## 6. 变更记录
+
+- v1.0（2026-08-23）：新增配送端详情中文白名单、合同固定子表、JSON 查看器、关系合并和合同动作限制。