# 03 Genotyping - variantset_analysis 表录入说明

来源：`docs/architecture/03-genotyping-data-flow.md`

## 录入目标

`variantset_analysis` 记录 variantset 的分析或 QC 信息，例如分析名称、软件、类型、描述和时间。它是 variantset 的附属明细表。

## 上下游关系

| 类型 | 内容 |
| --- | --- |
| 表 | `variantset_analysis` |
| Java 实体 | `VariantSetAnalysisEntity` |
| 前置依赖 | `variantset` |
| 下游引用 | 分析信息展示 |

## 字段录入

| 字段 | 业务意义 | 录入方式 | 校验规则 |
| --- | --- | --- | --- |
| `id` | analysis 主键 | 系统生成；导入时可指定 | 必填、唯一 |
| `variant_set_id` | 所属 variantset | VariantSet 选择器/导入 | 必选，必须存在 |
| `analysis_name` | 分析名称 | 用户录入 | 建议必填 |
| `description` | 分析说明 | 多行文本 | 可选 |
| `type` | 分析类型，如 QC | 下拉/文本 | 可选 |
| `created` | 创建时间 | 日期时间 | 可选 |
| `updated` | 更新时间 | 日期时间 | 可选 |

## 附属集合字段

| 附属表 | 内容 |
| --- | --- |
| `variant_set_analysis_entity_software` | software 列表，如软件名称、版本或 URL |

## 页面与交互

- 在 VariantSet 详情页以 Analysis Tab 维护。
- 支持添加多条分析记录，每条可维护多个 software。

## 关键校验

1. `variant_set_id` 必须存在。
2. 删除 variantset 时需要先处理或级联处理 analysis。
3. `software` 如果是 URL，前端可做 URL 格式提示。