# 项目文档：智能气阀生产商关联展示 v1.0

## 1. 项目概述

本次修改将智能气阀列表中的生产商关联从内部唯一标识展示升级为“生产商名称 + 唯一标识复制”，并为历史空关联提供“未填写”提示。数据库不做任何修改。

## 2. 目录结构说明

```text
platforms/
├── backend/api/internal/seed/
│   ├── mock.go                    # 未来 Mock 智能气阀生产商关联
│   └── mock_test.go               # Mock 关联规则测试
├── frontend/platform_admin/src/api/
│   └── resources.ts               # 生产商关联展示配置
└── docs/
    ├── 项目文档_智能气阀生产商关联展示_v1.0.md
    └── 操作日志_智能气阀生产商关联展示_20260813.md
```

## 3. 核心文件说明

- `resources.ts`：生产商字段使用现有关联名称组件，列表显示名称并复制 identity；空值显示“未填写”。
- `mock.go`：生产商先落库，再将其数据库 ID 写入未来生成的 `ProductInfo.ProducerAccountID`。
- `mock_test.go`：验证有效生产商可建立关联，未落库生产商会被拒绝。

## 4. 变更记录

- 列标题改为“生产商”。
- 有关联时显示名称及复制入口。
- 无关联时显示“未填写”。
- 修复未来 Mock 数据缺少生产商关联的问题。
- 不执行数据库迁移或历史数据回填。

## 5. 维护指南

生产商关系必须通过 `producer_account_identity` 输入，并由后端解析为数据库内部 ID。前端不得直接提交内部 ID。未来新增关联名称展示时应复用 `RelationNameText`，保持名称识别与 identity 复制能力一致。