yaphets1/brapi-java
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix:sample/plate 之前的开发

Browse Source
This commit is contained in:
彭帅
2026-05-28 11:56:17 +08:00
parent fc36bc83e3
commit 8b65de36b8
367 changed files with 57752 additions and 947 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
docs/dev/02-germplasm-seed/01-breeding_method.md Normal file
View File

@@ -0,0 +1,26 @@
# 02 Germplasm / Seed - breeding_method 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`breeding_method` 是育种方法字典，用来说明某个 germplasm 是通过什么方式形成的，例如杂交选育、回交、自交系选育、诱变、转基因、克隆选择等。它不是一次具体杂交动作，而是材料来源方法的分类。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| -------------- | -------------------------------------------- | -------------------------------- | --------- | -------------------------------- |
| `id` | 育种方法主键，系统内部唯一标识 | 新增时系统生成；导入时可允许指定 | 隐藏/只读 | 必填、唯一；编辑时不允许修改 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许前端手填 |
| `abbreviation` | 方法缩写，如 MB、BC、DH | 用户录入 | 文本框 | 可选；建议同一用户下唯一 |
| `description` | 方法解释，如“回交用于恢复目标基因” | 用户录入 | 多行文本 | 可选，限制长度 |
| `name` | 方法名称，如 Male Backcross、Doubled Haploid | 用户录入 | 文本框 | 必填；建议唯一；作为下拉展示名称 |
## 页面与交互
- 列表页展示：方法名称、缩写、描述、使用材料数量。
- 新增页为简单字典表单。
- 删除前检查是否被 `germplasm.breeding_method_id` 引用；已引用时不允许物理删除，只允许停用。
---

54
docs/dev/02-germplasm-seed/02-germplasm.md Normal file
View File

@@ -0,0 +1,54 @@
# 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 引用，不允许物理删除。
---

48
docs/dev/02-germplasm-seed/03-germplasm_attribute_definition.md Normal file
View File

@@ -0,0 +1,48 @@
# 02 Germplasm / Seed - germplasm_attribute_definition 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
属性定义描述“材料可以有哪些稳定属性”。这些属性通常不是环境依赖的田间观测值，而是材料自身特征，例如籽粒颜色、抗病基因、硬度、熟期类型、特定 QTL、分子标记结果等。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| ---------------------- | ------------------------------------------------------------ | ---------------------------- | ----------------- | ------------------------------------- |
| `id` | 属性定义主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许手填 |
| `default_value` | 属性默认值 | 用户录入 | 动态输入框 | 可选；按 datatype / scale 校验 |
| `documentationurl` | 属性说明文档链接 | 用户录入 | URL 输入框 | 可选；校验 URL |
| `growth_stage` | 属性适用生长阶段，如 flowering | 用户录入/选择 | 下拉框/文本框 | 可选 |
| `institution` | 提交或维护该属性定义的机构 | 用户录入 | 文本框 | 可选 |
| `language` | 定义语言，如 zh、en | 用户选择 | 下拉框 | 可选；建议 ISO 639-1 |
| `scientist` | 提交该属性定义的科学家或负责人 | 用户录入/人员选择 | 文本框/人员选择器 | 可选 |
| `status` | 属性状态，如 recommended、obsolete、legacy | 用户选择 | 下拉框 | 可选；推荐使用枚举 |
| `submission_timestamp` | 属性定义提交时间 | 系统默认当前时间，可手动调整 | 日期时间选择器 | 可选；新增默认当前时间 |
| `crop_id` | 适用作物 | 从 crop 选择 | 作物选择器 | 可选；若填写，下游材料应同 crop |
| `method_id` | 属性测定方法 | 从 method 选择 | 方法选择器 | 可选；若填写，属性值录入按该方法解释 |
| `ontology_id` | 所属本体 | 从 ontology 选择 | 本体选择器 | 可选 |
| `scale_id` | 值标尺/单位/有效值范围 | 从 scale 选择 | 标尺选择器 | 可选；若填写，属性值必须按 scale 校验 |
| `trait_id` | 关联性状 | 从 trait 选择 | 性状选择器 | 可选 |
| `attribute_category` | 属性分类，如 Morphological、Genetic、Quality | 用户选择/录入 | 下拉框/文本框 | 可选；建议字典化 |
| `code` | 属性代码，便于导入导出 | 用户录入 | 文本框 | 可选；建议唯一 |
| `datatype` | 属性值数据类型，如 text、numeric、date、boolean、categorical | 用户选择 | 下拉框 | 必填 |
| `description` | 属性解释 | 用户录入 | 多行文本 | 可选 |
| `name` | 属性名称 | 用户录入 | 文本框 | 必填；作为属性选择器展示名称 |
| `pui` | 属性永久标识 | 用户录入 | 文本框/URL 输入框 | 可选；建议唯一 |
| `uri` | 属性 URI | 用户录入 | URL 输入框 | 可选；校验 URL |
## 录入建议
- 属性定义页面本质是“属性字典配置”。
- 前端应根据 `datatype` 动态决定属性值录入控件：
- numeric：数字输入框；
- categorical：下拉框；
- date：日期选择器；
- boolean：开关；
- text：文本框。
- 若绑定了 `scale_id`，则优先按 scale 的单位、上下限、有效分类值校验。
---

