fix:sample/plate 之前的开发

docs/dev/01-core/05-trial.md

@@ -0,0 +1,78 @@
+# 01 Core - trial 表录入说明
+
+来源：`docs/requirements/01-core-data-entry-requirements.md`
+
+## 录入目标
+
+`trial` 表示某一批试验、区域试验或年度试验，位于 program 与 study 之间。创建 trial 时选择 program，并自动带出或校验 crop。
+
+## 前置依赖和下游引用
+
+| 类型 | 内容 |
+| --- | --- |
+| 表 | `trial` |
+| 前置依赖 | `program`、`crop` |
+| 下游引用 | `study`、`observation_unit`、`observation`、`plate`、`sample` |
+
+## 页面入口
+
+| 页面 | 录入要求 |
+| --- | --- |
+| Trial 列表页 | 支持 crop、program、active、起止日期、关键词筛选；新增、编辑、查看详情、停用 |
+| Trial 新增/编辑页 | 包含基本信息、项目作物、联系人、出版物四个区域 |
+| Trial 详情页 | 展示 study 列表和 phenotyping/genotyping 入口 |
+
+列表页表格字段：`trial_name`、program、crop、`start_date`、`end_date`、active。
+
+## 字段录入
+
+| 字段 | 类型 | 控件 | 录入说明 | 校验/来源 |
+| --- | --- | --- | --- | --- |
+| `id` | varchar(255) | 隐藏/只读 | 试验主键 | 必填、唯一 |
+| `auth_user_id` | varchar(255) | 隐藏 | 数据所属用户 | 登录上下文自动写入 |
+| `active` | boolean | 开关 | 是否启用 | 默认启用 |
+| `documentationurl` | varchar(255) | URL 输入框 | 试验文档链接 | URL 格式校验 |
+| `end_date` | timestamp | 日期选择器 | 结束日期 | 不早于 `start_date` |
+| `start_date` | timestamp | 日期选择器 | 开始日期 | 可选 |
+| `trial_description` | varchar(255) | 多行文本 | 试验描述 | 可选 |
+| `trial_name` | varchar(255) | 文本框 | 试验名称 | 必填 |
+| `trialpui` | varchar(255) | 文本框 | 试验永久标识 | 可选，建议唯一 |
+| `crop_id` | varchar(255) | 作物选择器 | 所属作物 | 必选，来源 `crop.id` |
+| `program_id` | varchar(255) | 项目选择器 | 所属项目 | 必选，来源 `program.id` |
+
+## 校验规则
+
+1. `trial_name` 必填。
+2. `program_id` 必选且必须存在。
+3. `crop_id` 必选且必须与 `program.crop_id` 一致。
+4. `end_date` 不能早于 `start_date`。
+5. `documentationurl` 需要做 URL 格式校验。
+
+## 接口能力
+
+| 接口 | 用途 |
+| --- | --- |
+| `GET /trials` | trial 分页查询 |
+| `POST /trials` | 新增 trial |
+| `GET /trials/{id}` | trial 详情 |
+| `PUT /trials/{id}` | 编辑 trial |
+| `DELETE /trials/{id}` | 删除或停用 trial，需检查 study 引用 |
+| `GET /trials/{id}/studies` | 查询 trial 下 study |
+| `GET /selectors/trials` | trial 搜索下拉，参数 `keyword`、`programId`、`cropId`、`active` |
+
+## 导入导出
+
+1. 支持通过 Core 导入流程导入 `trial`。
+2. 外键列支持填写 ID；可额外支持名称匹配，但名称重复时必须报错。
+3. 导入时必须校验 trial 的 crop 与 program 的 crop 一致。
+4. 列表页支持导出当前筛选结果，导出文件应包含 ID 和展示名称。
+
+## 删除/停用
+
+当 `trial` 已被 `study`、`observation_unit`、`observation`、`plate`、`sample` 引用时，不允许物理删除。后端需要返回引用对象类型和数量，前端展示后引导用户停用。
+
+## 验收点
+
+1. 创建 trial 时，选择 program 后自动带出 crop。
+2. Trial 列表页支持按 crop、program、active、日期筛选。
+3. 已被 study 引用的 trial 不能直接删除。