docs: sync reachable subject definitions

src/services/subjectsDefinition.md

@@ -94,115 +94,141 @@ type Record = {
 
 ## 3. Subject Definitions
 
-## 3.1 党风廉政建设
-
-本模块使用 6 个独立 Subject 承载不同台账类型。每条台账记录对应一条 `Record`，业务字段全部写入 `metadata`，附件字段按多文件数组存储，结构为 `{ name, type, size, url }`。
-
-统一约定：
-
-- 日期字段页面和 Excel 展示为 `YYYY-MM-DD`，保存时前端转换为 ISO 8601 字符串
-- Excel 导入不处理附件列，附件仅通过系统上传控件维护
-- `title` 由前端按各对象核心字段自动生成，不提供单独标题字段
-- `sequence_no` 仅用于台账顺序和历史 Excel 对照，不作为主键
-- 当前阶段不做导入重复判断，Excel 导入全部新增
-
-### 3.1.1 党风廉政培训记录
-
-- **subject**: `integrity_party_training`
-- **title 生成**：`培训类别 + 授课主题 + 时间`
-
-| 字段标签 | 字段别名 | 字段类型 | 默认值 | 是否主键 | 是否多值 | 是否必填 | 搜索 | 聚合 | 说明 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| 序号 | `sequence_no` | `number` | `null` | 否 | 否 | 否 | 否 | 否 | 台账顺序号 |
-| 培训类别 | `training_category` | `select` | `null` | 否 | 否 | 是 | 否 | 否 | 选项：廉政党课讲授、廉洁合规培训、专题廉洁合规教育培训、新员工廉洁教育培训 |
-| 时间 | `training_date` | `date` | `null` | 否 | 否 | 是 | 否 | 否 | 培训日期 |
-| 培训对象 | `training_target` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 培训覆盖对象 |
-| 培训形式 | `training_format` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 培训方式 |
-| 牵头部门 | `lead_department` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 牵头组织部门 |
-| 授课人 | `lecturer` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 授课人员 |
-| 授课主题 | `lecture_topic` | `text` | `null` | 否 | 否 | 是 | 否 | 否 | 培训主题 |
-| 主要内容 | `main_content` | `long_text` | `null` | 否 | 否 | 否 | 否 | 否 | 培训主要内容 |
-| 参加人数 | `participant_count` | `number` | `null` | 否 | 否 | 否 | 否 | 否 | 实际参加人数 |
-| 课件材料 | `courseware_materials` | `file` | `[]` | 否 | 是 | 否 | 否 | 否 | 系统内上传的 PPT、PDF 等课件 |
-| 签到表 | `sign_in_sheets` | `file` | `[]` | 否 | 是 | 否 | 否 | 否 | 系统内上传签到材料 |
-
-### 3.1.2 党风廉政谈话记录
-
-- **subject**: `integrity_party_talk`
-- **title 生成**：`姓名 + 年份 + 本年度计划谈话时间`
-
-| 字段标签 | 字段别名 | 字段类型 | 默认值 | 是否主键 | 是否多值 | 是否必填 | 搜索 | 聚合 | 说明 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| 序号 | `sequence_no` | `number` | `null` | 否 | 否 | 否 | 否 | 否 | 台账顺序号 |
-| 年份 | `year` | `number` | `null` | 否 | 否 | 是 | 否 | 否 | 台账年份 |
-| 姓名 | `person_name` | `text` | `null` | 否 | 否 | 是 | 否 | 否 | 谈话对象姓名 |
-| 所属一级部门 | `primary_department` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 一级部门名称 |
-| 岗位名称 | `position_name` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 岗位名称 |
-| 岗位晋升时间 | `promotion_date` | `date` | `null` | 否 | 否 | 否 | 否 | 否 | 岗位晋升日期 |
-| 是否党员 | `is_party_member` | `boolean` | `null` | 否 | 否 | 否 | 否 | 否 | 三态：是、否、未填写 |
-| 是否领导干部 | `is_leader` | `boolean` | `null` | 否 | 否 | 否 | 否 | 否 | 三态：是、否、未填写 |
-| 是否投资序列 | `is_investment_sequence` | `boolean` | `null` | 否 | 否 | 否 | 否 | 否 | 三态：是、否、未填写 |
-| 最近一期谈话时间 | `latest_talk_date` | `date` | `null` | 否 | 否 | 否 | 否 | 否 | 最近一次谈话日期 |
-| 本年度计划谈话时间 | `planned_talk_date` | `date` | `null` | 否 | 否 | 否 | 否 | 否 | 本年度计划谈话日期 |
-| 是否应做任前谈话 | `should_pre_appointment_talk` | `boolean` | `null` | 否 | 否 | 否 | 否 | 否 | 以 OA 转岗流程或发文为准 |
-| 是否已做任前谈话 | `has_pre_appointment_talk` | `boolean` | `null` | 否 | 否 | 否 | 否 | 否 | 三态：是、否、未填写 |
-| 是否纪委书记主动约谈 | `is_discipline_secretary_interview` | `boolean` | `null` | 否 | 否 | 否 | 否 | 否 | 报送口径字段 |
-| 本年度实际谈话时间 | `actual_talk_date` | `date` | `null` | 否 | 否 | 否 | 否 | 否 | 本年度实际谈话日期 |
-| 谈话支持材料 | `talk_materials` | `file` | `[]` | 否 | 是 | 否 | 否 | 否 | 系统内上传谈话材料 |
-
-### 3.1.3 党风廉政调研记录
-
-- **subject**: `integrity_party_research`
-- **title 生成**：`调研单位 + 调研时间`
-
-| 字段标签 | 字段别名 | 字段类型 | 默认值 | 是否主键 | 是否多值 | 是否必填 | 搜索 | 聚合 | 说明 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| 序号 | `sequence_no` | `number` | `null` | 否 | 否 | 否 | 否 | 否 | 台账顺序号 |
-| 调研时间 | `research_date` | `date` | `null` | 否 | 否 | 是 | 否 | 否 | 调研日期 |
-| 调研人员及职务 | `research_staff_and_position` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 调研人员和职务描述 |
-| 调研单位 | `research_unit` | `text` | `null` | 否 | 否 | 是 | 否 | 否 | 被调研单位 |
-| 调研内容 | `research_content` | `long_text` | `null` | 否 | 否 | 否 | 否 | 否 | 调研主要内容 |
-| 调研收集的建议意见 | `survey_suggestions` | `long_text` | `null` | 否 | 否 | 否 | 否 | 否 | 调研过程中收集的建议意见 |
-| 调研方案或调研报告 | `research_report_materials` | `file` | `[]` | 否 | 是 | 否 | 否 | 否 | 系统内上传调研方案或报告 |
-| 备注 | `remarks` | `long_text` | `null` | 否 | 否 | 否 | 否 | 否 | 备注信息 |
-
-### 3.1.4 党风廉政专题会议记录
-
-- **subject**: `integrity_party_meeting`
-- **title 生成**：`会议议题 + 会议时间`
-
-| 字段标签 | 字段别名 | 字段类型 | 默认值 | 是否主键 | 是否多值 | 是否必填 | 搜索 | 聚合 | 说明 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| 序号 | `sequence_no` | `number` | `null` | 否 | 否 | 否 | 否 | 否 | 台账顺序号 |
-| 会议时间 | `meeting_date` | `date` | `null` | 否 | 否 | 是 | 否 | 否 | 会议日期 |
-| 会议议题 | `meeting_topic` | `text` | `null` | 否 | 否 | 是 | 否 | 否 | 会议议题 |
-| 会议主要内容 | `main_content` | `long_text` | `null` | 否 | 否 | 否 | 否 | 否 | 会议主要内容 |
-| 支持材料 | `supporting_materials` | `file` | `[]` | 否 | 是 | 否 | 否 | 否 | 系统内上传会议支持材料 |
-
-### 3.1.5 廉洁主题活动记录
-
-- **subject**: `integrity_party_activity`
-- **title 生成**：`活动主题 + 开展年份`
-
-| 字段标签 | 字段别名 | 字段类型 | 默认值 | 是否主键 | 是否多值 | 是否必填 | 搜索 | 聚合 | 说明 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| 序号 | `sequence_no` | `number` | `null` | 否 | 否 | 否 | 否 | 否 | 台账顺序号 |
-| 开展年份 | `year` | `number` | `null` | 否 | 否 | 是 | 否 | 否 | 活动开展年份 |
-| 活动主题 | `activity_theme` | `text` | `null` | 否 | 否 | 是 | 否 | 否 | 活动主题 |
-| 活动形式 | `activity_format` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 活动形式 |
-| 活动成果 | `activity_result` | `long_text` | `null` | 否 | 否 | 否 | 否 | 否 | 活动成果描述 |
-| 支持材料 | `supporting_materials` | `file` | `[]` | 否 | 是 | 否 | 否 | 否 | 系统内上传活动支持材料 |
-
-### 3.1.6 节前廉洁提醒记录
-
-- **subject**: `integrity_party_holiday_reminder`
-- **title 生成**：`年份 + 重大节假日`
-
-| 字段标签 | 字段别名 | 字段类型 | 默认值 | 是否主键 | 是否多值 | 是否必填 | 搜索 | 聚合 | 说明 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| 年份 | `year` | `number` | `null` | 否 | 否 | 是 | 否 | 否 | 台账年份 |
-| 重大节假日 | `holiday_name` | `select` | `null` | 否 | 否 | 是 | 否 | 否 | 选项：元旦、春节、清明、五一、端午、中秋、国庆、其他 |
-| 其他节假日说明 | `holiday_other` | `text` | `null` | 否 | 否 | 否 | 否 | 否 | 选择其他时补充说明 |
-| 廉洁谈话提纲上传 | `talk_outline_materials` | `file` | `[]` | 否 | 是 | 否 | 否 | 否 | 系统内上传谈话提纲 |
-| 廉洁提醒支持材料上传 | `reminder_materials` | `file` | `[]` | 否 | 是 | 否 | 否 | 否 | 系统内上传提醒材料 |
-| 其他活动举措 | `other_measures` | `long_text` | `null` | 否 | 否 | 否 | 否 | 否 | 其他举措说明 |
+字段结构由下方托管区块维护，以 Subject API 同步结果为准。
+
+党风廉政建设模块约定：每条台账记录对应一条 `Record`，业务字段全部写入 `metadata`；日期页面和 Excel 展示为 `YYYY-MM-DD`，保存时转换为 ISO 8601 字符串；附件字段按 `{ name, type, size, url }[]` 维护，Excel 导入不处理附件列；`title` 由前端按各对象核心字段自动生成；`sequence_no` 仅用于台账顺序和历史 Excel 对照；当前阶段 Excel 导入全部新增，不做重复判断。
+
+<!-- SUBJECT_SCHEMA_SYNC:START -->
+
+> 同步根对象：`am_material`、`integrity_party_activity`、`integrity_party_holiday_reminder`、`integrity_party_meeting`、`integrity_party_research`、`integrity_party_talk`、`integrity_party_training`
+> 当前依赖闭包：7 个 Subject。
+
+### `am_material`：审计材料文件
+
+- 类型：`normal`
+- 字段数量：14
+
+| 字段标签 | 字段别名 | 字段类型 | 多值 | 必填 | 主键 | 关联/配置 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 材料名称 | `material_title` | text | 否 | 是 | 否 |  |
+| 文件对象 | `file_asset` | file | 否 | 是 | 否 |  |
+| 来源应用 | `source_app` | text | 否 | 否 | 否 |  |
+| 来源系统 | `source_system` | select | 否 | 否 | 否 | options: 投资交易系统, 估值系统, 注册登记系统, OA系统, 财务系统, 产品系统, 投研系统, 外部导出, 其他业务系统 |
+| 材料分类 | `archive_category` | select | 否 | 否 | 否 | options: 审计需求, 纪检需求 |
+| 上传人 | `uploader` | user | 否 | 是 | 否 |  |
+| 上传时间 | `uploaded_at` | date | 否 | 是 | 否 |  |
+| 备注 | `remark` | text | 否 | 否 | 否 |  |
+| 标签 | `tag` | text | 否 | 否 | 否 |  |
+| 提供部门 | `provide_department` | text | 否 | 否 | 否 |  |
+| 提供时间 | `provide_time` | date | 否 | 否 | 否 |  |
+| 是否涉密 | `is_confidential` | boolean | 否 | 否 | 否 |  |
+| 是否审计部材料 | `is_audit_dept_material` | boolean | 否 | 否 | 否 |  |
+| 所属年份 | `archive_year` | text | 否 | 否 | 否 |  |
+
+### `integrity_party_activity`：廉洁主题活动记录
+
+- 类型：`normal`
+- 字段数量：6
+
+| 字段标签 | 字段别名 | 字段类型 | 多值 | 必填 | 主键 | 关联/配置 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 序号 | `sequence_no` | number | 否 | 否 | 否 |  |
+| 开展年份 | `year` | number | 否 | 是 | 否 |  |
+| 活动主题 | `activity_theme` | text | 否 | 是 | 否 |  |
+| 活动形式 | `activity_format` | text | 否 | 否 | 否 |  |
+| 活动成果 | `activity_result` | long_text | 否 | 否 | 否 |  |
+| 支持材料 | `supporting_materials` | file | 是 | 否 | 否 |  |
+
+### `integrity_party_holiday_reminder`：节前廉洁提醒记录
+
+- 类型：`normal`
+- 字段数量：6
+
+| 字段标签 | 字段别名 | 字段类型 | 多值 | 必填 | 主键 | 关联/配置 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 年份 | `year` | number | 否 | 是 | 否 |  |
+| 重大节假日 | `holiday_name` | select | 否 | 是 | 否 | options: 元旦, 春节, 清明, 五一, 端午, 中秋, 国庆, 其他 |
+| 其他节假日说明 | `holiday_other` | text | 否 | 否 | 否 |  |
+| 廉洁谈话提纲上传 | `talk_outline_materials` | file | 是 | 否 | 否 |  |
+| 廉洁提醒支持材料上传 | `reminder_materials` | file | 是 | 否 | 否 |  |
+| 其他活动举措 | `other_measures` | long_text | 否 | 否 | 否 |  |
+
+### `integrity_party_meeting`：廉洁党建专题会议记录
+
+- 类型：`normal`
+- 字段数量：5
+
+| 字段标签 | 字段别名 | 字段类型 | 多值 | 必填 | 主键 | 关联/配置 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 序号 | `sequence_no` | number | 否 | 否 | 否 |  |
+| 会议时间 | `meeting_date` | date | 否 | 是 | 否 |  |
+| 会议议题 | `meeting_topic` | text | 否 | 是 | 否 |  |
+| 会议主要内容 | `main_content` | text | 否 | 否 | 否 |  |
+| 支持材料 | `supporting_materials` | file | 是 | 否 | 否 |  |
+
+### `integrity_party_research`：廉洁党建调研记录
+
+- 类型：`normal`
+- 字段数量：8
+
+| 字段标签 | 字段别名 | 字段类型 | 多值 | 必填 | 主键 | 关联/配置 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 序号 | `sequence_no` | number | 否 | 否 | 否 |  |
+| 调研时间 | `research_date` | date | 否 | 是 | 否 |  |
+| 调研人员及职务 | `research_staff_and_position` | text | 否 | 否 | 否 |  |
+| 调研单位 | `research_unit` | text | 否 | 是 | 否 |  |
+| 调研内容 | `research_content` | long_text | 否 | 否 | 否 |  |
+| 调研方案或调研报告 | `research_report_materials` | file | 是 | 否 | 否 |  |
+| 备注 | `remarks` | long_text | 否 | 否 | 否 |  |
+| 调研收集的建议意见 | `survey_suggestions` | long_text | 否 | 否 | 否 |  |
+
+### `integrity_party_talk`：廉洁党建谈话记录
+
+- 类型：`normal`
+- 字段数量：16
+
+| 字段标签 | 字段别名 | 字段类型 | 多值 | 必填 | 主键 | 关联/配置 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 序号 | `sequence_no` | number | 否 | 否 | 否 |  |
+| 年份 | `year` | number | 否 | 是 | 否 |  |
+| 姓名 | `person_name` | text | 否 | 是 | 否 |  |
+| 所属一级部门 | `primary_department` | text | 否 | 否 | 否 |  |
+| 岗位名称 | `position_name` | text | 否 | 否 | 否 |  |
+| 岗位晋升时间 | `promotion_date` | text | 否 | 否 | 否 |  |
+| 是否党员 | `is_party_member` | boolean | 否 | 否 | 否 |  |
+| 是否领导干部 | `is_leader` | boolean | 否 | 否 | 否 |  |
+| 是否投资序列 | `is_investment_sequence` | boolean | 否 | 否 | 否 |  |
+| 最近一期谈话时间 | `latest_talk_date` | date | 否 | 否 | 否 |  |
+| 本年度计划谈话时间 | `planned_talk_date` | date | 否 | 否 | 否 |  |
+| 是否应做任前谈话 | `should_pre_appointment_talk` | boolean | 否 | 否 | 否 |  |
+| 是否已做任前谈话 | `has_pre_appointment_talk` | boolean | 否 | 否 | 否 |  |
+| 是否纪委书记主动约谈 | `is_discipline_secretary_interview` | boolean | 否 | 否 | 否 |  |
+| 本年度实际谈话时间 | `actual_talk_date` | date | 否 | 否 | 否 |  |
+| 谈话支持材料 | `talk_materials` | file | 是 | 否 | 否 |  |
+
+### `integrity_party_training`：廉洁党建培训记录
+
+- 类型：`normal`
+- 字段数量：12
+
+| 字段标签 | 字段别名 | 字段类型 | 多值 | 必填 | 主键 | 关联/配置 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 序号 | `sequence_no` | text | 否 | 否 | 否 |  |
+| 培训类别 | `training_category` | select | 否 | 是 | 否 | options: 廉政党课讲授, 廉洁合规培训, 专题廉洁合规教育培训, 新员工廉洁教育培训 |
+| 时间 | `training_date` | date | 否 | 是 | 否 |  |
+| 培训对象 | `training_target` | text | 否 | 否 | 否 |  |
+| 培训形式 | `training_format` | text | 否 | 否 | 否 |  |
+| 牵头部门 | `lead_department` | text | 否 | 否 | 否 |  |
+| 授课人 | `lecturer` | text | 否 | 否 | 否 |  |
+| 授课主题 | `lecture_topic` | text | 否 | 是 | 否 |  |
+| 主要内容 | `main_content` | long_text | 否 | 否 | 否 |  |
+| 参加人数 | `participant_count` | number | 否 | 否 | 否 |  |
+| 课件材料 | `courseware_materials` | file | 是 | 否 | 否 |  |
+| 签到表 | `sign_in_sheets` | file | 是 | 否 | 否 |  |
+
+### 关联对象与子对象定义
+
+依赖字段通过 `settings.subject` 指向的对象会递归纳入本节；`form` 资源不属于 Subject 依赖。
+
+
+<!-- SUBJECT_SCHEMA_SYNC:END -->