27
docs/dev/02-germplasm-seed/04-germplasm_attribute_value.md Normal file
View File

@@ -0,0 +1,27 @@
# 02 Germplasm / Seed - germplasm_attribute_value 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
属性值是“某个 germplasm 在某个属性上的实际取值”。它不是属性定义，也不是 observation。它适合记录材料相对稳定、不强依赖环境的特征。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| ----------------- | ------------------------------ | -------------------------------------- | ---------- | ---------------------------------------- |
| `id` | 属性值主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许手填 |
| `determined_date` | 属性值被测定或确认的日期 | 用户录入 | 日期选择器 | 可选；多次测定时必须填写以区分记录 |
| `value` | 某个材料在某个属性上的实际取值 | 用户录入 | 动态控件 | 必填；按 attribute datatype / scale 校验 |
| `attribute_id` | 属性定义 | 从 germplasm_attribute_definition 选择 | 属性选择器 | 必选；必须存在 |
| `germplasm_id` | 所属材料 | 从 germplasm 选择 | 材料选择器 | 必选；必须存在 |
## 录入建议
- 推荐嵌入 Germplasm 详情页的“属性值”Tab。
- 支持批量导入，模板列建议为：`germplasm_id/germplasm_name`、`attribute_code/attribute_name`、`value`、`determined_date`。
- 同一个 germplasm + attribute 可以允许多次测定，但页面必须显示测定日期、来源和最新值标记。
---

25
docs/dev/02-germplasm-seed/05-crossing_project.md Normal file
View File

@@ -0,0 +1,25 @@
# 02 Germplasm / Seed - crossing_project 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`crossing_project` 是某个育种项目下的一组杂交任务集合。它不是一次杂交，而是一个杂交工作台，例如“2026 抗倒伏杂交项目”。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| -------------- | ------------------ | ------------------ | ---------- | ----------------------------- |
| `id` | 杂交项目主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许手填 |
| `description` | 杂交项目说明 | 用户录入 | 多行文本 | 可选 |
| `name` | 杂交项目名称 | 用户录入 | 文本框 | 必填；同一 program 下建议唯一 |
| `program_id` | 所属育种项目 | 从 program 选择 | 项目选择器 | 必选；必须存在 |
## 页面与交互
- 详情页应展示计划杂交、实际杂交、潜在亲本、后代材料、产生的 seed lot。
- 创建 cross 时应自动带入 crossing_project_id。
---

30
docs/dev/02-germplasm-seed/06-cross_entity.md Normal file
View File

