pig-farm-controller/design/exceeding-threshold-alarm/task_list.md

阈值告警功能 - 任务清单

本清单按照从底层到上层的依赖关系排序，建议按此顺序进行开发。

1. 基础设施层 (internal/infra)

• 数据库模型 (models):

  • 在 internal/infra/models/ 下创建 alarm.go 文件，定义 ActiveAlarm 和 HistoricalAlarm 两个结构体，包含 status, ignored_until, last_notified_at 等字段。
  • 在 internal/infra/models/schedule.go 中，为 TaskType 新增三个常量：TaskTypeAreaControllerThresholdAlarm, TaskTypeDeviceThresholdAlarm, TaskTypeAlarmNotificationSender。

• 数据库仓库 (repository):

  • 在 internal/infra/repository/ 下创建 alarm_repository.go，实现对 active_alarms 和 historical_alarms 表的增删改查操作，并提供 MoveToHistorical 等方法。
  • 在 internal/infra/repository/device_repository.go 中，为 DeviceRepository 接口及其实现增加 FindByAreaControllerID 方法。

• 配置 (config):

  • 在 config.yml 文件中，新增告警相关的配置项，如 re_notification_interval (重复通知间隔)。
  • 在 internal/infra/config/config.go 中，添加对应的字段来加载该配置。

2. 领域层 (internal/domain)

• 告警领域服务 (alarm):

  • 创建 internal/domain/alarm/ 目录。
  • 在该目录下创建 alarm_service.go，定义 AlarmService 接口及其实现。
  • 实现核心业务逻辑：ReportStatus (处理告警创建/解决) 和 GetAndProcessPendingNotifications (获取待发送通知)。该服务将注入 AlarmRepository 和 NotifyService。

• 任务实现 (task):

  • 创建 area_controller_threshold_alarm_task.go，实现 plan.Task 接口，其 Execute 方法调用 alarmService.ReportStatus。
  • 创建 device_threshold_alarm_task.go，实现逻辑同上。
  • 创建 alarm_notification_sender_task.go，实现 plan.Task 接口，其 Execute 方法调用 alarmService.GetAndProcessPendingNotifications。

3. 应用层 (internal/app)

• 告警配置服务 (service):

  • 创建 alarm_config_service.go，定义 AlarmConfigService，负责告警 配置 的增删改查。
  • 实现 ExcludeDeviceIDs 的计算和更新逻辑。
  • 注入 DeviceRepository 和 AreaControllerRepository。

• 服务集成:

  • 在 plan_service.go (或任务工厂) 中，注册上述三种新的任务类型。
  • 修改 device_service.go，在处理设备更新（更换区域）和删除的方法中，调用 AlarmConfigService 的接口来刷新 ExcludeDeviceIDs。

• 告警配置控制器 (controller):

  • 创建 internal/app/controller/alarm/ 目录及 alarm_controller.go 文件。
  • 实现 Create/Update/Delete/Get 告警配置的 HTTP 接口，调用 AlarmConfigService。

• API 路由 (api):

  • 在 internal/app/api/router.go 中，注册 /api/v1/alarm/region-config 和 /api/v1/alarm/device-config 相关路由，并绑定到 AlarmController 的方法。

4. 核心初始化层 (internal/core)

• 系统计划初始化 (data_initializer.go):
  • 修改 getPredefinedSystemPlans 函数。
  • 将 "定时全量数据采集" 计划重命名为 "周期性系统健康检查"。
  • 在该计划中，于 "全量采集" 任务之后，添加 TaskTypeAreaControllerThresholdAlarm 和 TaskTypeDeviceThresholdAlarm 任务。
  • 新增一个 "告警通知发送" 计划，并为其添加 TaskTypeAlarmNotificationSender 任务。