fix:sample/plate 之前的开发

docs/dev/01-core/12-study_contact.md

@@ -0,0 +1,61 @@
+# 01 Core - study_contact 表录入说明
+
+来源：`docs/requirements/01-core-data-entry-requirements.md`
+
+## 录入目标
+
+`study_contact` 是给 study 添加联系人的关系表，不是独立主数据。它记录 study 与 person 的多对多关系，用于 Study 工作台联系人展示、责任追踪、权限和通知。
+
+## 前置依赖和下游引用
+
+| 类型 | 内容 |
+| --- | --- |
+| 表 | `study_contact` |
+| 前置依赖 | `study`、`person` |
+| 下游引用 | Study 工作台联系人展示、权限和通知 |
+
+## 页面入口
+
+| 页面 | 录入要求 |
+| --- | --- |
+| Study 新增/编辑页 | 联系人区域多选 person，可增删 |
+| Study 工作台 | 展示 study 联系人 |
+| 批量导入 | 支持通过 Core 导入流程导入 study 联系人关系 |
+
+## 字段录入
+
+| 字段 | 类型 | 控件 | 录入说明 | 校验/来源 |
+| --- | --- | --- | --- | --- |
+| `study_db_id` | varchar(255) | Study 选择器 | 所属 study | 必选，来源 `study.id` |
+| `person_db_id` | varchar(255) | 人员选择器 | 联系人 | 必选，来源 `person.id` |
+
+## 校验规则
+
+1. `study_db_id` 必选，且必须引用已存在的 `study.id`。
+2. `person_db_id` 必选，且必须引用已存在的 `person.id`。
+3. 同一 study 下不建议重复添加同一个 person。
+
+## 接口能力
+
+| 接口 | 用途 |
+| --- | --- |
+| `GET /studies/{id}/contacts` | study 联系人，返回 person 列表 |
+
+本文档原始需求未强制限定 study_contact 的写入 URL。实现时可以随 study 新增/编辑一起保存，也可以提供 study 联系人子资源接口；前端需要具备新增、删除、查询 study 联系人的能力。
+
+## 导入导出
+
+1. 支持通过 Core 导入流程导入 `study_contact`。
+2. 外键列支持填写 ID；可额外支持名称匹配，但名称重复时必须报错。
+3. 导入时需要校验 study 和 person 是否存在。
+4. 错误报告返回行号、字段名、错误原因、建议修正方式。
+
+## 删除/停用
+
+`study_contact` 是关系记录，可在 Study 新增/编辑页或工作台移除。删除关系不应删除 `study` 或 `person` 主数据。
+
+## 验收点
+
+1. Study 新增/编辑页可增删联系人。
+2. Study 工作台能展示联系人列表。
+3. 删除 study_contact 后，person 主数据仍保留。