fix:sample/plate 之前的开发

docs/dev/03-genotyping/05-reference_bases.md

@@ -0,0 +1,37 @@
+# 03 Genotyping - reference_bases 表录入说明
+
+来源：`docs/architecture/03-genotyping-data-flow.md`
+
+## 录入目标
+
+`reference_bases` 保存 reference 的序列片段或分页内容。它是参考序列的明细表，通常通过导入或后端任务写入。
+
+## 上下游关系
+
+| 类型 | 内容 |
+| --- | --- |
+| 表 | `reference_bases` |
+| Java 实体 | `ReferenceBasesPageEntity` |
+| 前置依赖 | `reference` |
+| 下游引用 | 无 |
+
+## 字段录入
+
+| 字段 | 业务意义 | 录入方式 | 校验规则 |
+| --- | --- | --- | --- |
+| `id` | reference bases 主键 | 系统生成；导入时可指定 | 必填、唯一 |
+| `auth_user_id` | 数据所属用户 | 登录上下文自动写入 | 不允许前端手填 |
+| `reference_id` | 所属 reference | Reference 选择器/导入 | 必选，必须存在 |
+| `page_number` | 分页序号 | 数字输入/导入 | 同一 reference 内建议唯一 |
+| `bases` | 碱基序列片段 | 文本/文件导入 | 最大 2048 字符；建议仅允许 A/C/G/T/N 等字符 |
+
+## 页面与交互
+
+- 一般不单独提供复杂 CRUD，可在 Reference 详情页查看或导入。
+- 长序列建议走文件导入或异步任务，不建议手工逐页录入。
+
+## 关键校验
+
+1. `reference_id` 必须存在。
+2. `bases` 长度不能超过数据库字段限制。
+3. 同一 reference 下 `page_number` 不应重复。