@@ -0,0 +1,30 @@
# 02 Germplasm / Seed - cross_entity 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`cross_entity` 统一承载计划杂交和实际杂交。通过 `planned` 字段区分计划与实际，通过 `planned_cross_id` 指向来源计划。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| --------------------- | ------------------------------------------- | ------------------------ | -------------- | --------------------------------------- |
| `id` | cross 主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许手填 |
| `cross_type` | 杂交类型，如 biparental、self、backcross 等 | 用户选择 | 下拉框 | 可选；值来自枚举字典 |
| `name` | cross 名称，如 A × B、A/B、Cross-2026-001 | 用户录入或自动生成 | 文本框 | 必填；同一 crossing project 下建议唯一 |
| `planned` | 是否为计划杂交 | 页面根据入口自动设置 | 开关/分段控件 | 必填；计划杂交为 true，实际杂交为 false |
| `status` | 状态，如 TODO、DONE、SKIPPED、FAILED | 用户选择/系统更新 | 下拉框 | 可选；计划杂交常用 TODO/DONE/SKIPPED |
| `crossing_project_id` | 所属杂交项目 | 从 crossing_project 选择 | 杂交项目选择器 | 必选 |
| `planned_cross_id` | 实际杂交来源的计划杂交 | 从 cross_entity 选择 | Cross 选择器 | 可选；不能选择自己；实际杂交建议填写 |
## 录入建议
- 页面上分成“计划杂交”和“实际杂交”两个入口，但后端都保存到 `cross_entity`。
- 创建计划杂交时：`planned=true`，`planned_cross_id=null`。
- 完成实际杂交时：`planned=false`，`planned_cross_id=原计划杂交 id`。
- 亲本不要直接塞在 cross 主表字段中，应通过 `cross_parent` 维护，便于支持多亲本和 observation_unit 亲本来源。
---

26
docs/dev/02-germplasm-seed/07-cross_parent.md Normal file
View File

@@ -0,0 +1,26 @@
# 02 Germplasm / Seed - cross_parent 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`cross_parent` 表示某个 cross 的亲本。亲本可以来自 `germplasm`，也可以来自某个 `observation_unit`，例如田间某一株实际被选作父本/母本。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| --------------------- | --------------------------------------------------- | ---------------------------------- | ----------------- | ------------------------------------- |
| `id` | 亲本记录主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `parent_type` | 亲本角色，如 MALE、FEMALE、SELF、POPULATION、CLONAL | 用户选择 | 下拉框 | 必填；使用枚举 |
| `cross_id` | 所属 cross | 从 cross_entity 选择或由详情页带入 | Cross 选择器/隐藏 | 必选 |
| `crossing_project_id` | 所属 crossing project | 由 cross 自动带出 | 只读/隐藏 | 可选；如填写必须与 cross 一致 |
| `germplasm_id` | 亲本材料 | 从 germplasm 选择 | 材料选择器 | 与 `observation_unit_id` 至少一个必填 |
| `observation_unit_id` | 亲本观测单元 | 从 observation_unit 选择 | 观测单元选择器 | 与 `germplasm_id` 至少一个必填 |
## 录入建议
- 在 Cross 详情页内嵌“亲本列表”。
- 常见快捷录入：Parent1 / Parent2。
- 对于田间选株杂交，优先记录 observation_unit_id，同时可带出 germplasm_id，保证可追溯到具体植株。
---

28
docs/dev/02-germplasm-seed/08-pedigree_node.md Normal file
View File

@@ -0,0 +1,28 @@
# 02 Germplasm / Seed - pedigree_node 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`pedigree_node` 是系谱图中的节点，通常对应一个 germplasm。它用于描述材料在系谱树中的位置，不等同于一次杂交记录。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| --------------------- | --------------------- | ------------------------ | -------------- | ----------------------------------------- |
| `id` | 系谱节点主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许手填 |
| `crossing_year` | 亲本最初杂交年份 | 用户录入 | 年份选择器 | 可选；四位年份 |
| `family_code` | 家系编号 | 用户录入 | 文本框 | 可选；同一 crossing_project 下建议唯一 |
| `pedigree_string` | 系谱字符串，如 A/B//C | 用户录入/系统生成 | 文本框 | 可选；建议支持 Purdy notation |
| `crossing_project_id` | 产生该节点的杂交项目 | 从 crossing_project 选择 | 杂交项目选择器 | 可选 |
| `germplasm_id` | 该系谱节点对应的材料 | 从 germplasm 选择 | 材料选择器 | 建议必填；同一 germplasm 不建议重复建节点 |
## 录入建议
- Germplasm 详情页提供“系谱”Tab。
- 支持两种维护方式：树图拖拽维护、表格维护节点和边。
- 如果 cross 完成后产生后代 germplasm，应自动或半自动创建 pedigree_node。
---

