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

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 查看器、关系合并和合同动作限制。