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