brapi-java/docs/dev/02-germplasm-seed/02-germplasm.md

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 引用，不允许物理删除。

---