27
docs/dev/02-germplasm-seed/09-pedigree_edge.md Normal file
View File

@@ -0,0 +1,27 @@
# 02 Germplasm / Seed - pedigree_edge 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`pedigree_edge` 是系谱图中的边，描述节点之间的父子、同胞等关系。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| ------------------- | ------------------------------------------ | --------------------- | ---------- | ------------------------------------ |
| `id` | 系谱边主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许手填 |
| `edge_type` | 边类型，如 parent、child、sibling | 用户选择 | 下拉框 | 必填 |
| `parent_type` | 如果是亲本关系，标识 MALE、FEMALE、SELF 等 | 用户选择 | 下拉框 | 可选；当 edge_type=parent 时建议必填 |
| `connceted_node_id` | 被连接节点 | 从 pedigree_node 选择 | 节点选择器 | 必选 |
| `this_node_id` | 当前节点 | 从 pedigree_node 选择 | 节点选择器 | 必选；不能等于 connected node |
## 录入建议
- 前端展示时不要暴露“this_node_id / connected_node_id”这种技术词，应该显示为“当前材料”和“关联材料”。
- 添加父本/母本时，系统自动创建 edge_type=parent。
- 需要避免明显循环，例如 A 是 B 的父本，同时 B 又是 A 的父本。
---

33
docs/dev/02-germplasm-seed/10-seed_lot.md Normal file
View File

@@ -0,0 +1,33 @@
# 02 Germplasm / Seed - seed_lot 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`seed_lot` 是实物库存批次，描述某一批种子当前有多少、放在哪里、属于哪个项目。它不是 germplasm 身份；同一个 germplasm 可以有多个 seed_lot。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| ------------------- | ---------------------------------------------------- | --------------------- | ------------------- | ----------------------------- |
| `id` | SeedLot 主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许手填 |
| `amount` | 当前库存数量，可以是粒数、重量、株数等 | 用户录入/交易自动更新 | 数字输入框 | 必填；非负；交易后自动更新 |
| `created_date` | 批次创建时间 | 系统默认，可导入 | 日期时间选择器/只读 | 默认当前时间 |
| `description` | 批次说明 | 用户录入 | 多行文本 | 可选 |
| `last_updated` | 最后更新时间，包含交易变化 | 系统自动更新 | 只读 | 不允许手动改 |
| `name` | 批次名称，如 华占-2026-荆门-扩繁批 | 用户录入或自动生成 | 文本框 | 必填；同一 program 下建议唯一 |
| `source_collection` | 原始来源 collection，如野外采集、nursery、种质库集合 | 用户录入 | 文本框 | 可选 |
| `storage_location` | 具体库位描述，如 冰箱A-2层-盒03 | 用户录入 | 文本框 | 可选 |
| `units` | 数量单位，如 seeds、g、kg、plants | 用户选择 | 下拉框/文本框 | 必填；交易单位需一致或可换算 |
| `location_id` | 库存所在地点 | 从 location 选择 | 地点选择器 | 可选 |
| `program_id` | 所属项目 | 从 program 选择 | 项目选择器 | 可选；用于项目库存筛选 |
## 录入建议
- 创建 seed_lot 后必须进入“批次组成”Tab，至少录入一条 `seed_lot_content_mixture`。
- 普通用户不要直接编辑 amount；amount 应通过入库、出库、转移、分装等交易动作更新。
- 支持库存状态：充足、低库存、耗尽，可由 amount 和阈值计算。
---

26
docs/dev/02-germplasm-seed/11-seed_lot_content_mixture.md Normal file
View File

