brapi-java/docs/dev/04-germplasm

04 Germplasm / Seed 开发录入说明

来源：docs/architecture/04-germplasm-seed-data-flow.md

本目录按 Germplasm / Seed 模块的数据录入顺序拆分开发说明。主线是：

breeding_method -> germplasm
germplasm_attribute_definition -> germplasm_attribute_value
program -> crossing_project -> cross_entity -> cross_parent
germplasm / cross_entity -> seed_lot_content_mixture -> seed_lot
seed_lot -> seed_lot_transaction
germplasm -> pedigree_node -> pedigree_edge

文档清单

顺序	文档	表	作用
01	01-breeding_method.md	breeding_method	育种方法字典
02	02-germplasm.md	germplasm	种质主表
03	03-germplasm_donor.md	germplasm_donor	donor 信息
04	04-germplasm_institute.md	germplasm_institute	机构信息
05	05-germplasm_origin.md	germplasm_origin	来源地/坐标
06	06-germplasm_synonym.md	germplasm_synonym	别名
07	07-germplasm_taxon.md	germplasm_taxon	taxon 标识
08	08-germplasm_attribute_definition.md	germplasm_attribute_definition	属性定义
09	09-germplasm_attribute_value.md	germplasm_attribute_value	属性值
10	10-crossing_project.md	crossing_project	杂交项目
11	11-cross_entity.md	cross_entity	Cross / PlannedCross
12	12-cross_parent.md	cross_parent	杂交亲本
13	13-cross_pollination_event.md	cross_pollination_event	授粉事件
14	14-pedigree_node.md	pedigree_node	系谱节点
15	15-pedigree_edge.md	pedigree_edge	系谱边
16	16-seed_lot.md	seed_lot	种子库存批次
17	17-seed_lot_content_mixture.md	seed_lot_content_mixture	批次组成
18	18-seed_lot_transaction.md	seed_lot_transaction	批次流转

全局注意点

1. plannedcross 没有独立数据库表，统一落在 cross_entity，通过 planned 和 planned_cross_id 自关联表达。
2. germplasm.seedSource / seedSourceDescription 是种质来源描述，不等于真实库存批次。
3. 真正表达库存的是 seed_lot，批次与种质或杂交来源的关系在 seed_lot_content_mixture。
4. seed_lot_transaction 表达 seed lot 到 seed lot 的流转，不直接表达 seed lot 到 germplasm。
5. 属性定义和值要分开：germplasm_attribute_definition 定义“可填什么”，germplasm_attribute_value 记录“某个 germplasm 填了什么”。
6. 系谱关系用 pedigree_node / pedigree_edge；杂交流程用 cross_entity / cross_parent，两条线都可以回到 germplasm。