brapi-java/docs/dev/01-core/06-season.md

01 Core - season 表录入说明

来源：docs/requirements/01-core-data-entry-requirements.md

录入目标

season 记录年度和季节，用于 study 的季节绑定，以及部分 observation 的季节维度统计。

前置依赖和下游引用

类型	内容
表	season
前置依赖	无
下游引用	study_season、部分 observation

页面入口

页面	录入要求
Season 列表页	支持 year、season 筛选；新增、编辑、查看详情、停用
Season 新增/编辑页	简单表单
Season 详情页	展示关联 study

列表页表格字段：year、season、关联 study 数。

字段录入

字段	类型	控件	录入说明	校验/来源
id	varchar(255)	隐藏/只读	季节主键	必填、唯一
auth_user_id	varchar(255)	隐藏	数据所属用户	登录上下文自动写入
season	varchar(255)	文本框/下拉框	季节名称，如 Spring、Summer	必填
year	integer	年份选择器	年份	必填，四位年份

校验规则

1. season 必填。
2. year 必填，使用四位年份。
3. 同一年份内 season 名称不建议重复。

接口能力

接口	用途
GET /seasons	season 查询
POST /seasons	新增 season
PUT /seasons/{id}	编辑 season
GET /selectors/seasons	season 搜索下拉，参数 year、keyword

导入导出

1. 支持通过 Core 导入流程导入 season。
2. 模板列名使用数据库字段名。
3. 可按 id 幂等更新；无 id 时新增。
4. 列表页支持导出当前筛选结果，导出文件应包含 ID 和展示名称。

删除/停用

当 season 已被 study_season 或 observation 引用时，不允许物理删除。后端需要返回引用对象类型和数量，前端展示后引导用户停用。

验收点

1. Season 列表页支持按 year 和 season 筛选。
2. 同一年份内重复季节名称需要提示。
3. Study 新增/编辑页可以多选 season。