@@ -0,0 +1,26 @@
# 02 Germplasm / Seed - seed_lot_content_mixture 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`seed_lot_content_mixture` 描述一个 seed_lot 由哪些材料或 cross 组成。单一材料批次也需要有一条组成记录，比例为 100%。混合批次则多条记录占比合计为 100%。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| -------------------- | ----------------------------- | -------------------- | ------------------- | ---------------------------------------- |
| `id` | 批次组成主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `mixture_percentage` | 该材料或 cross 在批次中的占比 | 用户录入 | 百分比输入框 | 0 到 100；同一 seed lot 总和建议等于 100 |
| `cross_id` | 来源 cross | 从 cross_entity 选择 | Cross 选择器 | 与 `germplasm_id` 至少一个必填 |
| `germplasm_id` | 来源 germplasm | 从 germplasm 选择 | 材料选择器 | 与 `cross_id` 至少一个必填 |
| `seed_lot_id` | 所属 seed lot | 由详情页带入或选择 | SeedLot 选择器/隐藏 | 必选 |
## 录入建议
- 新建 seed_lot 时，如果用户选择了单个 germplasm，系统自动生成一条 mixture：`germplasm_id=所选材料`，`mixture_percentage=100`。
- 如果来源是某次杂交产生的种子，优先填写 `cross_id`。
- 如果既能追溯 cross 又能追溯 germplasm，可按系统设计决定是否允许同时填写；若允许，同时展示“来源杂交”和“当前材料身份”。
---

42
docs/dev/02-germplasm-seed/12-seed_lot_transaction.md Normal file
View File

@@ -0,0 +1,42 @@
# 02 Germplasm / Seed - seed_lot_transaction 表录入说明
来源：`docs/requirements/02-germplasm-seed-entry-requirements.md`
## 录入目标
`seed_lot_transaction` 记录库存变化。它不应该由用户像普通表单一样手动维护，而应该由“入库、出库、转移、分装、合并、消耗”等业务动作自动生成。
## 字段录入
| 字段 | 业务意义 | 录入方式 | 控件建议 | 校验规则 |
| ------------------ | -------------------------------------------- | ----------------------- | ------------------- | ------------------------------------------------- |
| `id` | 流转记录主键 | 系统生成 | 隐藏/只读 | 必填、唯一 |
| `auth_user_id` | 数据所属用户或租户 | 登录上下文自动写入 | 隐藏 | 不允许手填 |
| `amount` | 流转数量 | 用户在业务动作中录入 | 数字输入框 | 必填；大于 0 |
| `description` | 流转说明，如用于某 study、分装原因、报废原因 | 用户录入 | 多行文本 | 可选；出库/报废建议必填 |
| `timestamp` | 流转发生时间 | 默认当前时间，可调整 | 日期时间选择器 | 必填 |
| `units` | 流转单位 | 默认继承 seed_lot.units | 下拉框/只读 | 必填；需与 seed_lot 单位一致或有换算关系 |
| `from_seed_lot_id` | 来源批次 | 按动作自动设置 | SeedLot 选择器/隐藏 | 与 `to_seed_lot_id` 至少一个存在 |
| `to_seed_lot_id` | 目标批次 | 按动作自动设置 | SeedLot 选择器/隐藏 | 与 `from_seed_lot_id` 至少一个存在；不能等于 from |
## 业务动作映射
| 动作 | from_seed_lot_id | to_seed_lot_id | amount 对库存影响 |
| --------- | ---------------- | -------------- | -------------------------------------------- |
| 入库 | 空 | 目标批次 | 目标批次增加 |
| 出库 | 来源批次 | 空 | 来源批次减少 |
| 转移 | 来源批次 | 目标批次 | 来源减少，目标增加 |
| 分装 | 原批次 | 新批次 | 原批次减少，新批次增加 |
| 合并 | 多个来源批次 | 目标批次 | 来源减少，目标增加；可能生成多条 transaction |
| 消耗/报废 | 来源批次 | 空 | 来源减少，并记录原因 |
## 验收点
1. amount 必须大于 0。
2. 出库/消耗时，amount 不得超过来源批次当前库存。
3. from 和 to 不能相同。
4. transaction 创建后应自动更新 seed_lot.amount 和 last_updated。
5. 已生成的 transaction 原则上不允许随意修改；如需纠错，应通过反向交易或更正记录处理。
---