# 02 Germplasm / Seed - germplasm 表录入说明

来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`

## 录入目标

`germplasm` 是材料身份证，描述一个品种、品系、亲本、后代材料、遗传资源或研究材料“是谁”。它不表示库存数量，库存数量由 `seed_lot` 表达。

## 字段录入

| 字段                                  | 业务意义                                                     | 录入方式                               | 控件建议          | 校验规则                                                  |
| ------------------------------------- | ------------------------------------------------------------ | -------------------------------------- | ----------------- | --------------------------------------------------------- |
| `id`                                  | 种质主键，系统内部唯一标识                                   | 系统生成；导入可指定                   | 隐藏/只读         | 必填、唯一；编辑不可随意修改                              |
| `auth_user_id`                        | 数据所属用户或租户                                           | 登录上下文自动写入                     | 隐藏              | 不允许手填                                                |
| `accession_number`                    | 材料在种质库/机构内的 accession 编号，如 PI 113869           | 用户录入或导入                         | 文本框            | 可选；建议同一 crop / institution 下唯一                  |
| `acquisition_date`                    | 材料进入本系统或本机构的获取日期                             | 用户录入                               | 日期选择器        | 可选；不得晚于当前日期太多，导入时允许缺月/缺日需统一规则 |
| `acquisition_source_code`             | 获取来源编码，如采集、引进、交换、繁殖等                     | 用户选择                               | 下拉框            | 可选；值来自 BrAPI/MCPD 枚举或系统字典                    |
| `biological_status_of_accession_code` | 材料生物状态，如野生、地方品种、育种材料、改良品种、突变体等 | 用户选择                               | 下拉框            | 可选；使用受控枚举，不建议自由输入                        |
| `collection`                          | 材料所属集合、群体、panel 或 collection                      | 用户录入/选择                          | 文本框/选择器     | 可选；可用于分组筛选                                      |
| `country_of_origin_code`              | 原产国或育成/选育国家代码                                    | 用户选择                               | 国家代码选择器    | 可选；建议使用 ISO 3166-1 三字母代码                      |
| `default_display_name`                | 系统默认展示名，给下拉框、表格、详情标题使用                 | 用户录入，可由 germplasm_name 自动带出 | 文本框            | 与 `germplasm_name` 至少填一个；建议必填                  |
| `documentationurl`                    | 材料说明文档、外部数据库页面或 DOI 链接                      | 用户录入                               | URL 输入框        | 可选；校验 URL 格式                                       |
| `genus`                               | 属名，如 Oryza、Triticum                                     | 用户录入/字典选择                      | 文本框/物种选择器 | 可选；建议首字母大写                                      |
| `germplasm_name`                      | 材料名称，可以是品种名、品系名、后代编号                     | 用户录入                               | 文本框            | 与 `default_display_name` 至少填一个；不强制全局唯一      |
| `germplasmpui`                        | 永久唯一标识，通常是 DOI、URI 或全局唯一编码                 | 用户录入/外部导入                      | 文本框/URL 输入框 | 可选；若填写必须唯一；建议用于跨系统交换                  |
| `germplasm_preprocessing`             | 材料用于试验前的统一处理说明，如消毒、催芽、低温处理         | 用户录入                               | 文本框/多行文本   | 可选                                                      |
| `mls_status`                          | 多边系统 MLS 状态，涉及植物遗传资源交换协议                  | 用户选择                               | 下拉框            | 可选；普通业务可隐藏到高级信息                            |
| `seed_source`                         | 材料来源标识，如来源机构+accession，或亲本组合描述           | 用户录入                               | 文本框            | 可选；注意它不是库存批次，不等于 seed_lot                 |
| `seed_source_description`             | 材料来源详细说明                                             | 用户录入                               | 多行文本          | 可选                                                      |
| `species`                             | 种名，如 sativa、aestivum                                    | 用户录入/物种字典                      | 文本框            | 可选；建议小写                                            |
| `species_authority`                   | 种名命名权威，如 L.                                          | 用户录入                               | 文本框            | 可选                                                      |
| `subtaxa`                             | 亚种、变种、品种群、line 等更细分类                          | 用户录入                               | 文本框            | 可选                                                      |
| `subtaxa_authority`                   | 亚种/变种命名权威                                            | 用户录入                               | 文本框            | 可选                                                      |
| `breeding_method_id`                  | 该材料形成所使用的育种方法                                   | 从 breeding_method 选择                | 搜索选择器        | 可选；必须引用存在的 breeding_method                      |
| `crop_id`                             | 所属作物                                                     | 从 crop 选择                           | 作物选择器        | 必填；后续 trial/study/attribute 应尽量同 crop            |

## 录入建议

- 新建材料时，第一屏只放核心字段：`crop_id`、`germplasm_name`、`default_display_name`、`germplasmpui`、`accession_number`、`breeding_method_id`。
- 分类与来源信息放在“高级信息”或“来源信息”分组。
- `germplasmpui`、`accession_number`、`germplasm_name` 三者不要混为一谈：
  - `germplasm_name` 是人看的名字；
  - `accession_number` 是机构内编号；
  - `germplasmpui` 是跨系统长期唯一标识。

## 验收点

1. 新增 germplasm 时，必须选择 crop。
2. `germplasm_name` 和 `default_display_name` 至少填写一个。
3. 下拉选择材料时展示 `default_display_name`，辅助展示 accession number / PUI。
4. 如果 germplasm 已被 seed lot、cross parent、observation unit 引用，不允许物理删除。

---