归档改动方案

Reviewed-on: #57

.air.toml

@@ -0,0 +1,52 @@
+root = "."
+testdata_dir = "testdata"
+tmp_dir = "tmp"
+
+[build]
+  args_bin = []
+  bin = "tmp\\main.exe"
+  cmd = "go build -o ./tmp/main.exe ."
+  delay = 1000
+  exclude_dir = ["assets", "tmp", "vendor", "testdata"]
+  exclude_file = []
+  exclude_regex = ["_test.go"]
+  exclude_unchanged = false
+  follow_symlink = false
+  full_bin = ""
+  include_dir = []
+  include_ext = ["go", "tpl", "tmpl", "html"]
+  include_file = []
+  kill_delay = "0s"
+  log = "build-errors.log"
+  poll = false
+  poll_interval = 0
+  post_cmd = []
+  pre_cmd = []
+  rerun = false
+  rerun_delay = 500
+  send_interrupt = false
+  stop_on_error = false
+
+[color]
+  app = ""
+  build = "yellow"
+  main = "magenta"
+  runner = "green"
+  watcher = "cyan"
+
+[log]
+  main_only = false
+  silent = false
+  time = false
+
+[misc]
+  clean_on_exit = false
+
+[proxy]
+  app_port = 0
+  enabled = false
+  proxy_port = 0
+
+[screen]
+  clear_on_rebuild = false
+  keep_scroll = true

.gitignore

@@ -23,4 +23,5 @@ vendor/
 .env
 
 bin/
-app_logs/
+app_logs/
+tmp/

AGENTS.md

@@ -0,0 +1,18 @@
+<!-- OPENSPEC:START -->
+# OpenSpec Instructions
+
+These instructions are for AI assistants working in this project.
+
+Always open `@/openspec/AGENTS.md` when the request:
+- Mentions planning or proposals (words like proposal, spec, change, plan)
+- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
+- Sounds ambiguous and you need the authoritative spec before coding
+
+Use `@/openspec/AGENTS.md` to learn:
+- How to create and apply change proposals
+- Spec format and conventions
+- Project structure and guidelines
+
+Keep this managed block so 'openspec update' can refresh the instructions.
+
+<!-- OPENSPEC:END -->

Makefile

@@ -39,15 +39,39 @@ test:
 .PHONY: swag
 swag:
 	if exist docs rmdir /s /q docs
-	swag init --parseInternal --parseDependency
+	swag init -g internal/app/api/api.go --parseInternal --parseDependency
 
 
 # 生成protobuf文件
 .PHONY: proto
 proto:
-	protoc --go_out=internal/domain/device/proto --go_opt=paths=source_relative --go-grpc_out=internal/domain/device/proto --go-grpc_opt=paths=source_relative -Iinternal/domain/device/proto internal/domain/device/proto/device.proto
+	protoc --go_out=internal/infra/transport/proto --go_opt=paths=source_relative --go-grpc_out=internal/infra/transport/proto --go-grpc_opt=paths=source_relative -Iinternal/infra/transport/proto internal/infra/transport/proto/device.proto
 
 # 运行代码检查
 .PHONY: lint
 lint:
-	golangci-lint run ./...
+	golangci-lint run ./...
+
+# 测试模式(改动文件自动重编译重启)
+.PHONY: dev
+dev:
+	air
+
+# 启用谷歌浏览器MCP服务器
+.PHONY: mcp-chrome
+mcp-chrome:
+	node "C:\nvm4w\nodejs\node_modules\chrome-devtools-mcp\build\src\index.js"
+
+# 生成文件目录树
+.PHONY: tree
+
+# 定义要额外排除的生成代码目录
+EXCLUDE_CONTEXT_PREFIX = internal/infra/transport/lora/chirp_stack_proto/
+# 最终的文件清单会保存在这里
+OUTPUT_FILE = project_structure.txt
+
+# 使用 PowerShell 脚本块执行 Git 命令和二次过滤
+tree:
+	@powershell -Command "git ls-files --exclude-standard | Select-String -NotMatch '$(EXCLUDE_CONTEXT_PREFIX)' | Out-File -Encoding UTF8 $(OUTPUT_FILE)"
+	@powershell -Command "Add-Content -Path $(OUTPUT_FILE) -Value '$(EXCLUDE_CONTEXT_PREFIX)' -Encoding UTF8"
+	@echo "The project file list has been generated to project_structure.txt"

config.example.yml

@@ -0,0 +1,115 @@
+# 应用基础配置
+app:
+  name: "PigFarmController" # 应用名称
+  version: "1.0.0"          # 应用版本
+  jwt_secret: "your_jwt_secret_key_here" # JWT 签名密钥，请务必修改为强密码
+
+# 服务器配置
+server:
+  port: 8080 # 服务器监听端口
+  mode: "debug" # 服务运行模式: debug, release, test
+
+# 日志配置
+log:
+  level: "info" # 日志级别: debug, info, warn, error, dpanic, panic, fatal
+  format: "console" # 日志输出格式: console, json
+  enable_file: true # 是否同时输出到文件
+  file_path: "app_logs/pig_farm_controller.log" # 日志文件路径
+  max_size: 100 # 单个日志文件最大大小 (MB)
+  max_backups: 7 # 最多保留的旧日志文件数量
+  max_age: 7 # 最多保留的旧日志文件天数
+  compress: true # 是否压缩旧日志文件
+
+# 数据库配置
+database:
+  host: "localhost" # 数据库主机地址
+  port: 5432 # 数据库端口
+  username: "postgres" # 数据库用户名
+  password: "your_db_password" # 数据库密码
+  dbname: "pig_farm_controller_db" # 数据库名称
+  sslmode: "disable" # SSL模式: disable, require, verify-ca, verify-full
+  is_timescaledb: false # 是否为 TimescaleDB
+  max_open_conns: 100 # 最大开放连接数
+  max_idle_conns: 10 # 最大空闲连接数
+  conn_max_lifetime: 300 # 连接最大生命周期 (秒)
+
+# WebSocket配置
+websocket:
+  timeout: 60 # WebSocket请求超时时间 (秒)
+  heartbeat_interval: 30 # 心跳检测间隔 (秒)
+
+# 心跳配置
+heartbeat:
+  interval: 10 # 心跳间隔 (秒)
+  concurrency: 5 # 请求并发数
+
+# ChirpStack API 配置
+chirp_stack:
+  api_host: "http://localhost:8080" # ChirpStack API 主机地址
+  api_token: "your_chirpstack_api_token" # ChirpStack API Token
+  fport: 10 # ChirpStack FPort
+  api_timeout: 10 # ChirpStack API请求超时时间(秒)
+  # 等待设备上行响应的超时时间(秒)。
+  # 对于LoRaWAN这种延迟较高的网络，建议设置为5分钟 (300秒) 或更长。
+  collection_request_timeout: 300
+
+# 任务调度配置
+task:
+  interval: 5 # 任务调度间隔 (秒)
+  num_workers: 5 # 任务执行器并发工作数量
+
+# Lora 配置
+lora:
+  mode: "lora_mesh" # Lora 运行模式: lora_wan, lora_mesh
+
+# Lora Mesh 配置
+lora_mesh:
+  # 主节点串口
+  uart_port: "COM7"
+  # LoRa模块的通信波特率
+  baud_rate: 9600
+  # 等待LoRa模块AT指令响应的超时时间(ms)
+  timeout: 50
+  # LoRa Mesh 模块发送模式(EC: 透传; ED: 完整数据包)
+  # e.g.
+  #   EC: 接收端只会接收到消息, 不会接收到请求头
+  #       e.g. 发送: EC 05 02 01 48 65 6c 6c 6f
+  #            (EC + 05(消息长度) + 0201(地址) + "Hello"(消息本体))
+  #            接收: 48 65 6c 6c 6f ("Hello")
+  #   ED: 接收端会接收完整数据包，包含自定义协议头和地址信息。
+  #       e.g. 发送: ED 05 12 34 01 00 01 02 03
+  #            (ED(帧头) + 05(Length, 即 1(总包数)+1(当前包序号)+3(数据块)) + 12 34(目标地址) + 01(总包数) + 00(当前包序号) + 01 02 03(数据块))
+  #            接收: ED 05 12 34 01 00 01 02 03 56 78(56 78 是发送方地址,会自动拼接到消息末尾)
+  lora_mesh_mode: "ED"
+  # 单包最大用户数据数据长度, 模块限制240, 去掉两位自定义包头, 还剩238
+  max_chunk_size: 238
+  #分片重组超时时间（秒）。如果在一个分片到达后，超过这个时间
+  # 还没收到完整的包，则认为接收失败。
+  reassembly_timeout: 30
+
+# 通知服务配置
+notify:
+  primary: "日志" # 首选通知渠道: "邮件", "企业微信", "飞书", "日志" (如果其他渠道未启用，"日志" 会自动成为首选)
+  failureThreshold: 2 # 连续失败多少次后触发广播模式
+  smtp:
+    enabled: false # 是否启用 SMTP 邮件通知
+    host: "smtp.example.com" # SMTP 服务器地址
+    port: 587 # SMTP 服务器端口
+    username: "your_email@example.com" # 发件人邮箱地址
+    password: "your_email_password" # 发件人邮箱授权码或密码
+    sender: "PigFarm Alarm <no-reply@example.com>" # 发件人名称和地址
+
+  wechat:
+    enabled: false # 是否启用企业微信通知
+    corpID: "wwxxxxxxxxxxxx" # 企业ID (CorpID)
+    agentID: "1000001" # 应用ID (AgentID)
+    secret: "your_wechat_app_secret" # 应用密钥 (Secret)
+
+  lark:
+    enabled: false # 是否启用飞书通知
+    appID: "cli_xxxxxxxxxx" # 应用 ID
+    appSecret: "your_lark_app_secret" # 应用密钥
+
+# 定时采集配置
+collection:
+  interval: 1 # 采集间隔 (分钟)

config.yml

@@ -8,7 +8,7 @@ app:
 # HTTP 服务配置
 server:
   port: 8086
-  mode: "release" # Gin 运行模式: "debug", "release", "test"
+  mode: "release" # 服务运行模式: "debug", "release", "test"
 
 # 日志配置
 log:
@@ -58,4 +58,36 @@ chirp_stack:
 # 任务调度器配置
 task:
   interval: 3
-  num_workers: 5
+  num_workers: 5
+
+# Lora 配置
+lora:
+  mode: "lora_mesh" # "lora_wan" or "lora_mesh"
+
+lora_mesh:
+  # 主节点串口
+  uart_port: "COM7"
+  # LoRa模块的通信波特率
+  baud_rate: 9600
+  # 等待LoRa模块AT指令响应的超时时间(ms)
+  timeout: 50
+  # LoRa Mesh 模块发送模式(EC: 透传; ED: 完整数据包)
+  # e.g.
+  #   EC: 接收端只会接收到消息, 不会接收到请求头
+  #       e.g. 发送: EC 05 02 01 48 65 6c 6c 6f
+  #            (EC + 05(消息长度) + 0201(地址) + "Hello"(消息本体))
+  #            接收: 48 65 6c 6c 6f ("Hello")
+  #   ED: 接收端会接收完整数据包，包含自定义协议头和地址信息。
+  #       e.g. 发送: ED 05 12 34 01 00 01 02 03
+  #            (ED(帧头) + 05(Length, 即 1(总包数)+1(当前包序号)+3(数据块)) + 12 34(目标地址) + 01(总包数) + 00(当前包序号) + 01 02 03(数据块))
+  #            接收: ED 05 12 34 01 00 01 02 03 56 78(56 78 是发送方地址,会自动拼接到消息末尾)
+  lora_mesh_mode: "ED"
+  # 单包最大用户数据数据长度, 模块限制240, 去掉两位自定义包头, 还剩238
+  max_chunk_size: 238
+  #分片重组超时时间（秒）。如果在一个分片到达后，超过这个时间
+  # 还没收到完整的包，则认为接收失败。
+  reassembly_timeout: 30
+
+# 定时采集配置
+collection:
+  interval: 1 # 采集间隔 (分钟)

design/archive/2025-11-3-verification-before-device-deletion/add_get_device_id_configs_to_task.md

@@ -0,0 +1,34 @@
+# 任务接口增加获取关联设备ID方法设计
+
+## 1. 需求
+
+为了在设备删除前进行验证，需要为任务接口增加一个方法，该方法能够直接返回指定任务配置中所有关联的设备ID列表。所有实现 `task` 接口的对象都必须实现此方法。
+
+## 2. 新接口定义：`TaskDeviceIDResolver`
+
+```go
+// TaskDeviceIDResolver 定义了从任务配置中解析设备ID的方法
+type TaskDeviceIDResolver interface {
+    // ResolveDeviceIDs 从任务配置中解析并返回所有关联的设备ID列表
+    // 返回值: uint数组，每个字符串代表一个设备ID
+    ResolveDeviceIDs() ([]uint, error)
+}
+```
+
+## 3. `task` 接口更新
+
+`task` 接口将嵌入 `TaskDeviceIDResolver` 接口。
+
+```go
+// Task 接口（示例，具体结构可能不同）
+type Task interface {
+	// ... 其他现有方法 ...
+
+	// 嵌入 TaskDeviceIDResolver 接口
+	TaskDeviceIDResolver
+}
+```
+
+## 4. 实现要求
+
+所有当前及未来实现 `Task` 接口的类型，都必须实现 `TaskDeviceIDResolver` 接口中定义的所有方法，即 `ResolveDeviceIDs` 方法。

design/archive/2025-11-3-verification-before-device-deletion/check_before_device_deletion.md

@@ -0,0 +1,41 @@
+# 方案：删除设备前的使用校验
+
+## 1. 目标
+
+在删除设备前，检查该设备是否被任何任务关联。如果设备正在被使用，则禁止删除，并向用户返回明确的错误提示。
+
+## 2. 核心思路
+
+我们将遵循您项目清晰的分层架构，将“检查设备是否被任务使用”这一业务规则放在 **应用层** (`internal/app/service/`)
+中进行协调。当上层请求删除设备时，应用服务会先调用仓库层查询 `device_tasks` 关联表，如果发现设备仍被任务关联，则会拒绝删除并返回一个明确的业务错误。
+
+## 3. 实施步骤
+
+### 3.1. 仓库层 (`DeviceRepository`)
+
+-   **动作**: 在 `internal/infra/repository/device_repository.go` 的 `DeviceRepository` 接口中，增加一个新方法
+    `IsDeviceInUse(deviceID uint) (bool, error)`。
+-   **实现**: 在 `gormDeviceRepository` 中实现此方法。该方法将通过对 `models.DeviceTask` 模型执行 `Count`
+    操作来高效地判断是否存在 `device_id` 匹配的记录。这比查询完整记录性能更好。
+
+### 3.2. 应用层 (`DeviceService`)
+
+-   **动作**:
+    1.  在 `internal/app/service/device_service.go` 文件顶部定义一个新的错误变量 `ErrDeviceInUse`，例如
+        `var ErrDeviceInUse = errors.New("设备正在被一个或多个任务使用，无法删除")`。
+    2.  修改该文件中的 `DeleteDevice` 方法。
+-   **实现**: 在 `DeleteDevice` 方法中，在调用 `s.deviceRepo.Delete()` 之前，先调用我们刚刚创建的
+    `s.deviceRepo.IsDeviceInUse()` 方法。如果返回 `true`，则立即返回 `ErrDeviceInUse` 错误，中断删除流程。
+
+### 3.3. 表现层 (`DeviceController`)
+
+-   **动作**: 修改 `internal/app/controller/device/device_controller.go` 中的 `DeleteDevice` 方法。
+-   **实现**: 在错误处理逻辑中，增加一个 `case` 来专门捕获从服务层返回的 `service.ErrDeviceInUse`
+    错误。当捕获到此错误时，返回一个带有明确提示信息（如“设备正在被任务使用，无法删除”）和合适 HTTP 状态码（例如 `409 Conflict`）的错误响应。
+
+## 4. 方案优势
+
+-   **职责清晰**: 业务流程的编排和校验逻辑被正确地放置在应用层，符合您项目清晰的分层架构。
+-   **高效查询**: 通过 `COUNT` 查询代替 `Find`，避免了不必要的数据加载，性能更佳。
+-   **代码内聚**: 与设备相关的数据库操作都统一封装在 `DeviceRepository` 中。
+-   **用户友好**: 通过在控制器层处理特定业务错误，可以给前端返回明确、可操作的错误信息。

design/archive/2025-11-3-verification-before-device-deletion/device_task_association_maintenance.md

@@ -0,0 +1,111 @@
+# 方案：维护设备与任务的关联关系
+
+## 1. 目标
+
+在对计划（Plan）及其包含的任务（Task）进行创建、更新、删除（CRUD）操作时，同步维护 `device_tasks` 这张多对多关联表。
+
+这是实现“删除设备前检查其是否被任务使用”这一需求的基础。
+
+## 2. 核心挑战
+
+1. **参数结构异构性**：不同类型的任务（`TaskType`），其设备 ID 存储在 `Parameters` (JSON) 字段中的 `key` 和数据结构（单个 ID
+   或 ID 数组）各不相同。
+2. **分层架构原则**：解析 `Parameters` 以提取设备 ID 的逻辑属于 **业务规则**，需要找到一个合适的位置来封装它，以维持各层职责的清晰。
+
+## 3. 方案设计
+
+本方案旨在最大化地复用现有领域模型和逻辑，通过扩展 `TaskFactory` 来实现设备ID的解析，从而保持了各领域模块的高内聚和低耦合。
+
+### 3.1. 核心思路：复用领域对象与工厂
+
+我们不移动任何结构体，也不在 `plan` 包中引入任何具体任务的实现细节。取而代之，我们利用现有的 `TaskFactory`
+和各个任务领域对象自身的能力来解析参数。
+
+每个具体的任务领域对象（如 `ReleaseFeedWeightTask`）最了解如何解析自己的 `Parameters`。因此，我们将解析设备ID的责任完全交还给它们。
+
+### 3.2. 扩展 `TaskFactory`
+
+- **动作**：在 `plan.TaskFactory` 接口中增加一个新方法 `CreateTaskFromModel(*models.Task) (TaskDeviceIDResolver, error)`。
+- **目的**：此方法允许我们在非任务执行的场景下（例如，在增删改查计划时），仅根据数据库模型 `models.Task` 来创建一个临时的、轻量级的任务领域对象。
+- **实现**：在 `internal/domain/task/task.go` 的 `taskFactory` 中实现此方法。它会根据传入的 `taskModel.Type`，`switch-case`
+  来调用相应的构造函数（如 `NewReleaseFeedWeightTask`）创建实例。
+- **实现**：
+- **优势**：
+    - **高内聚，低耦合**：`plan` 包保持通用，无需了解任何具体任务的参数细节。参数定义和解析逻辑都保留在各自的 `task` 包内。
+    - **逻辑复用**：完美复用了您已在 `ReleaseFeedWeightTask` 中实现的 `ResolveDeviceIDs` 方法，避免了重复代码。
+
+### 3.3. 调整领域服务层 (`PlanService`)
+
+`PlanService` 将作为此业务用例的核心编排者。借助 `UnitOfWork` 模式，它可以在单个事务中协调多个仓库，完成数据准备和持久化。
+
+- **职责**：在创建或更新计划的业务流程中，负责解析任务参数、准备设备关联数据，并调用仓库层完成持久化。
+- **实现**：
+    - 向 `planServiceImpl` 注入 `repository.UnitOfWork` 和 `plan.TaskFactory`。
+    - 在 `CreatePlan` 和 `UpdatePlan` 方法中，使用 `unitOfWork.ExecuteInTransaction` 来包裹整个操作。
+    - 在事务闭包内，遍历计划中的所有任务 (`models.Task`)：
+        1. 调用 `taskFactory.CreateTaskFromModel(taskModel)` 创建一个临时的任务领域对象。
+        2. 调用该领域对象的 `ResolveDeviceIDs()` 方法获取设备ID列表。
+        3. 使用事务性的 `DeviceRepository` 查询出设备实体。
+        4. 将查询到的设备实体列表填充到 `taskModel.Devices` 字段中。
+    - 最后，将填充好关联数据的 `plan` 对象传递给事务性的 `PlanRepository` 进行创建或更新。
+- **优势**：
+    - **职责清晰**：`PlanService` 完整地拥有了“创建/更新计划”的业务逻辑，而仓库层则回归到纯粹的数据访问职责。
+    - **数据一致性**：`UnitOfWork` 确保了从准备数据（查询设备）到最终持久化（创建计划和关联）的所有数据库操作都在一个原子事务中完成。
+
+### 3.4. 调整仓库层 (`PlanRepository`)
+
+仓库层被简化，回归其作为数据持久化网关的纯粹角色。
+
+- **职责**：负责 `Plan` 及其直接子对象（`Task`, `SubPlan`）的 CRUD 操作。
+- **实现**：
+    -   `CreatePlan` 和 `UpdatePlanMetadataAndStructure` 方法将被简化。它们不再需要任何特殊的关联处理逻辑（如 `Association().Replace()`）。
+    -   只需接收一个由 `PlanService` 准备好的、`task.Devices` 字段已被填充的 `plan` 对象。
+    -   在 `CreatePlan` 中，调用 `tx.Create(plan)` 时，GORM 会自动级联创建 `Plan`、`Task` 以及 `device_tasks` 中的关联记录。
+    -   在 `UpdatePlanMetadataAndStructure` 的 `reconcileTasks` 逻辑中，对于新创建的任务，GORM 的 `tx.Create(task)` 同样会自动处理其设备关联。
+
+### 3.5. 整体流程
+
+以 **创建计划** 为例：
+
+1. `PlanController` 调用 `PlanService.CreatePlan(plan)`。
+2. `PlanService` 调用 `unitOfWork.ExecuteInTransaction` 启动一个数据库事务。
+3. 在事务闭包内，`PlanService` 遍历 `plan` 对象中的所有 `task`。
+4. 对于每一个 `task` 模型，调用 `taskFactory.CreateTaskFromModel(task)` 创建一个临时的领域对象。
+5. 调用该领域对象的 `ResolveDeviceIDs()` 方法，获取其使用的设备 ID 列表。
+6. 如果返回了设备 ID 列表，则使用事务性的 `DeviceRepository` 查询出 `[]models.Device` 实体。
+7. 所有 `task` 的关联数据准备好后，调用事务性的 `PlanRepository.CreatePlan(plan)`。GORM 在创建 `plan` 和 `task` 的同时，会自动创建
+   `device_tasks` 表中的关联记录。
+8. `UnitOfWork` 提交事务。
+
+**更新计划** 的流程与创建类似，在 `UpdatePlanMetadataAndStructure` 方法中，由于会先删除旧任务再创建新任务，因此在创建新任务后执行相同的设备关联步骤。
+
+**删除计划** 时，由于 `Task` 模型上配置了 `OnDelete:CASCADE`，GORM 会自动删除关联的 `Task` 记录。同时，GORM 的多对多删除逻辑会自动清理
+`device_tasks` 表中与被删除任务相关的记录。因此 `DeletePlan` 方法无需修改。
+
+## 4. 实施步骤
+
+1. **扩展 `TaskFactory` 接口**
+    - 在 `internal/domain/plan/task.go` 文件中，为 `TaskFactory` 接口添加
+      `CreateTaskFromModel(*models.Task) (TaskDeviceIDResolver, error)` 方法。
+
+2. **实现 `TaskFactory` 新方法**
+    - 在 `internal/domain/task/task.go` 文件中，为 `taskFactory` 结构体实现 `CreateTaskFromModel` 方法。
+
+3. **修改 `PlanService`**
+    - 在 `internal/domain/plan/plan_service.go` 中：
+        - 修改 `planServiceImpl` 结构体，增加 `unitOfWork repository.UnitOfWork` 和 `taskFactory TaskFactory` 字段。
+        - 修改 `NewPlanService` 构造函数，接收并注入这些新依赖。
+        - 重构 `CreatePlan` 和 `UpdatePlan` 方法，使用 `UnitOfWork` 包裹事务，并在其中实现数据准备和关联逻辑。
+
+4. **修改 `PlanRepository`**
+    - 在 `internal/infra/repository/plan_repository.go` 中：
+        -   **简化 `CreatePlan` 和 `UpdatePlanMetadataAndStructure` 方法**。移除所有手动处理设备关联的代码（例如，如果之前有 `Association("Devices").Replace()` 等调用，则应删除）。
+        -   确保这两个方法的核心逻辑就是调用 GORM 的 `Create` 或 `Updates`，信任 GORM 会根据传入模型中已填充的 `Devices` 字段来自动维护多对多关联。
+
+5. **修改依赖注入**
+    - 在 `internal/core/component_initializers.go` (或类似的依赖注入入口文件) 中：
+        - 将 `unitOfWork` 和 `taskFactory` 实例传递给 `plan.NewPlanService` 的构造函数。
+
+## 5. 结论
+
+此方案通过复用现有的领域对象和工厂模式，优雅地解决了设备关联维护的问题。它保持了清晰的架构分层和模块职责，在实现功能的同时，为项目未来的扩展和维护奠定了坚实、可扩展的基础。

design/archive/2025-11-3-verification-before-device-deletion/device_task_many_to_many_design.md

@@ -0,0 +1,103 @@
+# 设备与任务多对多关联模型设计
+
+## 需求背景
+
+用户需要为系统中的“设备”和“任务”增加多对多关联，即一个设备可以执行多个任务，一个任务可以被多个设备执行。
+
+## 现有模型分析
+
+### `internal/infra/models/device.go`
+
+`Device` 模型定义：
+
+```go
+type Device struct {
+	gorm.Model
+	Name             string `gorm:"not null" json:"name"`
+	DeviceTemplateID uint   `gorm:"not null;index" json:"device_template_id"`
+	DeviceTemplate   DeviceTemplate `json:"device_template"`
+	AreaControllerID uint   `gorm:"not null;index" json:"area_controller_id"`
+	AreaController   AreaController `json:"area_controller"`
+	Location         string `gorm:"index" json:"location"`
+	Properties       datatypes.JSON `json:"properties"`
+}
+```
+
+### `internal/infra/models/plan.go`
+
+`Task` 模型定义：
+
+```go
+type Task struct {
+	ID        int `gorm:"primarykey"`
+	CreatedAt time.Time
+	UpdatedAt time.Time
+	DeletedAt gorm.DeletedAt `gorm:"index"`
+
+	PlanID         uint           `gorm:"not null;index" json:"plan_id"`
+	Name           string         `gorm:"not null" json:"name"`
+	Description    string         `json:"description"`
+	ExecutionOrder int            `gorm:"not null" json:"execution_order"`
+	Type           TaskType       `gorm:"not null" json:"type"`
+	Parameters     datatypes.JSON `json:"parameters"`
+}
+```
+
+## 方案设计
+
+为了实现设备和任务的多对多关系，我们将引入一个中间关联模型 `DeviceTask`。考虑到 `Task` 模型定义在 `plan.go` 中，为了保持相关模型的内聚性，我们将 `DeviceTask` 模型也定义在 `internal/infra/models/plan.go` 文件中。
+
+### 1. 在 `internal/infra/models/plan.go` 中新增 `DeviceTask` 关联模型
+
+`DeviceTask` 模型将包含 `DeviceID` 和 `TaskID` 作为外键，以及 GORM 的标准模型字段。
+
+```go
+// DeviceTask 是设备和任务之间的关联模型，表示一个设备可以执行多个任务，一个任务可以被多个设备执行。
+type DeviceTask struct {
+	gorm.Model
+	DeviceID uint `gorm:"not null;index"` // 设备ID
+	TaskID   uint `gorm:"not null;index"` // 任务ID
+
+	// 可选：如果需要存储关联的额外信息，可以在这里添加字段，例如：
+	// Configuration datatypes.JSON `json:"configuration"` // 任务在特定设备上的配置
+}
+
+// TableName 自定义 GORM 使用的数据库表名
+func (DeviceTask) TableName() string {
+	return "device_tasks"
+}
+```
+
+### 2. 修改 `internal/infra/models/device.go`
+
+在 `Device` 结构体中添加 `Tasks` 字段，通过 `gorm:"many2many:device_tasks;"` 标签声明与 `Task` 的多对多关系，并指定中间表名为 `device_tasks`。
+
+```go
+// Device 代表系统中的所有普通设备
+type Device struct {
+	gorm.Model
+
+	// ... 其他现有字段 ...
+
+	// Tasks 是与此设备关联的任务列表，通过 DeviceTask 关联表实现多对多关系
+	Tasks []Task `gorm:"many2many:device_tasks;" json:"tasks"`
+}
+```
+
+### 3. 修改 `internal/infra/models/plan.go`
+
+在 `Task` 结构体中添加 `Devices` 字段，通过 `gorm:"many2many:device_tasks;"` 标签声明与 `Device` 的多对多关系，并指定中间表名为 `device_tasks`。
+
+```go
+// Task 代表计划中的一个任务，具有执行顺序
+type Task struct {
+	// ... 其他现有字段 ...
+
+	// Devices 是与此任务关联的设备列表，通过 DeviceTask 关联表实现多对多关系
+	Devices []Device `gorm:"many2many:device_tasks;" json:"devices"`
+}
+```
+
+## 总结
+
+通过上述修改，我们将在数据库中创建一个名为 `device_tasks` 的中间表，用于存储 `Device` 和 `Task` 之间的关联关系。在 Go 代码层面，`Device` 和 `Task` 模型将能够直接通过 `Tasks` 和 `Devices` 字段进行多对多关系的查询和操作。

design/archive/2025-11-3-verification-before-device-deletion/index.md

@@ -0,0 +1,24 @@
+# 需求
+
+删除设备/设备模板/区域主控前进行校验
+
+## issue
+
+http://git.huangwc.com/pig/pig-farm-controller/issues/50
+
+## 需求描述
+
+1. 删除设备时检测是否被任务使用
+2. 删除设备模板时检测是否被设备使用
+3. 删除区域主控时检测是否被设备使用
+
+# 实现
+
+1. [重构计划领域](./plan_service_refactor.md)
+2. [让任务可以提供自身使用设备](./add_get_device_id_configs_to_task.md)
+3. [现有计划管理逻辑迁移](./plan_service_refactor_to_domain.md)
+4. [增加设备任务关联表](./device_task_many_to_many_design.md)
+5. [增加任务增删改查时对设备任务关联表的维护](./device_task_association_maintenance.md)
+6. [删除设备时检查](./check_before_device_deletion.md)
+7. [删除设备模板时检查和删除区域主控时检查](./refactor_deletion_check.md)
+8. [优化设备服务方法的入参](./refactor_id_conversion.md)

design/archive/2025-11-3-verification-before-device-deletion/plan_service_refactor.md

@@ -0,0 +1,83 @@
+# 计划服务重构设计方案
+
+## 1. 目标
+
+将 `internal/domain/scheduler` 包重构为 `internal/domain/plan`，并创建一个新的 `Service` 对象，将原 `scheduler`
+包中的核心调度逻辑集成到 `Service` 中作为一个子服务，统一由 `Service`
+对外提供服务。此重构旨在提高代码的模块化、可维护性和可测试性，并为后续的“设备删除前校验”功能奠定基础。
+
+## 2. 方案详情
+
+### 2.1. 包重命名
+
+* 将 `internal/domain/scheduler` 目录重命名为 `internal/domain/plan`。
+* 修改 `internal/domain/plan` 目录下所有 Go 文件中的 `package scheduler` 为 `package plan`。
+* 更新 `internal/domain/plan` 目录下所有 Go 文件中所有引用
+  `git.huangwc.com/pig/pig-farm-controller/internal/domain/scheduler` 的导入路径为
+  `git.huangwc.com/pig/pig-farm-controller/internal/domain/plan`。
+
+### 2.2. `internal/domain/plan` 包内部结构调整
+
+* **`internal/domain/plan/task.go`**:
+    * 保持不变。它定义了任务的接口和工厂，是领域内的核心抽象。
+
+* **`internal/domain/plan/plan_execution_manager.go`**:
+    * 将 `Scheduler` 结构体更名为 `ExecutionManagerImpl`。这个名称更准确地反映了它作为计划任务执行的协调者和管理者的具体实现。
+    * 将 `NewScheduler` 构造函数更名为 `NewExecutionManagerImpl`。
+    * 文件内部所有对 `Scheduler` 的引用都将更新为 `ExecutionManagerImpl`。
+
+* **`internal/domain/plan/analysis_plan_task_manager.go`**:
+    * 将 `AnalysisPlanTaskManager` 结构体更名为 `AnalysisPlanTaskManagerImpl`。
+    * 将 `NewAnalysisPlanTaskManager` 构造函数更名为 `NewAnalysisPlanTaskManagerImpl`。
+    * 文件内部所有对 `AnalysisPlanTaskManager` 的引用都将更新为 `AnalysisPlanTaskManagerImpl`。
+
+* **定义领域层接口**:
+    * 在 `internal/domain/plan` 包中定义 `ExecutionManager` 接口，包含 `ExecutionManagerImpl` 对外暴露的所有公共方法。
+    * 在 `internal/domain/plan` 包中定义 `AnalysisPlanTaskManager` 接口，包含 `AnalysisPlanTaskManagerImpl` 对外暴露的所有公共方法。
+    * `ExecutionManagerImpl` 和 `AnalysisPlanTaskManagerImpl` 将分别实现对应的接口。
+
+### 2.3. 创建 `internal/domain/plan/plan_service.go`
+
+* 创建新文件 `internal/domain/plan/plan_service.go`。
+
+* **定义领域服务接口**:
+    * 在 `internal/domain/plan` 包中定义 `Service` 接口，该接口将聚合 `ExecutionManager` 和 `AnalysisPlanTaskManager`
+      的所有公共方法，并由 `planServiceImpl` 实现这些方法的委托。
+
+* **实现领域服务**:
+    * 该文件将定义 `planServiceImpl` 结构体，并包含 `ExecutionManager` 接口和 `AnalysisPlanTaskManager` 接口的实例作为其依赖。
+    * 实现 `NewService` 构造函数，负责接收 `ExecutionManager` 接口和 `AnalysisPlanTaskManager` 接口的实例，并将其注入到
+      `planServiceImpl` 中。
+    * `planServiceImpl` 将对外提供高层次的 API，这些 API 会协调调用其依赖的接口方法。例如：
+        * `Service.Start()` 方法会调用 `ExecutionManager` 接口的 `Start()` 方法。
+        * `Service.Stop()` 方法会调用 `ExecutionManager` 接口的 `Stop()` 方法。
+        * `Service.RefreshPlanTriggers()` 方法会调用 `AnalysisPlanTaskManager` 接口的 `Refresh()` 方法。
+        * `Service.CreateOrUpdateTrigger()` 方法会调用 `AnalysisPlanTaskManager` 接口的 `CreateOrUpdateTrigger()` 方法。
+        * `Service.EnsureAnalysisTaskDefinition()` 方法会调用 `AnalysisPlanTaskManager` 接口的
+          `EnsureAnalysisTaskDefinition()` 方法。
+        * 未来所有与计划相关的领域操作，都将通过 `Service` 接口进行。
+
+### 2.4. 调整依赖注入和引用
+
+* **查找并替换导入路径：** 使用 `grep` 命令查找整个项目中所有引用
+  `git.huangwc.com/pig/pig-farm-controller/internal/domain/scheduler` 的地方，并将其替换为
+  `git.huangwc.com/pig/pig-farm-controller/internal/domain/plan`。
+* **更新 `internal/core/component_initializers.go`**:
+    * 在初始化阶段，我们将创建 `plan.ExecutionManagerImpl` 和 `plan.AnalysisPlanTaskManagerImpl` 的具体实例。
+    * 然后，将这些具体实例作为 `plan.ExecutionManager` 接口和 `plan.AnalysisPlanTaskManager` 接口类型传递给
+      `plan.NewService` 构造函数，创建 `planServiceImpl` 实例。
+    * 最终，`plan.NewService` 返回 `plan.Service` 接口类型。
+    * 应用程序的其他部分将通过 `plan.Service` 接口来访问计划相关的逻辑，而不是直接访问底层的管理器或其具体实现。
+
+## 3. 优势
+
+* **职责分离清晰：** `internal/domain/plan` 包专注于计划领域的核心逻辑和管理，并提供统一的 `Service` 接口作为领域服务的入口。
+* **符合领域驱动设计：** 领域层包含核心业务逻辑和管理器，应用层（如果需要）作为领域层的协调者。
+* **与现有项目风格一致：** 借鉴 `domain/pig` 包的模式，提高了项目内部的一致性。
+* **可测试性增强：** `Service` 可以更容易地进行单元测试，因为其依赖的接口可以被模拟。
+* **可维护性提高：** 当计划相关的业务逻辑发生变化时，可以更精确地定位到需要修改的组件。
+* **松耦合：** `Service` 不依赖于具体的实现，而是依赖于接口，提高了系统的灵活性和可扩展性。
+
+## 4. 验证和测试
+
+在完成所有修改后，需要运行项目并进行测试，确保调度器功能正常，没有引入新的错误。

design/archive/2025-11-3-verification-before-device-deletion/plan_service_refactor_to_domain.md

@@ -0,0 +1,179 @@
+# 重构方案：将 `app/service/plan_service.go` 的核心逻辑迁移到 `domain/plan/plan_service.go`
+
+## 目标：
+
+*   `app/service/plan_service.go` (应用服务层): 仅负责接收 DTO、将 DTO 转换为领域实体、调用 `domain/plan/plan_service` 的领域方法，并将领域方法返回的领域实体转换为 DTO 返回。
+*   `domain/plan/plan_service.go` (领域层): 封装所有与计划相关的业务逻辑、验证规则、状态管理以及对领域实体的查询操作。
+
+## 详细步骤：
+
+### 第一步：修改 `domain/plan/plan_service.go` (领域层)
+
+1.  **引入必要的依赖**:
+    *   `repository.PlanRepository`：用于与计划数据存储交互。
+    *   `repository.DeviceRepository`：如果计划逻辑中需要设备信息。
+    *   `models.Plan`：领域实体。
+    *   `errors` 和 `gorm.ErrRecordNotFound`：用于错误处理。
+    *   `models.PlanTypeSystem`, `models.PlanStatusEnabled`, `models.PlanContentTypeSubPlans`, `models.PlanContentTypeTasks` 等常量。
+    *   `git.huangwc.com/pig/pig-farm-controller/internal/infra/models`
+    *   `git.huangwc.com/pig/pig-farm-controller/internal/infra/repository`
+    *   `errors`
+    *   `gorm.io/gorm`
+
+2.  **定义领域层错误**: 将 `app/service/plan_service.go` 中定义的错误（`ErrPlanNotFound`, `ErrPlanCannotBeModified` 等）迁移到 `domain/plan/plan_service.go`，并根据领域层的语义进行调整。
+
+    ```go
+    var (
+    	// ErrPlanNotFound 表示未找到计划
+    	ErrPlanNotFound = errors.New("计划不存在")
+    	// ErrPlanCannotBeModified 表示计划不允许修改
+    	ErrPlanCannotBeModified = errors.New("系统计划不允许修改")
+    	// ErrPlanCannotBeDeleted 表示计划不允许删除
+    	ErrPlanCannotBeDeleted = errors.New("系统计划不允许删除")
+    	// ErrPlanCannotBeStarted 表示计划不允许手动启动
+    	ErrPlanCannotBeStarted = errors.New("系统计划不允许手动启动")
+    	// ErrPlanAlreadyEnabled 表示计划已处于启动状态
+    	ErrPlanAlreadyEnabled = errors.New("计划已处于启动状态，无需重复操作")
+    	// ErrPlanNotEnabled 表示计划未处于启动状态
+    	ErrPlanNotEnabled = errors.New("计划当前不是启用状态")
+    	// ErrPlanCannotBeStopped 表示计划不允许停止
+    	ErrPlanCannotBeStopped = errors.New("系统计划不允许停止")
+    )
+    ```
+
+3.  **扩展 `plan.Service` 接口**:
+    *   将 `app/service/plan_service.go` 中 `PlanService` 接口的所有方法（`CreatePlan`, `GetPlanByID`, `ListPlans`, `UpdatePlan`, `DeletePlan`, `StartPlan`, `StopPlan`）添加到 `domain/plan/Service` 接口中。
+    *   这些方法的参数和返回值将直接使用领域实体（`*models.Plan`）或基本类型，而不是 DTO。例如：
+        *   `CreatePlan(plan *models.Plan) (*models.Plan, error)`
+        *   `GetPlanByID(id uint) (*models.Plan, error)`
+        *   `ListPlans(opts repository.ListPlansOptions, page, pageSize int) ([]models.Plan, int64, error)`
+        *   `UpdatePlan(plan *models.Plan) (*models.Plan, error)`
+        *   `DeletePlan(id uint) error`
+        *   `StartPlan(id uint) error`
+        *   `StopPlan(id uint) error`
+
+4.  **修改 `planServiceImpl` 结构体**:
+    *   添加 `planRepo repository.PlanRepository` 字段。
+    *   添加 `deviceRepo repository.DeviceRepository` 字段 (如果需要)。
+    *   `analysisPlanTaskManager plan.AnalysisPlanTaskManager` 字段保持不变。
+
+    ```go
+    type planServiceImpl struct {
+    	executionManager ExecutionManager
+    	taskManager      AnalysisPlanTaskManager
+    	planRepo         repository.PlanRepository // 新增
+    	// deviceRepo       repository.DeviceRepository // 如果需要，新增
+    	logger           *logs.Logger
+    }
+    ```
+
+5.  **实现 `plan.Service` 接口中的新方法**:
+    *   将 `app/service/plan_service.go` 中 `planService` 的所有业务逻辑方法（`CreatePlan`, `GetPlanByID`, `ListPlans`, `UpdatePlan`, `DeletePlan`, `StartPlan`, `StopPlan`）的实现，迁移到 `domain/plan/planServiceImpl` 中。
+    *   **关键修改点**:
+        *   **参数和返回值**: 确保这些方法现在接收和返回的是 `*models.Plan` 或其他领域实体，而不是 DTO。
+        *   **业务逻辑**: 保留所有的业务规则、验证和状态管理逻辑。
+        *   **依赖**: 这些方法将直接调用 `planRepo` 和 `analysisPlanTaskManager`。
+        *   **日志**: 日志记录保持不变，但可能需要调整日志信息以反映领域层的上下文。
+        *   **错误处理**: 错误处理逻辑保持不变，但现在将返回领域层定义的错误。
+        *   **ContentType 自动判断**: `CreatePlan` 和 `UpdatePlan` 中的 `ContentType` 自动判断逻辑应该保留在领域层。
+        *   **执行计数器重置**: `UpdatePlan` 和 `StartPlan` 中的执行计数器重置逻辑应该保留在领域层。
+        *   **系统计划限制**: 对系统计划的修改、删除、启动、停止限制逻辑应该保留在领域层。
+        *   **验证和重排顺序**: `models.Plan` 的 `ValidateExecutionOrder()` 和 `ReorderSteps()` 方法的调用应该在 `CreatePlan` 和 `UpdatePlan` 方法的领域层实现中进行，而不是在 DTO 转换函数中。
+
+6.  **修改 `NewPlanService` 函数**: 接收 `repository.PlanRepository` 和 `repository.DeviceRepository` (如果需要) 作为参数，并注入到 `planServiceImpl` 中。
+
+    ```go
+    func NewPlanService(
+    	executionManager ExecutionManager,
+    	taskManager AnalysisPlanTaskManager,
+    	planRepo repository.PlanRepository, // 新增
+    	// deviceRepo repository.DeviceRepository, // 如果需要，新增
+    	logger *logs.Logger,
+    ) Service {
+    	return &planServiceImpl{
+    		executionManager: executionManager,
+    		taskManager:      taskManager,
+    		planRepo:         planRepo, // 注入
+    		// deviceRepo:       deviceRepo, // 注入
+    		logger:           logger,
+    	}
+    }
+    ```
+
+### 第二步：修改 `app/service/plan_service.go` (应用服务层)
+
+1.  **修改 `planService` 结构体**:
+    *   移除 `planRepo repository.PlanRepository` 字段。
+    *   将 `analysisPlanTaskManager plan.AnalysisPlanTaskManager` 字段替换为 `domainPlanService plan.Service`。
+
+    ```go
+    type planService struct {
+    	logger            *logs.Logger
+    	// planRepo         repository.PlanRepository // 移除
+    	domainPlanService plan.Service // 替换为领域层的服务接口
+    	// analysisPlanTaskManager plan.AnalysisPlanTaskManager // 移除，由 domainPlanService 内部持有
+    }
+    ```
+
+2.  **修改 `NewPlanService` 函数**:
+    *   接收 `domainPlanService plan.Service` 作为参数。
+    *   将 `planRepo` 和 `analysisPlanTaskManager` 的注入替换为 `domainPlanService`。
+
+    ```go
+    func NewPlanService(
+    	logger *logs.Logger,
+    	// planRepo repository.PlanRepository, // 移除
+    	domainPlanService plan.Service, // 接收领域层服务
+    	// analysisPlanTaskManager plan.AnalysisPlanTaskManager, // 移除
+    ) PlanService {
+    	return &planService{
+    		logger:            logger,
+    		domainPlanService: domainPlanService, // 注入领域层服务
+    	}
+    }
+    ```
+
+3.  **修改 `PlanService` 接口**:
+    *   接口定义保持不变，仍然接收和返回 DTO。
+
+4.  **修改 `planService` 接口实现**:
+    *   **`CreatePlan`**:
+        *   接收 `dto.CreatePlanRequest`。
+        *   使用 `dto.NewPlanFromCreateRequest` 将 DTO 转换为 `*models.Plan`。**注意：此时 `NewPlanFromCreateRequest` 不再包含 `ValidateExecutionOrder()` 和 `ReorderSteps()` 的调用。**
+        *   调用 `s.domainPlanService.CreatePlan(*models.Plan)`。
+        *   将返回的 `*models.Plan` 转换为 `dto.PlanResponse`。
+    *   **`GetPlanByID`**:
+        *   调用 `s.domainPlanService.GetPlanByID(id)`。
+        *   将返回的 `*models.Plan` 转换为 `dto.PlanResponse`。
+    *   **`ListPlans`**:
+        *   将 `dto.ListPlansQuery` 转换为 `repository.ListPlansOptions`。
+        *   调用 `s.domainPlanService.ListPlans(...)`。
+        *   将返回的 `[]models.Plan` 转换为 `[]dto.PlanResponse`。
+    *   **`UpdatePlan`**:
+        *   使用 `dto.NewPlanFromUpdateRequest` 将 `dto.UpdatePlanRequest` 转换为 `*models.Plan`。**注意：此时 `NewPlanFromUpdateRequest` 不再包含 `ValidateExecutionOrder()` 和 `ReorderSteps()` 的调用。**
+        *   设置 `plan.ID = id`。
+        *   调用 `s.domainPlanService.UpdatePlan(*models.Plan)`。
+        *   将返回的 `*models.Plan` 转换为 `dto.PlanResponse`。
+    *   **`DeletePlan`**:
+        *   调用 `s.domainPlanService.DeletePlan(id)`。
+    *   **`StartPlan`**:
+        *   调用 `s.domainPlanService.StartPlan(id)`。
+    *   **`StopPlan`**:
+        *   调用 `s.domainPlanService.StopPlan(id)`。
+    *   **错误处理**: 应用服务层将捕获领域层返回的错误，并可能将其转换为更适合应用服务层或表示层的错误信息（例如，将领域层的 `ErrPlanNotFound` 转换为 `app/service` 层定义的 `ErrPlanNotFound`）。
+
+### 第三步：修改 `internal/app/dto/plan_converter.go`
+
+1.  **移除 `NewPlanFromCreateRequest` 和 `NewPlanFromUpdateRequest` 中的领域逻辑**:
+    *   从 `NewPlanFromCreateRequest` 和 `NewPlanFromUpdateRequest` 函数中移除 `plan.ValidateExecutionOrder()` 和 `plan.ReorderSteps()` 的调用。这些逻辑应该由领域服务来处理。
+
+### 第四步：更新 `main.go` 或其他依赖注入点
+
+*   调整 `NewPlanService` 的调用，确保正确注入 `domain/plan/Service` 的实现。
+
+## 风险与注意事项：
+
+*   **事务管理**: 如果领域层的方法需要事务，确保事务在领域层内部或由应用服务层协调。
+*   **错误映射**: 仔细处理领域层错误到应用服务层错误的映射，确保对外暴露的错误信息是恰当的。
+*   **循环依赖**: 确保 `domain` 层不依赖 `app` 层，`app` 层可以依赖 `domain` 层。
+*   **测试**: 重构后需要对所有相关功能进行全面的单元测试和集成测试。

design/archive/2025-11-3-verification-before-device-deletion/refactor_deletion_check.md

@@ -0,0 +1,196 @@
+# 重构方案：将删除前关联检查逻辑迁移至 Service 层
+
+## 1. 目标
+
+将删除**区域主控 (AreaController)** 和**设备模板 (DeviceTemplate)** 时的关联设备检查逻辑，从 Repository（数据访问）层重构至 Service（业务逻辑）层。
+
+## 2. 动机
+
+当前实现中，关联检查逻辑位于 Repository 层的 `Delete` 方法内。这违反了分层架构的最佳实践。Repository 层应仅负责单纯的数据持久化操作（增删改查），而不应包含业务规则。
+
+通过本次重构，我们将实现：
+- **职责分离**: Service 层负责编排业务逻辑（如“删除前必须检查关联”），Repository 层回归其数据访问的单一职责。
+- **代码清晰**: 业务流程在 Service 层一目了然，便于理解和维护。
+- **可测试性增强**: 可以独立测试 Service 层的业务规则，而无需依赖数据库的事务或约束。
+
+## 3. 详细实施步骤
+
+### 第 1 步：在 Service 层定义业务错误
+
+在 `internal/app/service/device_service.go` 文件中，导出两个新的错误变量，用于清晰地表达业务约束。
+
+```go
+// ErrAreaControllerInUse 表示区域主控正在被设备使用，无法删除
+var ErrAreaControllerInUse = errors.New("区域主控正在被一个或多个设备使用，无法删除")
+
+// ErrDeviceTemplateInUse 表示设备模板正在被设备使用，无法删除
+var ErrDeviceTemplateInUse = errors.New("设备模板正在被一个或多个设备使用，无法删除")
+```
+
+### 第 2 步：调整 Repository 接口与实现
+
+#### 2.1 `device_repository.go`
+在 `DeviceRepository` 接口中增加一个方法，用于检查区域主控是否被使用，并在 `gormDeviceRepository` 中实现它。
+
+```go
+// internal/infra/repository/device_repository.go
+
+type DeviceRepository interface {
+    // ... 其他方法
+    IsAreaControllerInUse(areaControllerID uint) (bool, error)
+}
+
+func (r *gormDeviceRepository) IsAreaControllerInUse(areaControllerID uint) (bool, error) {
+    var count int64
+    if err := r.db.Model(&models.Device{}).Where("area_controller_id = ?", areaControllerID).Count(&count).Error; err != nil {
+        return false, fmt.Errorf("检查区域主控使用情况失败: %w", err)
+    }
+    return count > 0, nil
+}
+```
+
+#### 2.2 `area_controller_repository.go`
+简化 `Delete` 方法，移除所有业务逻辑，使其成为一个纯粹的数据库删除操作。
+
+```go
+// internal/infra/repository/area_controller_repository.go
+
+func (r *gormAreaControllerRepository) Delete(id uint) error {
+    // 移除原有的事务和关联检查
+    if err := r.db.Delete(&models.AreaController{}, id).Error; err != nil {
+        return fmt.Errorf("删除区域主控失败: %w", err)
+    }
+    return nil
+}
+```
+
+#### 2.3 `device_template_repository.go`
+同样，简化 `Delete` 方法。`IsInUse` 方法保持不变，因为它仍然是一个有用的查询。
+
+```go
+// internal/infra/repository/device_template_repository.go
+
+func (r *gormDeviceTemplateRepository) Delete(id uint) error {
+    // 移除原有的关联检查逻辑
+    if err := r.db.Delete(&models.DeviceTemplate{}, id).Error; err != nil {
+        return fmt.Errorf("删除设备模板失败: %w", err)
+    }
+    return nil
+}
+```
+
+### 第 3 步：在 Service 层实现业务逻辑
+
+#### 3.1 `device_service.go` - 删除区域主控
+修改 `DeleteAreaController` 方法，加入关联检查的业务逻辑。
+
+```go
+// internal/app/service/device_service.go
+
+func (s *deviceService) DeleteAreaController(id string) error {
+    idUint, err := strconv.ParseUint(id, 10, 64)
+    if err != nil {
+        return fmt.Errorf("无效的ID格式: %w", err)
+    }
+    acID := uint(idUint)
+
+    // 1. 检查是否存在
+    _, err = s.areaControllerRepo.FindByID(acID)
+    if err != nil {
+        return err // 如果未找到，gorm会返回 ErrRecordNotFound
+    }
+
+    // 2. 检查是否被使用（业务逻辑）
+    inUse, err := s.deviceRepo.IsAreaControllerInUse(acID)
+    if err != nil {
+        return err // 返回数据库检查错误
+    }
+    if inUse {
+        return ErrAreaControllerInUse // 返回业务错误
+    }
+
+    // 3. 执行删除
+    return s.areaControllerRepo.Delete(acID)
+}
+```
+
+#### 3.2 `device_service.go` - 删除设备模板
+修改 `DeleteDeviceTemplate` 方法，加入关联检查的业务逻辑。
+
+```go
+// internal/app/service/device_service.go
+
+func (s *deviceService) DeleteDeviceTemplate(id string) error {
+    idUint, err := strconv.ParseUint(id, 10, 64)
+    if err != nil {
+        return fmt.Errorf("无效的ID格式: %w", err)
+    }
+    dtID := uint(idUint)
+
+    // 1. 检查是否存在
+    _, err = s.deviceTemplateRepo.FindByID(dtID)
+    if err != nil {
+        return err
+    }
+
+    // 2. 检查是否被使用（业务逻辑）
+    inUse, err := s.deviceTemplateRepo.IsInUse(dtID)
+    if err != nil {
+        return err
+    }
+    if inUse {
+        return ErrDeviceTemplateInUse // 返回业务错误
+    }
+
+    // 3. 执行删除
+    return s.deviceTemplateRepo.Delete(dtID)
+}
+```
+
+### 第 4 步：在 Controller 层处理新的业务错误
+
+#### 4.1 `device_controller.go` - 删除区域主控
+在 `DeleteAreaController` 的错误处理中，增加对 `ErrAreaControllerInUse` 的捕获，并返回 `409 Conflict` 状态码。
+
+```go
+// internal/app/controller/device/device_controller.go
+
+func (c *Controller) DeleteAreaController(ctx echo.Context) error {
+    // ...
+    if err := c.deviceService.DeleteAreaController(acID); err != nil {
+        switch {
+        case errors.Is(err, gorm.ErrRecordNotFound):
+            // ...
+        case errors.Is(err, service.ErrAreaControllerInUse): // 新增
+            c.logger.Warnf("%s: 尝试删除正在被使用的主控, ID: %s", actionType, acID)
+            return controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), actionType, "主控正在被使用", acID)
+        default:
+            // ...
+        }
+    }
+    // ...
+}
+```
+
+#### 4.2 `device_controller.go` - 删除设备模板
+在 `DeleteDeviceTemplate` 的错误处理中，增加对 `ErrDeviceTemplateInUse` 的捕获，并返回 `409 Conflict` 状态码。
+
+```go
+// internal/app/controller/device/device_controller.go
+
+func (c *Controller) DeleteDeviceTemplate(ctx echo.Context) error {
+    // ...
+    if err := c.deviceService.DeleteDeviceTemplate(dtID); err != nil {
+        switch {
+        case errors.Is(err, gorm.ErrRecordNotFound):
+            // ...
+        case errors.Is(err, service.ErrDeviceTemplateInUse): // 新增
+            c.logger.Warnf("%s: 尝试删除正在被使用的模板, ID: %s", actionType, dtID)
+            return controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), actionType, "模板正在被使用", dtID)
+        default:
+            // ...
+        }
+    }
+    // ...
+}
+```

design/archive/2025-11-3-verification-before-device-deletion/refactor_id_conversion.md

@@ -0,0 +1,106 @@
+# 重构方案：将 ID 类型转换逻辑迁移至 Controller 层
+
+## 1. 目标
+
+将所有通过 URL 路径传入的 `id`（`string` 类型），其到 `uint` 类型的转换和验证逻辑，从 Service（业务逻辑）层统一迁移至 Controller（控制器）层。
+
+## 2. 动机
+
+当前实现中，Controller 将从 URL 获取的 `string` 类型的 ID 直接传递给 Service 层，由 Service 层负责使用 `strconv.ParseUint` 进行类型转换。
+
+这种模式存在以下问题：
+- **职责不清**：Service 层被迫处理了本应属于输入验证和转换的逻辑，而这部分工作更贴近 Controller 的职责。
+- **Service 不纯粹**：业务核心逻辑与原始输入（字符串）耦合，降低了 Service 的可复用性。理想情况下，Service 的接口应该只处理内部定义的、类型安全的数据。
+- **延迟的错误处理**：对于一个无效的 ID（如 "abc"），请求会穿透到 Service 层才会失败，而这种格式错误在 Controller 层就应该被拦截。
+
+通过本次重构，我们将实现：
+- **职责分离**：Controller 负责处理 HTTP 请求的原始数据（验证、转换），Service 负责处理核心业务。
+- **接口清晰**：Service 层的所有方法将只接受类型安全的 `uint` 作为 ID，使其意图更加明确。
+- **快速失败**：无效的 ID 将在 Controller 层被立即拒绝，并返回 `400 Bad Request`，提高了系统的健壮性。
+
+## 3. 详细实施步骤
+
+### 第 1 步：修改 `device_service.go`
+
+#### 3.1 修改 `DeviceService` 接口
+所有接收 `id string` 参数的方法签名，全部修改为接收 `id uint`。
+
+**受影响的方法列表：**
+- `GetDevice(id string)` -> `GetDevice(id uint)`
+- `UpdateDevice(id string, ...)` -> `UpdateDevice(id uint, ...)`
+- `DeleteDevice(id string)` -> `DeleteDevice(id uint)`
+- `ManualControl(id string, ...)` -> `ManualControl(id uint, ...)`
+- `GetAreaController(id string)` -> `GetAreaController(id uint)`
+- `UpdateAreaController(id string, ...)` -> `UpdateAreaController(id uint, ...)`
+- `DeleteAreaController(id string)` -> `DeleteAreaController(id uint)`
+- `GetDeviceTemplate(id string)` -> `GetDeviceTemplate(id uint)`
+- `UpdateDeviceTemplate(id string, ...)` -> `UpdateDeviceTemplate(id uint, ...)`
+- `DeleteDeviceTemplate(id string)` -> `DeleteDeviceTemplate(id uint)`
+
+#### 3.2 修改 `deviceService` 实现
+在 `deviceService` 的方法实现中，移除所有 `strconv.ParseUint` 的调用，直接使用传入的 `uint` 类型的 ID。
+
+**示例 (`DeleteDeviceTemplate`):**
+
+**修改前:**
+```go
+func (s *deviceService) DeleteDeviceTemplate(id string) error {
+    idUint, err := strconv.ParseUint(id, 10, 64)
+    if err != nil {
+        return fmt.Errorf("无效的ID格式: %w", err)
+    }
+    dtID := uint(idUint)
+    // ... 业务逻辑
+}
+```
+
+**修改后:**
+```go
+func (s *deviceService) DeleteDeviceTemplate(id uint) error {
+    // 直接使用 id
+    // ... 业务逻辑
+}
+```
+
+### 第 2 步：修改 `device_controller.go`
+
+在所有调用受影响 Service 方法的 Controller 方法中，增加 ID 的转换和错误处理逻辑。
+
+**示例 (`DeleteDeviceTemplate`):**
+
+**修改前:**
+```go
+func (c *Controller) DeleteDeviceTemplate(ctx echo.Context) error {
+    const actionType = "删除设备模板"
+    dtID := ctx.Param("id") // dtID is a string
+
+    if err := c.deviceService.DeleteDeviceTemplate(dtID); err != nil {
+        // ... 错误处理
+    }
+    // ... 成功处理
+}
+```
+
+**修改后:**
+```go
+func (c *Controller) DeleteDeviceTemplate(ctx echo.Context) error {
+    const actionType = "删除设备模板"
+    idStr := ctx.Param("id")
+
+    // 在 Controller 层进行转换和验证
+    idUint, err := strconv.ParseUint(idStr, 10, 64)
+    if err != nil {
+        c.logger.Warnf("%s: 无效的ID格式: %s", actionType, idStr)
+        return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", actionType, "ID格式错误", idStr)
+    }
+    dtID := uint(idUint)
+
+    // 调用 Service，传入 uint 类型的 ID
+    if err := c.deviceService.DeleteDeviceTemplate(dtID); err != nil {
+        // ... 错误处理 (保持不变)
+    }
+
+    // ... 成功处理
+}
+```
+此模式将应用于所有受影响的 Controller 方法。

go.mod

@@ -3,21 +3,21 @@ module git.huangwc.com/pig/pig-farm-controller
 go 1.25
 
 require (
-	github.com/gin-gonic/gin v1.10.1
 	github.com/go-openapi/errors v0.22.2
 	github.com/go-openapi/runtime v0.28.0
 	github.com/go-openapi/strfmt v0.23.0
-	github.com/go-openapi/swag v0.24.1
+	github.com/go-openapi/swag v0.25.1
 	github.com/go-openapi/validate v0.24.0
 	github.com/golang-jwt/jwt/v5 v5.3.0
+	github.com/google/uuid v1.6.0
+	github.com/labstack/echo/v4 v4.13.4
 	github.com/panjf2000/ants/v2 v2.11.3
 	github.com/robfig/cron/v3 v3.0.1
 	github.com/stretchr/testify v1.11.1
-	github.com/swaggo/files v1.0.1
-	github.com/swaggo/gin-swagger v1.6.1
 	github.com/swaggo/swag v1.16.6
+	github.com/tarm/serial v0.0.0-20180830185346-98f6abe2eb07
 	go.uber.org/zap v1.27.0
-	golang.org/x/crypto v0.42.0
+	golang.org/x/crypto v0.43.0
 	google.golang.org/protobuf v1.36.9
 	gopkg.in/natefinch/lumberjack.v2 v2.2.1
 	gopkg.in/yaml.v2 v2.4.0
@@ -35,35 +35,33 @@ require (
 	github.com/bytedance/sonic v1.14.1 // indirect
 	github.com/bytedance/sonic/loader v0.3.0 // indirect
 	github.com/cloudwego/base64x v0.1.6 // indirect
-	github.com/cloudwego/iasm v0.2.0 // indirect
-	github.com/cpuguy83/go-md2man/v2 v2.0.7 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/gabriel-vasile/mimetype v1.4.10 // indirect
+	github.com/ghodss/yaml v1.0.0 // indirect
 	github.com/gin-contrib/sse v1.1.0 // indirect
 	github.com/go-logr/logr v1.4.1 // indirect
 	github.com/go-logr/stdr v1.2.2 // indirect
 	github.com/go-openapi/analysis v0.23.0 // indirect
-	github.com/go-openapi/jsonpointer v0.22.0 // indirect
-	github.com/go-openapi/jsonreference v0.21.1 // indirect
+	github.com/go-openapi/jsonpointer v0.22.1 // indirect
+	github.com/go-openapi/jsonreference v0.21.2 // indirect
 	github.com/go-openapi/loads v0.22.0 // indirect
-	github.com/go-openapi/spec v0.21.0 // indirect
-	github.com/go-openapi/swag/cmdutils v0.24.0 // indirect
-	github.com/go-openapi/swag/conv v0.24.0 // indirect
-	github.com/go-openapi/swag/fileutils v0.24.0 // indirect
-	github.com/go-openapi/swag/jsonname v0.24.0 // indirect
-	github.com/go-openapi/swag/jsonutils v0.24.0 // indirect
-	github.com/go-openapi/swag/loading v0.24.0 // indirect
-	github.com/go-openapi/swag/mangling v0.24.0 // indirect
-	github.com/go-openapi/swag/netutils v0.24.0 // indirect
-	github.com/go-openapi/swag/stringutils v0.24.0 // indirect
-	github.com/go-openapi/swag/typeutils v0.24.0 // indirect
-	github.com/go-openapi/swag/yamlutils v0.24.0 // indirect
+	github.com/go-openapi/spec v0.22.0 // indirect
+	github.com/go-openapi/swag/cmdutils v0.25.1 // indirect
+	github.com/go-openapi/swag/conv v0.25.1 // indirect
+	github.com/go-openapi/swag/fileutils v0.25.1 // indirect
+	github.com/go-openapi/swag/jsonname v0.25.1 // indirect
+	github.com/go-openapi/swag/jsonutils v0.25.1 // indirect
+	github.com/go-openapi/swag/loading v0.25.1 // indirect
+	github.com/go-openapi/swag/mangling v0.25.1 // indirect
+	github.com/go-openapi/swag/netutils v0.25.1 // indirect
+	github.com/go-openapi/swag/stringutils v0.25.1 // indirect
+	github.com/go-openapi/swag/typeutils v0.25.1 // indirect
+	github.com/go-openapi/swag/yamlutils v0.25.1 // indirect
 	github.com/go-playground/locales v0.14.1 // indirect
 	github.com/go-playground/universal-translator v0.18.1 // indirect
 	github.com/go-playground/validator/v10 v10.27.0 // indirect
 	github.com/go-sql-driver/mysql v1.8.1 // indirect
 	github.com/goccy/go-json v0.10.5 // indirect
-	github.com/google/uuid v1.6.0 // indirect
 	github.com/jackc/pgpassfile v1.0.0 // indirect
 	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
 	github.com/jackc/pgx/v5 v5.6.0 // indirect
@@ -73,8 +71,10 @@ require (
 	github.com/josharian/intern v1.0.0 // indirect
 	github.com/json-iterator/go v1.1.12 // indirect
 	github.com/klauspost/cpuid/v2 v2.3.0 // indirect
+	github.com/labstack/gommon v0.4.2 // indirect
 	github.com/leodido/go-urn v1.4.0 // indirect
 	github.com/mailru/easyjson v0.9.1 // indirect
+	github.com/mattn/go-colorable v0.1.14 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mattn/go-sqlite3 v1.14.22 // indirect
 	github.com/mitchellh/mapstructure v1.5.0 // indirect
@@ -85,27 +85,27 @@ require (
 	github.com/pelletier/go-toml/v2 v2.2.4 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
 	github.com/rogpeppe/go-internal v1.14.1 // indirect
-	github.com/russross/blackfriday/v2 v2.1.0 // indirect
-	github.com/shurcooL/sanitized_anchor_name v1.0.0 // indirect
 	github.com/stretchr/objx v0.5.2 // indirect
+	github.com/swaggo/echo-swagger v1.4.1 // indirect
+	github.com/swaggo/files/v2 v2.0.2 // indirect
 	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
 	github.com/ugorji/go/codec v1.3.0 // indirect
-	github.com/urfave/cli/v2 v2.27.7 // indirect
-	github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 // indirect
+	github.com/valyala/bytebufferpool v1.0.0 // indirect
+	github.com/valyala/fasttemplate v1.2.2 // indirect
 	go.mongodb.org/mongo-driver v1.14.0 // indirect
 	go.opentelemetry.io/otel v1.24.0 // indirect
 	go.opentelemetry.io/otel/metric v1.24.0 // indirect
 	go.opentelemetry.io/otel/trace v1.24.0 // indirect
 	go.uber.org/multierr v1.10.0 // indirect
-	go.yaml.in/yaml/v2 v2.4.3 // indirect
+	go.yaml.in/yaml/v3 v3.0.4 // indirect
 	golang.org/x/arch v0.21.0 // indirect
-	golang.org/x/mod v0.28.0 // indirect
-	golang.org/x/net v0.44.0 // indirect
+	golang.org/x/mod v0.29.0 // indirect
+	golang.org/x/net v0.46.0 // indirect
 	golang.org/x/sync v0.17.0 // indirect
-	golang.org/x/sys v0.36.0 // indirect
-	golang.org/x/text v0.29.0 // indirect
-	golang.org/x/tools v0.37.0 // indirect
+	golang.org/x/sys v0.37.0 // indirect
+	golang.org/x/text v0.30.0 // indirect
+	golang.org/x/time v0.11.0 // indirect
+	golang.org/x/tools v0.38.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 	gorm.io/driver/mysql v1.5.6 // indirect
-	sigs.k8s.io/yaml v1.6.0 // indirect
 )

go.sum

@@ -6,33 +6,21 @@ github.com/asaskevich/govalidator v0.0.0-20230301143203-a9d515a09cc2 h1:DklsrG3d
 github.com/asaskevich/govalidator v0.0.0-20230301143203-a9d515a09cc2/go.mod h1:WaHUgvxTVq04UNunO+XhnAqY/wQc+bxr74GqbsZ/Jqw=
 github.com/bytedance/gopkg v0.1.3 h1:TPBSwH8RsouGCBcMBktLt1AymVo2TVsBVCY4b6TnZ/M=
 github.com/bytedance/gopkg v0.1.3/go.mod h1:576VvJ+eJgyCzdjS+c4+77QF3p7ubbtiKARP3TxducM=
-github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0=
-github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4=
 github.com/bytedance/sonic v1.14.1 h1:FBMC0zVz5XUmE4z9wF4Jey0An5FueFvOsTKKKtwIl7w=
 github.com/bytedance/sonic v1.14.1/go.mod h1:gi6uhQLMbTdeP0muCnrjHLeCUPyb70ujhnNlhOylAFc=
-github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM=
-github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
 github.com/bytedance/sonic/loader v0.3.0 h1:dskwH8edlzNMctoruo8FPTJDF3vLtDT0sXZwvZJyqeA=
 github.com/bytedance/sonic/loader v0.3.0/go.mod h1:N8A3vUdtUebEY2/VQC0MyhYeKUFosQU6FxH2JmUe6VI=
-github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y=
-github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
 github.com/cloudwego/base64x v0.1.6 h1:t11wG9AECkCDk5fMSoxmufanudBtJ+/HemLstXDLI2M=
 github.com/cloudwego/base64x v0.1.6/go.mod h1:OFcloc187FXDaYHvrNIjxSe8ncn0OOM8gEHfghB2IPU=
-github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg=
-github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
-github.com/cpuguy83/go-md2man/v2 v2.0.7 h1:zbFlGlXEAKlwXpmvle3d8Oe3YnkKIK4xSRTd3sHPnBo=
-github.com/cpuguy83/go-md2man/v2 v2.0.7/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0=
-github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcPfT7nKyLpA0lbSSk=
 github.com/gabriel-vasile/mimetype v1.4.10 h1:zyueNbySn/z8mJZHLt6IPw0KoZsiQNszIpU+bX4+ZK0=
 github.com/gabriel-vasile/mimetype v1.4.10/go.mod h1:d+9Oxyo1wTzWdyVUPMmXFvp4F9tea18J8ufA774AB3s=
+github.com/ghodss/yaml v1.0.0 h1:wQHKEahhL6wmXdzwWG11gIVCkOv05bNOh+Rxn0yngAk=
+github.com/ghodss/yaml v1.0.0/go.mod h1:4dBDuWmgqj2HViK6kFavaiC9ZROes6MMH2rRYeMEF04=
 github.com/gin-contrib/gzip v0.0.6 h1:NjcunTcGAj5CO1gn4N8jHOSIeRFHIbn51z6K+xaN4d4=
 github.com/gin-contrib/gzip v0.0.6/go.mod h1:QOJlmV2xmayAjkNS2Y8NQsMneuRShOU/kjovCXNuzzk=
-github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
-github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
 github.com/gin-contrib/sse v1.1.0 h1:n0w2GMuUpWDVp7qSpvze6fAu9iRxJY4Hmj6AmBOU05w=
 github.com/gin-contrib/sse v1.1.0/go.mod h1:hxRZ5gVpWMT7Z0B0gSNYqqsSCNIJMjzvm6fqCz9vjwM=
 github.com/gin-gonic/gin v1.10.1 h1:T0ujvqyCSqRopADpgPgiTT63DUQVSfojyME59Ei63pQ=
@@ -46,48 +34,72 @@ github.com/go-openapi/analysis v0.23.0 h1:aGday7OWupfMs+LbmLZG4k0MYXIANxcuBTYUC0
 github.com/go-openapi/analysis v0.23.0/go.mod h1:9mz9ZWaSlV8TvjQHLl2mUW2PbZtemkE8yA5v22ohupo=
 github.com/go-openapi/errors v0.22.2 h1:rdxhzcBUazEcGccKqbY1Y7NS8FDcMyIRr0934jrYnZg=
 github.com/go-openapi/errors v0.22.2/go.mod h1:+n/5UdIqdVnLIJ6Q9Se8HNGUXYaY6CN8ImWzfi/Gzp0=
-github.com/go-openapi/jsonpointer v0.21.0 h1:YgdVicSA9vH5RiHs9TZW5oyafXZFc6+2Vc1rr/O9oNQ=
-github.com/go-openapi/jsonpointer v0.21.0/go.mod h1:IUyH9l/+uyhIYQ/PXVA41Rexl+kOkAPDdXEYns6fzUY=
 github.com/go-openapi/jsonpointer v0.22.0 h1:TmMhghgNef9YXxTu1tOopo+0BGEytxA+okbry0HjZsM=
 github.com/go-openapi/jsonpointer v0.22.0/go.mod h1:xt3jV88UtExdIkkL7NloURjRQjbeUgcxFblMjq2iaiU=
-github.com/go-openapi/jsonreference v0.21.0 h1:Rs+Y7hSXT83Jacb7kFyjn4ijOuVGSvOdF2+tg1TRrwQ=
-github.com/go-openapi/jsonreference v0.21.0/go.mod h1:LmZmgsrTkVg9LG4EaHeY8cBDslNPMo06cago5JNLkm4=
+github.com/go-openapi/jsonpointer v0.22.1 h1:sHYI1He3b9NqJ4wXLoJDKmUmHkWy/L7rtEo92JUxBNk=
+github.com/go-openapi/jsonpointer v0.22.1/go.mod h1:pQT9OsLkfz1yWoMgYFy4x3U5GY5nUlsOn1qSBH5MkCM=
 github.com/go-openapi/jsonreference v0.21.1 h1:bSKrcl8819zKiOgxkbVNRUBIr6Wwj9KYrDbMjRs0cDA=
 github.com/go-openapi/jsonreference v0.21.1/go.mod h1:PWs8rO4xxTUqKGu+lEvvCxD5k2X7QYkKAepJyCmSTT8=
+github.com/go-openapi/jsonreference v0.21.2 h1:Wxjda4M/BBQllegefXrY/9aq1fxBA8sI5M/lFU6tSWU=
+github.com/go-openapi/jsonreference v0.21.2/go.mod h1:pp3PEjIsJ9CZDGCNOyXIQxsNuroxm8FAJ/+quA0yKzQ=
 github.com/go-openapi/loads v0.22.0 h1:ECPGd4jX1U6NApCGG1We+uEozOAvXvJSF4nnwHZ8Aco=
 github.com/go-openapi/loads v0.22.0/go.mod h1:yLsaTCS92mnSAZX5WWoxszLj0u+Ojl+Zs5Stn1oF+rs=
 github.com/go-openapi/runtime v0.28.0 h1:gpPPmWSNGo214l6n8hzdXYhPuJcGtziTOgUpvsFWGIQ=
 github.com/go-openapi/runtime v0.28.0/go.mod h1:QN7OzcS+XuYmkQLw05akXk0jRH/eZ3kb18+1KwW9gyc=
 github.com/go-openapi/spec v0.21.0 h1:LTVzPc3p/RzRnkQqLRndbAzjY0d0BCL72A6j3CdL9ZY=
 github.com/go-openapi/spec v0.21.0/go.mod h1:78u6VdPw81XU44qEWGhtr982gJ5BWg2c0I5XwVMotYk=
+github.com/go-openapi/spec v0.22.0 h1:xT/EsX4frL3U09QviRIZXvkh80yibxQmtoEvyqug0Tw=
+github.com/go-openapi/spec v0.22.0/go.mod h1:K0FhKxkez8YNS94XzF8YKEMULbFrRw4m15i2YUht4L0=
 github.com/go-openapi/strfmt v0.23.0 h1:nlUS6BCqcnAk0pyhi9Y+kdDVZdZMHfEKQiS4HaMgO/c=
 github.com/go-openapi/strfmt v0.23.0/go.mod h1:NrtIpfKtWIygRkKVsxh7XQMDQW5HKQl6S5ik2elW+K4=
-github.com/go-openapi/swag v0.23.0 h1:vsEVJDUo2hPJ2tu0/Xc+4noaxyEffXNIs3cOULZ+GrE=
-github.com/go-openapi/swag v0.23.0/go.mod h1:esZ8ITTYEsH1V2trKHjAN8Ai7xHb8RV+YSZ577vPjgQ=
 github.com/go-openapi/swag v0.24.1 h1:DPdYTZKo6AQCRqzwr/kGkxJzHhpKxZ9i/oX0zag+MF8=
 github.com/go-openapi/swag v0.24.1/go.mod h1:sm8I3lCPlspsBBwUm1t5oZeWZS0s7m/A+Psg0ooRU0A=
+github.com/go-openapi/swag v0.25.1 h1:6uwVsx+/OuvFVPqfQmOOPsqTcm5/GkBhNwLqIR916n8=
+github.com/go-openapi/swag v0.25.1/go.mod h1:bzONdGlT0fkStgGPd3bhZf1MnuPkf2YAys6h+jZipOo=
 github.com/go-openapi/swag/cmdutils v0.24.0 h1:KlRCffHwXFI6E5MV9n8o8zBRElpY4uK4yWyAMWETo9I=
 github.com/go-openapi/swag/cmdutils v0.24.0/go.mod h1:uxib2FAeQMByyHomTlsP8h1TtPd54Msu2ZDU/H5Vuf8=
+github.com/go-openapi/swag/cmdutils v0.25.1 h1:nDke3nAFDArAa631aitksFGj2omusks88GF1VwdYqPY=
+github.com/go-openapi/swag/cmdutils v0.25.1/go.mod h1:pdae/AFo6WxLl5L0rq87eRzVPm/XRHM3MoYgRMvG4A0=
 github.com/go-openapi/swag/conv v0.24.0 h1:ejB9+7yogkWly6pnruRX45D1/6J+ZxRu92YFivx54ik=
 github.com/go-openapi/swag/conv v0.24.0/go.mod h1:jbn140mZd7EW2g8a8Y5bwm8/Wy1slLySQQ0ND6DPc2c=
+github.com/go-openapi/swag/conv v0.25.1 h1:+9o8YUg6QuqqBM5X6rYL/p1dpWeZRhoIt9x7CCP+he0=
+github.com/go-openapi/swag/conv v0.25.1/go.mod h1:Z1mFEGPfyIKPu0806khI3zF+/EUXde+fdeksUl2NiDs=
 github.com/go-openapi/swag/fileutils v0.24.0 h1:U9pCpqp4RUytnD689Ek/N1d2N/a//XCeqoH508H5oak=
 github.com/go-openapi/swag/fileutils v0.24.0/go.mod h1:3SCrCSBHyP1/N+3oErQ1gP+OX1GV2QYFSnrTbzwli90=
+github.com/go-openapi/swag/fileutils v0.25.1 h1:rSRXapjQequt7kqalKXdcpIegIShhTPXx7yw0kek2uU=
+github.com/go-openapi/swag/fileutils v0.25.1/go.mod h1:+NXtt5xNZZqmpIpjqcujqojGFek9/w55b3ecmOdtg8M=
 github.com/go-openapi/swag/jsonname v0.24.0 h1:2wKS9bgRV/xB8c62Qg16w4AUiIrqqiniJFtZGi3dg5k=
 github.com/go-openapi/swag/jsonname v0.24.0/go.mod h1:GXqrPzGJe611P7LG4QB9JKPtUZ7flE4DOVechNaDd7Q=
+github.com/go-openapi/swag/jsonname v0.25.1 h1:Sgx+qbwa4ej6AomWC6pEfXrA6uP2RkaNjA9BR8a1RJU=
+github.com/go-openapi/swag/jsonname v0.25.1/go.mod h1:71Tekow6UOLBD3wS7XhdT98g5J5GR13NOTQ9/6Q11Zo=
 github.com/go-openapi/swag/jsonutils v0.24.0 h1:F1vE1q4pg1xtO3HTyJYRmEuJ4jmIp2iZ30bzW5XgZts=
 github.com/go-openapi/swag/jsonutils v0.24.0/go.mod h1:vBowZtF5Z4DDApIoxcIVfR8v0l9oq5PpYRUuteVu6f0=
+github.com/go-openapi/swag/jsonutils v0.25.1 h1:AihLHaD0brrkJoMqEZOBNzTLnk81Kg9cWr+SPtxtgl8=
+github.com/go-openapi/swag/jsonutils v0.25.1/go.mod h1:JpEkAjxQXpiaHmRO04N1zE4qbUEg3b7Udll7AMGTNOo=
 github.com/go-openapi/swag/loading v0.24.0 h1:ln/fWTwJp2Zkj5DdaX4JPiddFC5CHQpvaBKycOlceYc=
 github.com/go-openapi/swag/loading v0.24.0/go.mod h1:gShCN4woKZYIxPxbfbyHgjXAhO61m88tmjy0lp/LkJk=
+github.com/go-openapi/swag/loading v0.25.1 h1:6OruqzjWoJyanZOim58iG2vj934TysYVptyaoXS24kw=
+github.com/go-openapi/swag/loading v0.25.1/go.mod h1:xoIe2EG32NOYYbqxvXgPzne989bWvSNoWoyQVWEZicc=
 github.com/go-openapi/swag/mangling v0.24.0 h1:PGOQpViCOUroIeak/Uj/sjGAq9LADS3mOyjznmHy2pk=
 github.com/go-openapi/swag/mangling v0.24.0/go.mod h1:Jm5Go9LHkycsz0wfoaBDkdc4CkpuSnIEf62brzyCbhc=
+github.com/go-openapi/swag/mangling v0.25.1 h1:XzILnLzhZPZNtmxKaz/2xIGPQsBsvmCjrJOWGNz/ync=
+github.com/go-openapi/swag/mangling v0.25.1/go.mod h1:CdiMQ6pnfAgyQGSOIYnZkXvqhnnwOn997uXZMAd/7mQ=
 github.com/go-openapi/swag/netutils v0.24.0 h1:Bz02HRjYv8046Ycg/w80q3g9QCWeIqTvlyOjQPDjD8w=
 github.com/go-openapi/swag/netutils v0.24.0/go.mod h1:WRgiHcYTnx+IqfMCtu0hy9oOaPR0HnPbmArSRN1SkZM=
+github.com/go-openapi/swag/netutils v0.25.1 h1:2wFLYahe40tDUHfKT1GRC4rfa5T1B4GWZ+msEFA4Fl4=
+github.com/go-openapi/swag/netutils v0.25.1/go.mod h1:CAkkvqnUJX8NV96tNhEQvKz8SQo2KF0f7LleiJwIeRE=
 github.com/go-openapi/swag/stringutils v0.24.0 h1:i4Z/Jawf9EvXOLUbT97O0HbPUja18VdBxeadyAqS1FM=
 github.com/go-openapi/swag/stringutils v0.24.0/go.mod h1:5nUXB4xA0kw2df5PRipZDslPJgJut+NjL7D25zPZ/4w=
+github.com/go-openapi/swag/stringutils v0.25.1 h1:Xasqgjvk30eUe8VKdmyzKtjkVjeiXx1Iz0zDfMNpPbw=
+github.com/go-openapi/swag/stringutils v0.25.1/go.mod h1:JLdSAq5169HaiDUbTvArA2yQxmgn4D6h4A+4HqVvAYg=
 github.com/go-openapi/swag/typeutils v0.24.0 h1:d3szEGzGDf4L2y1gYOSSLeK6h46F+zibnEas2Jm/wIw=
 github.com/go-openapi/swag/typeutils v0.24.0/go.mod h1:q8C3Kmk/vh2VhpCLaoR2MVWOGP8y7Jc8l82qCTd1DYI=
+github.com/go-openapi/swag/typeutils v0.25.1 h1:rD/9HsEQieewNt6/k+JBwkxuAHktFtH3I3ysiFZqukA=
+github.com/go-openapi/swag/typeutils v0.25.1/go.mod h1:9McMC/oCdS4BKwk2shEB7x17P6HmMmA6dQRtAkSnNb8=
 github.com/go-openapi/swag/yamlutils v0.24.0 h1:bhw4894A7Iw6ne+639hsBNRHg9iZg/ISrOVr+sJGp4c=
 github.com/go-openapi/swag/yamlutils v0.24.0/go.mod h1:DpKv5aYuaGm/sULePoeiG8uwMpZSfReo1HR3Ik0yaG8=
+github.com/go-openapi/swag/yamlutils v0.25.1 h1:mry5ez8joJwzvMbaTGLhw8pXUnhDK91oSJLDPF1bmGk=
+github.com/go-openapi/swag/yamlutils v0.25.1/go.mod h1:cm9ywbzncy3y6uPm/97ysW8+wZ09qsks+9RS8fLWKqg=
 github.com/go-openapi/validate v0.24.0 h1:LdfDKwNbpB6Vn40xhTdNZAnfLECL81w+VX3BumrGD58=
 github.com/go-openapi/validate v0.24.0/go.mod h1:iyeX1sEufmv3nPbBdX3ieNviWnOZaJ1+zquzJEf2BAQ=
 github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
@@ -96,15 +108,11 @@ github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/o
 github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
 github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
 github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
-github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBExVwjEviJTixqxL8=
-github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM=
 github.com/go-playground/validator/v10 v10.27.0 h1:w8+XrWVMhGkxOaaowyKH35gFydVHOvC0/uWoy2Fzwn4=
 github.com/go-playground/validator/v10 v10.27.0/go.mod h1:I5QpIEbmr8On7W0TktmJAumgzX4CA1XNl4ZmDuVHKKo=
 github.com/go-sql-driver/mysql v1.7.0/go.mod h1:OXbVy3sEdcQ2Doequ6Z5BW6fXNQTmx+9S1MCJN5yJMI=
 github.com/go-sql-driver/mysql v1.8.1 h1:LedoTUt/eveggdHS9qUFC1EFSa8bU2+1pZjSRpvNJ1Y=
 github.com/go-sql-driver/mysql v1.8.1/go.mod h1:wEBSXgmK//2ZFJyE+qWnIsVGmvmEKlqwuVSjsCm7DZg=
-github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
-github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
 github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4=
 github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
 github.com/golang-jwt/jwt/v5 v5.3.0 h1:pv4AsKCKKZuqlgs5sUmn4x8UlGa0kEVt/puTpKx9vvo=
@@ -113,9 +121,8 @@ github.com/golang-sql/civil v0.0.0-20220223132316-b832511892a9 h1:au07oEsX2xN0kt
 github.com/golang-sql/civil v0.0.0-20220223132316-b832511892a9/go.mod h1:8vg3r2VgvsThLBIFL93Qb5yWzgyZWhEmBwUJWevAkK0=
 github.com/golang-sql/sqlexp v0.1.0 h1:ZCD6MBpcuOVfGVqsEmY5/4FtYiKz6tSyUv9LPEDei6A=
 github.com/golang-sql/sqlexp v0.1.0/go.mod h1:J4ad9Vo8ZCWQ2GMrC4UCQy1JpCbwU9m3EOqtpKwwwHI=
-github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
-github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
 github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
@@ -135,22 +142,22 @@ github.com/josharian/intern v1.0.0 h1:vlS4z54oSdjm0bgjRigI+G1HpF+tI+9rE5LLzOg8Hm
 github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
 github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
 github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
-github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
-github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM=
-github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
 github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y=
 github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
-github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
 github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
 github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/labstack/echo/v4 v4.13.4 h1:oTZZW+T3s9gAu5L8vmzihV7/lkXGZuITzTQkTEhcXEA=
+github.com/labstack/echo/v4 v4.13.4/go.mod h1:g63b33BZ5vZzcIUF8AtRH40DrTlXnx4UMC8rBdndmjQ=
+github.com/labstack/gommon v0.4.2 h1:F8qTUNXgG1+6WQmqoUWnz8WiEU60mXVVw0P4ht1WRA0=
+github.com/labstack/gommon v0.4.2/go.mod h1:QlUFxVM+SNXhDL/Z7YhocGIBYOiwB0mXm1+1bAPHPyU=
 github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
 github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
-github.com/mailru/easyjson v0.7.7 h1:UGYAvKxe3sBsEDzO8ZeWOSlIQfWFlxbzLZe7hwFURr0=
-github.com/mailru/easyjson v0.7.7/go.mod h1:xzfreul335JAWq5oZzymOObrkdz5UnU4kGfJJLY9Nlc=
 github.com/mailru/easyjson v0.9.1 h1:LbtsOm5WAswyWbvTEOqhypdPeZzHavpZx96/n553mR8=
 github.com/mailru/easyjson v0.9.1/go.mod h1:1+xMtQp2MRNVL/V1bOzuP3aP8VNwRW55fQUto+XFtTU=
+github.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIE=
+github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
 github.com/mattn/go-sqlite3 v1.14.22 h1:2gZY6PC6kBnID23Tichd1K+Z0oS6nE/XwU+Vz/5o4kU=
@@ -170,8 +177,6 @@ github.com/opentracing/opentracing-go v1.2.0 h1:uEJPy/1a5RIPAJ0Ov+OIO8OxWu77jEv+
 github.com/opentracing/opentracing-go v1.2.0/go.mod h1:GxEUsuufX4nBwe+T+Wl9TAgYrxe9dPLANfrWvHYVTgc=
 github.com/panjf2000/ants/v2 v2.11.3 h1:AfI0ngBoXJmYOpDh9m516vjqoUu2sLrIVgppI9TZVpg=
 github.com/panjf2000/ants/v2 v2.11.3/go.mod h1:8u92CYMUc6gyvTIw8Ru7Mt7+/ESnJahz5EVtqfrilek=
-github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM=
-github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
 github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4=
 github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
@@ -180,10 +185,6 @@ github.com/robfig/cron/v3 v3.0.1 h1:WdRxkvbJztn8LMz/QEvLN5sBU+xKpSqwwUO1Pjr4qDs=
 github.com/robfig/cron/v3 v3.0.1/go.mod h1:eQICP3HwyT7UooqI/z+Ov+PtYAWygg1TEWWzGIFLtro=
 github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
 github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
-github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk=
-github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
-github.com/shurcooL/sanitized_anchor_name v1.0.0 h1:PdmoCO6wvbs+7yrJyMORt4/BmY5IYyJwS/kOiWx8mHo=
-github.com/shurcooL/sanitized_anchor_name v1.0.0/go.mod h1:1NzhyTcUVG4SuEtjjoZeVRXNmyL/1OwPU0+IJeTBvfc=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
@@ -194,26 +195,30 @@ github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
 github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
-github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
-github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+github.com/swaggo/echo-swagger v1.4.1 h1:Yf0uPaJWp1uRtDloZALyLnvdBeoEL5Kc7DtnjzO/TUk=
+github.com/swaggo/echo-swagger v1.4.1/go.mod h1:C8bSi+9yH2FLZsnhqMZLIZddpUxZdBYuNHbtaS1Hljc=
 github.com/swaggo/files v1.0.1 h1:J1bVJ4XHZNq0I46UU90611i9/YzdrF7x92oX1ig5IdE=
 github.com/swaggo/files v1.0.1/go.mod h1:0qXmMNH6sXNf+73t65aKeB+ApmgxdnkQzVTAj2uaMUg=
+github.com/swaggo/files/v2 v2.0.0 h1:hmAt8Dkynw7Ssz46F6pn8ok6YmGZqHSVLZ+HQM7i0kw=
+github.com/swaggo/files/v2 v2.0.0/go.mod h1:24kk2Y9NYEJ5lHuCra6iVwkMjIekMCaFq/0JQj66kyM=
+github.com/swaggo/files/v2 v2.0.2 h1:Bq4tgS/yxLB/3nwOMcul5oLEUKa877Ykgz3CJMVbQKU=
+github.com/swaggo/files/v2 v2.0.2/go.mod h1:TVqetIzZsO9OhHX1Am9sRf9LdrFZqoK49N37KON/jr0=
 github.com/swaggo/gin-swagger v1.6.1 h1:Ri06G4gc9N4t4k8hekMigJ9zKTFSlqj/9paAQCQs7cY=
 github.com/swaggo/gin-swagger v1.6.1/go.mod h1:LQ+hJStHakCWRiK/YNYtJOu4mR2FP+pxLnILT/qNiTw=
 github.com/swaggo/swag v1.16.6 h1:qBNcx53ZaX+M5dxVyTrgQ0PJ/ACK+NzhwcbieTt+9yI=
 github.com/swaggo/swag v1.16.6/go.mod h1:ngP2etMK5a0P3QBizic5MEwpRmluJZPHjXcMoj4Xesg=
+github.com/tarm/serial v0.0.0-20180830185346-98f6abe2eb07 h1:UyzmZLoiDWMRywV4DUYb9Fbt8uiOSooupjTq10vpvnU=
+github.com/tarm/serial v0.0.0-20180830185346-98f6abe2eb07/go.mod h1:kDXzergiv9cbyO7IOYJZWg1U88JhDg3PB6klq9Hg2pA=
 github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
 github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
-github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE=
-github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
 github.com/ugorji/go/codec v1.3.0 h1:Qd2W2sQawAfG8XSvzwhBeoGq71zXOC/Q1E9y/wUcsUA=
 github.com/ugorji/go/codec v1.3.0/go.mod h1:pRBVtBSKl77K30Bv8R2P+cLSGaTtex6fsA2Wjqmfxj4=
-github.com/urfave/cli/v2 v2.27.7 h1:bH59vdhbjLv3LAvIu6gd0usJHgoTTPhCFib8qqOwXYU=
-github.com/urfave/cli/v2 v2.27.7/go.mod h1:CyNAG/xg+iAOg0N4MPGZqVmv2rCoP267496AOXUZjA4=
-github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 h1:FnBeRrxr7OU4VvAzt5X7s6266i6cSVkkFPS0TuXWbIg=
-github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342/go.mod h1:Ohn+xnUBiLI6FVj/9LpzZWtj1/D6lUovWYBkxHVV3aM=
+github.com/valyala/bytebufferpool v1.0.0 h1:GqA5TC/0021Y/b9FG4Oi9Mr3q7XYx6KllzawFIhcdPw=
+github.com/valyala/bytebufferpool v1.0.0/go.mod h1:6bBcMArwyJ5K/AmCkWv1jt77kVWyCJ6HpOuEn7z0Csc=
+github.com/valyala/fasttemplate v1.2.2 h1:lxLXG0uE3Qnshl9QyaK6XJxMXlQZELvChBOCmQD0Loo=
+github.com/valyala/fasttemplate v1.2.2/go.mod h1:KHLXt3tVN2HBp8eijSv/kGJopbvo7S+qRAEEKiv+SiQ=
 github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=
 go.mongodb.org/mongo-driver v1.14.0 h1:P98w8egYRjYe3XDjxhYJagTokP/H6HzlsnojRgZRd80=
 go.mongodb.org/mongo-driver v1.14.0/go.mod h1:Vzb0Mk/pa7e6cWw85R4F/endUC3u0U9jGcNU603k65c=
@@ -231,36 +236,31 @@ go.uber.org/multierr v1.10.0 h1:S0h4aNzvfcFsC3dRF1jLoaov7oRaKqRGC/pUEJ2yvPQ=
 go.uber.org/multierr v1.10.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
 go.uber.org/zap v1.27.0 h1:aJMhYGrd5QSmlpLMr2MftRKl7t8J8PTZPA732ud/XR8=
 go.uber.org/zap v1.27.0/go.mod h1:GB2qFLM7cTU87MWRP2mPIjqfIDnGu+VIO4V/SdhGo2E=
-go.yaml.in/yaml/v2 v2.4.3 h1:6gvOSjQoTB3vt1l+CU+tSyi/HOjfOjRLJ4YwYZGwRO0=
-go.yaml.in/yaml/v2 v2.4.3/go.mod h1:zSxWcmIDjOzPXpjlTTbAsKokqkDNAVtZO0WOMiT90s8=
-golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
-golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc=
-golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
+go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
 golang.org/x/arch v0.21.0 h1:iTC9o7+wP6cPWpDWkivCvQFGAHDQ59SrSxsLPcnkArw=
 golang.org/x/arch v0.21.0/go.mod h1:dNHoOeKiyja7GTvF9NJS1l3Z2yntpQNzgrjh1cU103A=
 golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
-golang.org/x/crypto v0.36.0 h1:AnAEvhDddvBdpY+uR+MyHmuZzzNqXSe/GvuDeob5L34=
-golang.org/x/crypto v0.36.0/go.mod h1:Y4J0ReaxCR1IMaabaSMugxJES1EpwhBHhv2bDHklZvc=
 golang.org/x/crypto v0.42.0 h1:chiH31gIWm57EkTXpwnqf8qeuMUi0yekh6mT2AvFlqI=
 golang.org/x/crypto v0.42.0/go.mod h1:4+rDnOTJhQCx2q7/j6rAN5XDw8kPjeaXEUR2eL94ix8=
+golang.org/x/crypto v0.43.0 h1:dduJYIi3A3KOfdGOHX8AVZ/jGiyPa3IbBozJ5kNuE04=
+golang.org/x/crypto v0.43.0/go.mod h1:BFbav4mRNlXJL4wNeejLpWxB7wMbc79PdRGhWKncxR0=
 golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=
-golang.org/x/mod v0.21.0 h1:vvrHzRwRfVKSiLrG+d4FMl/Qi4ukBCE6kZlTUkDYRT0=
-golang.org/x/mod v0.21.0/go.mod h1:6SkKJ3Xj0I0BrPOZoBy3bdMptDDU9oJrpohJ3eWZ1fY=
 golang.org/x/mod v0.28.0 h1:gQBtGhjxykdjY9YhZpSlZIsbnaE2+PgjfLWUQTnoZ1U=
 golang.org/x/mod v0.28.0/go.mod h1:yfB/L0NOf/kmEbXjzCPOx1iK1fRutOydrCMsqRhEBxI=
+golang.org/x/mod v0.29.0 h1:HV8lRxZC4l2cr3Zq1LvtOsi/ThTgWnUk/y64QSs8GwA=
+golang.org/x/mod v0.29.0/go.mod h1:NyhrlYXJ2H4eJiRy/WDBO6HMqZQ6q9nk4JzS3NuCK+w=
 golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
 golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c=
 golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
-golang.org/x/net v0.38.0 h1:vRMAPTMaeGqVhG5QyLJHqNDwecKTomGeqbnfZyKlBI8=
-golang.org/x/net v0.38.0/go.mod h1:ivrbrMbzFq5J41QOQh0siUuly180yBYtLp+CKbEaFx8=
 golang.org/x/net v0.44.0 h1:evd8IRDyfNBMBTTY5XRF1vaZlD+EmWx6x8PkhR04H/I=
 golang.org/x/net v0.44.0/go.mod h1:ECOoLqd5U3Lhyeyo/QDCEVQ4sNgYsqvCZ722XogGieY=
+golang.org/x/net v0.46.0 h1:giFlY12I07fugqwPuWJi68oOnpfqFnJIJzaIIm2JVV4=
+golang.org/x/net v0.46.0/go.mod h1:Q9BGdFy1y4nkUwiLvT5qtyhAnEHgnQ/zd8PfU6nc210=
 golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.12.0 h1:MHc5BpPuC30uJk597Ri8TV3CNZcTLu6B6z4lJy+g6Jw=
-golang.org/x/sync v0.12.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
 golang.org/x/sync v0.17.0 h1:l60nONMj9l5drqw6jlhIELNv9I0A4OFgRsG9k2oT9Ug=
 golang.org/x/sync v0.17.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
 golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
@@ -270,10 +270,10 @@ golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBc
 golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.31.0 h1:ioabZlmFYtWhL+TRYpcnNlLwhyxaM9kWTDEmfnprqik=
-golang.org/x/sys v0.31.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
 golang.org/x/sys v0.36.0 h1:KVRy2GtZBrk1cBYA7MKu5bEZFxQk4NIDV6RLVcC8o0k=
 golang.org/x/sys v0.36.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/sys v0.37.0 h1:fdNQudmxPjkdUTPnLn5mdQv7Zwvbvpaxqs831goi9kQ=
+golang.org/x/sys v0.37.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
 golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=
@@ -281,20 +281,20 @@ golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
 golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
-golang.org/x/text v0.23.0 h1:D71I7dUrlY+VX0gQShAThNGHFxZ13dGLBHQLVl1mJlY=
-golang.org/x/text v0.23.0/go.mod h1:/BLNzu4aZCJ1+kcD0DNRotWKage4q2rGVAg4o22unh4=
 golang.org/x/text v0.29.0 h1:1neNs90w9YzJ9BocxfsQNHKuAT4pkghyXc4nhZ6sJvk=
 golang.org/x/text v0.29.0/go.mod h1:7MhJOA9CD2qZyOKYazxdYMF85OwPdEr9jTtBpO7ydH4=
+golang.org/x/text v0.30.0 h1:yznKA/E9zq54KzlzBEAWn1NXSQ8DIp/NYMy88xJjl4k=
+golang.org/x/text v0.30.0/go.mod h1:yDdHFIX9t+tORqspjENWgzaCVXgk0yYnYuSZ8UzzBVM=
+golang.org/x/time v0.11.0 h1:/bpjEDfN9tkoN/ryeYHnv5hcMlc8ncjMcM4XBk5NWV0=
+golang.org/x/time v0.11.0/go.mod h1:CDIdPxbZBQxdj6cxyCIdrNogrJKMJ7pr37NYpMcMDSg=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
 golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc=
-golang.org/x/tools v0.26.0 h1:v/60pFQmzmT9ExmjDv2gGIfi3OqfKoEP6I5+umXlbnQ=
-golang.org/x/tools v0.26.0/go.mod h1:TPVVj70c7JJ3WCazhD8OdXcZg/og+b9+tH/KxylGwH0=
 golang.org/x/tools v0.37.0 h1:DVSRzp7FwePZW356yEAChSdNcQo6Nsp+fex1SUW09lE=
 golang.org/x/tools v0.37.0/go.mod h1:MBN5QPQtLMHVdvsbtarmTNukZDdgwdwlO5qGacAzF0w=
+golang.org/x/tools v0.38.0 h1:Hx2Xv8hISq8Lm16jvBZ2VQf+RLmbd7wVUsALibYI/IQ=
+golang.org/x/tools v0.38.0/go.mod h1:yEsQ/d/YK8cjh0L6rZlY8tgtlKiBNTL14pGDJPJpYQs=
 golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-google.golang.org/protobuf v1.34.1 h1:9ddQBjfCyZPOHPUiPxpYESBLc+T8P3E+Vo4IbKZgFWg=
-google.golang.org/protobuf v1.34.1/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
 google.golang.org/protobuf v1.36.9 h1:w2gp2mA27hUeUzj9Ex9FBjsBm40zfaDtEWow293U7Iw=
 google.golang.org/protobuf v1.36.9/go.mod h1:fuxRtAxBytpl4zzqUh6/eyUujkJdNiuEkXntxiD/uRU=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
@@ -320,7 +320,3 @@ gorm.io/driver/sqlserver v1.6.0/go.mod h1:WQzt4IJo/WHKnckU9jXBLMJIVNMVeTu25dnOze
 gorm.io/gorm v1.25.7/go.mod h1:hbnx/Oo0ChWMn1BIhpy1oYozzpM15i4YPuHDmfYtwg8=
 gorm.io/gorm v1.30.5 h1:dvEfYwxL+i+xgCNSGGBT1lDjCzfELK8fHZxL3Ee9X0s=
 gorm.io/gorm v1.30.5/go.mod h1:8Z33v652h4//uMA76KjeDH8mJXPm1QNCYrMeatR0DOE=
-nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
-rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=
-sigs.k8s.io/yaml v1.6.0 h1:G8fkbMSAFqgEFgh4b1wmtzDnioxFCUgTZhlbj5P9QYs=
-sigs.k8s.io/yaml v1.6.0/go.mod h1:796bPqUfzR/0jLAl6XjHl3Ck7MiyVv8dbTdyT3/pMf4=

internal/app/api/api.go

@@ -8,82 +8,82 @@ package api
 // @contact.email divano@example.com
 // @license.name Apache 2.0
 // @license.url http://www.apache.org/licenses/LICENSE-2.0.html
+// @securityDefinitions.apikey BearerAuth
+// @in header
+// @name Authorization
+
 import (
 	"context"
 	"fmt"
 	"net/http"
-	"net/http/pprof"
 	"time"
 
 	_ "git.huangwc.com/pig/pig-farm-controller/docs" // 引入 swag 生成的 docs
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller/device"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller/management"
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller/monitor"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller/plan"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller/user"
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/middleware"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/webhook"
 	"git.huangwc.com/pig/pig-farm-controller/internal/domain/audit"
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/task"
+	domain_plan "git.huangwc.com/pig/pig-farm-controller/internal/domain/plan"
 	"git.huangwc.com/pig/pig-farm-controller/internal/domain/token"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/config"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
 
-	"github.com/gin-gonic/gin"
-	swaggerFiles "github.com/swaggo/files"
-	ginSwagger "github.com/swaggo/gin-swagger"
+	"github.com/labstack/echo/v4"
+	"github.com/labstack/echo/v4/middleware"
 )
 
 // API 结构体定义了 HTTP 服务器及其依赖
 type API struct {
-	engine              *gin.Engine                    // Gin 引擎实例，用于处理 HTTP 请求
-	logger              *logs.Logger                   // 日志记录器，用于输出日志信息
-	userRepo            repository.UserRepository      // 用户数据仓库接口，用于用户数据操作
-	tokenService        token.TokenService             // Token 服务接口，用于 JWT token 的生成和解析
-	auditService        audit.Service                  // 审计服务，用于记录用户操作
-	httpServer          *http.Server                   // 标准库的 HTTP 服务器实例，用于启动和停止服务
-	config              config.ServerConfig            // API 服务器的配置，使用 infra/config 包中的 ServerConfig
-	userController      *user.Controller               // 用户控制器实例
-	deviceController    *device.Controller             // 设备控制器实例
-	planController      *plan.Controller               // 计划控制器实例
-	pigFarmController   *management.PigFarmController  // 猪场管理控制器实例
-	pigBatchController  *management.PigBatchController // 猪批次控制器实例
-	listenHandler       webhook.ListenHandler          // 设备上行事件监听器
-	analysisTaskManager *task.AnalysisPlanTaskManager  // 计划触发器管理器实例
+	echo                *echo.Echo                           // Echo 引擎实例，用于处理 HTTP 请求
+	logger              *logs.Logger                         // 日志记录器，用于输出日志信息
+	userRepo            repository.UserRepository            // 用户数据仓库接口，用于用户数据操作
+	tokenService        token.Service                        // Token 服务接口，用于 JWT token 的生成和解析
+	auditService        audit.Service                        // 审计服务，用于记录用户操作
+	httpServer          *http.Server                         // 标准库的 HTTP 服务器实例，用于启动和停止服务
+	config              config.ServerConfig                  // API 服务器的配置，使用 infra/config 包中的 ServerConfig
+	userController      *user.Controller                     // 用户控制器实例
+	deviceController    *device.Controller                   // 设备控制器实例
+	planController      *plan.Controller                     // 计划控制器实例
+	pigFarmController   *management.PigFarmController        // 猪场管理控制器实例
+	pigBatchController  *management.PigBatchController       // 猪群控制器实例
+	monitorController   *monitor.Controller                  // 数据监控控制器实例
+	listenHandler       webhook.ListenHandler                // 设备上行事件监听器
+	analysisTaskManager *domain_plan.AnalysisPlanTaskManager // 计划触发器管理器实例
 }
 
 // NewAPI 创建并返回一个新的 API 实例
-// 负责初始化 Gin 引擎、设置全局中间件，并注入所有必要的依赖。
+// 负责初始化 Echo 引擎、设置全局中间件，并注入所有必要的依赖。
 func NewAPI(cfg config.ServerConfig,
 	logger *logs.Logger,
 	userRepo repository.UserRepository,
-	deviceRepository repository.DeviceRepository,
-	areaControllerRepository repository.AreaControllerRepository,
-	deviceTemplateRepository repository.DeviceTemplateRepository, // 添加设备模板仓库
-	planRepository repository.PlanRepository,
 	pigFarmService service.PigFarmService,
-	pigBatchService service.PigBatchService, // 添加猪批次服务
-	userActionLogRepository repository.UserActionLogRepository,
-	tokenService token.TokenService,
-	auditService audit.Service, // 注入审计服务
+	pigBatchService service.PigBatchService,
+	monitorService service.MonitorService,
+	deviceService service.DeviceService,
+	planService service.PlanService,
+	userService service.UserService,
+	tokenService token.Service,
+	auditService audit.Service,
 	listenHandler webhook.ListenHandler,
-	analysisTaskManager *task.AnalysisPlanTaskManager) *API {
-	// 设置 Gin 模式，例如 gin.ReleaseMode (生产模式) 或 gin.DebugMode (开发模式)
-	// 从配置中获取 Gin 模式
-	gin.SetMode(cfg.Mode)
+) *API {
+	// 使用 echo.New() 创建一个 Echo 引擎实例
+	e := echo.New()
 
-	// 使用 gin.New() 创建一个 Gin 引擎实例，而不是 gin.Default()
-	// 这样可以手动添加所需的中间件，避免 gin.Default() 默认包含的 Logger 和 Recovery 中间件
-	engine := gin.New()
+	// 根据配置设置 Echo 的调试模式
+	e.Debug = cfg.Mode == "debug"
 
-	// 添加 Gin Recovery 中间件，用于捕获 panic 并恢复，防止服务崩溃
-	// gin.Logger() 已移除，因为我们使用自定义的 logger
-	engine.Use(gin.Recovery())
+	// 添加 Echo Recovery 中间件，用于捕获 panic 并恢复，防止服务崩溃
+	// Echo 的 Logger 中间件默认会记录请求信息，如果需要自定义，可以替换
+	e.Use(middleware.Recover())
 
 	// 初始化 API 结构体
 	api := &API{
-		engine:        engine,
+		echo:          e,
 		logger:        logger,
 		userRepo:      userRepo,
 		tokenService:  tokenService,
@@ -91,156 +91,23 @@ func NewAPI(cfg config.ServerConfig,
 		config:        cfg,
 		listenHandler: listenHandler,
 		// 在 NewAPI 中初始化用户控制器，并将其作为 API 结构体的成员
-		userController: user.NewController(userRepo, userActionLogRepository, logger, tokenService),
+		userController: user.NewController(userService, logger),
 		// 在 NewAPI 中初始化设备控制器，并将其作为 API 结构体的成员
-		deviceController: device.NewController(deviceRepository, areaControllerRepository, deviceTemplateRepository, logger),
+		deviceController: device.NewController(deviceService, logger),
 		// 在 NewAPI 中初始化计划控制器，并将其作为 API 结构体的成员
-		planController: plan.NewController(logger, planRepository, analysisTaskManager),
+		planController: plan.NewController(logger, planService),
 		// 在 NewAPI 中初始化猪场管理控制器
 		pigFarmController: management.NewPigFarmController(logger, pigFarmService),
-		// 在 NewAPI 中初始化猪批次控制器
+		// 在 NewAPI 中初始化猪群控制器
 		pigBatchController: management.NewPigBatchController(logger, pigBatchService),
+		// 在 NewAPI 中初始化数据监控控制器
+		monitorController: monitor.NewController(monitorService, logger),
 	}
 
 	api.setupRoutes() // 设置所有路由
 	return api
 }
 
-// setupRoutes 设置所有 API 路由
-// 在此方法中，使用已初始化的控制器实例将其路由注册到 Gin 引擎中。
-func (a *API) setupRoutes() {
-
-	// --- Public Routes ---
-	// 这些路由不需要身份验证
-
-	// 用户注册和登录
-	a.engine.POST("/api/v1/users", a.userController.CreateUser)
-	a.engine.POST("/api/v1/users/login", a.userController.Login)
-	a.logger.Info("公开接口注册成功：用户注册、登录")
-
-	// 注册 pprof 路由
-	pprofGroup := a.engine.Group("/debug/pprof")
-	{
-		pprofGroup.GET("/", gin.WrapF(pprof.Index))
-		pprofGroup.GET("/cmdline", gin.WrapF(pprof.Cmdline))
-		pprofGroup.GET("/profile", gin.WrapF(pprof.Profile))
-		pprofGroup.POST("/symbol", gin.WrapF(pprof.Symbol))
-		pprofGroup.GET("/symbol", gin.WrapF(pprof.Symbol))
-		pprofGroup.GET("/trace", gin.WrapF(pprof.Trace))
-		pprofGroup.GET("/allocs", gin.WrapH(pprof.Handler("allocs")))
-		pprofGroup.GET("/block", gin.WrapH(pprof.Handler("block")))
-		pprofGroup.GET("/goroutine", gin.WrapH(pprof.Handler("goroutine")))
-		pprofGroup.GET("/heap", gin.WrapH(pprof.Handler("heap")))
-		pprofGroup.GET("/mutex", gin.WrapH(pprof.Handler("mutex")))
-		pprofGroup.GET("/threadcreate", gin.WrapH(pprof.Handler("threadcreate")))
-	}
-	a.logger.Info("pprof 接口注册成功")
-
-	// 上行事件监听路由
-	a.engine.POST("/upstream", gin.WrapH(a.listenHandler.Handler()))
-	a.logger.Info("上行事件监听接口注册成功")
-
-	// 添加 Swagger UI 路由, Swagger UI可在 /swagger/index.html 上找到
-	a.engine.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
-	a.logger.Info("Swagger UI 接口注册成功")
-
-	// --- Authenticated Routes ---
-	// 所有在此注册的路由都需要通过 JWT 身份验证
-	authGroup := a.engine.Group("/api/v1")
-	authGroup.Use(middleware.AuthMiddleware(a.tokenService, a.userRepo)) // 1. 身份认证
-	authGroup.Use(middleware.AuditLogMiddleware(a.auditService))         // 2. 审计日志
-	{
-		// 用户相关路由组
-		userGroup := authGroup.Group("/users")
-		{
-			userGroup.GET("/:id/history", a.userController.ListUserHistory)
-		}
-		a.logger.Info("用户相关接口注册成功 (需要认证和审计)")
-
-		// 设备相关路由组
-		deviceGroup := authGroup.Group("/devices")
-		{
-			deviceGroup.POST("", a.deviceController.CreateDevice)
-			deviceGroup.GET("", a.deviceController.ListDevices)
-			deviceGroup.GET("/:id", a.deviceController.GetDevice)
-			deviceGroup.PUT("/:id", a.deviceController.UpdateDevice)
-			deviceGroup.DELETE("/:id", a.deviceController.DeleteDevice)
-		}
-		a.logger.Info("设备相关接口注册成功 (需要认证和审计)")
-
-		// 区域主控相关路由组
-		areaControllerGroup := authGroup.Group("/area-controllers")
-		{
-			areaControllerGroup.POST("", a.deviceController.CreateAreaController)
-			areaControllerGroup.GET("", a.deviceController.ListAreaControllers)
-			areaControllerGroup.GET("/:id", a.deviceController.GetAreaController)
-			areaControllerGroup.PUT("/:id", a.deviceController.UpdateAreaController)
-			areaControllerGroup.DELETE("/:id", a.deviceController.DeleteAreaController)
-		}
-		a.logger.Info("区域主控相关接口注册成功 (需要认证和审计)")
-
-		// 设备模板相关路由组
-		deviceTemplateGroup := authGroup.Group("/device-templates")
-		{
-			deviceTemplateGroup.POST("", a.deviceController.CreateDeviceTemplate)
-			deviceTemplateGroup.GET("", a.deviceController.ListDeviceTemplates)
-			deviceTemplateGroup.GET("/:id", a.deviceController.GetDeviceTemplate)
-			deviceTemplateGroup.PUT("/:id", a.deviceController.UpdateDeviceTemplate)
-			deviceTemplateGroup.DELETE("/:id", a.deviceController.DeleteDeviceTemplate)
-		}
-		a.logger.Info("设备模板相关接口注册成功 (需要认证和审计)")
-
-		// 计划相关路由组
-		planGroup := authGroup.Group("/plans")
-		{
-			planGroup.POST("", a.planController.CreatePlan)
-			planGroup.GET("", a.planController.ListPlans)
-			planGroup.GET("/:id", a.planController.GetPlan)
-			planGroup.PUT("/:id", a.planController.UpdatePlan)
-			planGroup.DELETE("/:id", a.planController.DeletePlan)
-			planGroup.POST("/:id/start", a.planController.StartPlan)
-			planGroup.POST("/:id/stop", a.planController.StopPlan)
-		}
-		a.logger.Info("计划相关接口注册成功 (需要认证和审计)")
-
-		// 猪舍相关路由组
-		pigHouseGroup := authGroup.Group("/pig-houses")
-		{
-			pigHouseGroup.POST("", a.pigFarmController.CreatePigHouse)
-			pigHouseGroup.GET("", a.pigFarmController.ListPigHouses)
-			pigHouseGroup.GET("/:id", a.pigFarmController.GetPigHouse)
-			pigHouseGroup.PUT("/:id", a.pigFarmController.UpdatePigHouse)
-			pigHouseGroup.DELETE("/:id", a.pigFarmController.DeletePigHouse)
-		}
-		a.logger.Info("猪舍相关接口注册成功 (需要认证和审计)")
-
-		// 猪圈相关路由组
-		penGroup := authGroup.Group("/pens")
-		{
-			penGroup.POST("", a.pigFarmController.CreatePen)
-			penGroup.GET("", a.pigFarmController.ListPens)
-			penGroup.GET("/:id", a.pigFarmController.GetPen)
-			penGroup.PUT("/:id", a.pigFarmController.UpdatePen)
-			penGroup.DELETE("/:id", a.pigFarmController.DeletePen)
-			penGroup.PUT("/:id/status", a.pigFarmController.UpdatePenStatus)
-		}
-		a.logger.Info("猪圈相关接口注册成功 (需要认证和审计)")
-
-		// 猪批次相关路由组
-		pigBatchGroup := authGroup.Group("/pig-batches")
-		{
-			pigBatchGroup.POST("", a.pigBatchController.CreatePigBatch)
-			pigBatchGroup.GET("", a.pigBatchController.ListPigBatches)
-			pigBatchGroup.GET("/:id", a.pigBatchController.GetPigBatch)
-			pigBatchGroup.PUT("/:id", a.pigBatchController.UpdatePigBatch)
-			pigBatchGroup.DELETE("/:id", a.pigBatchController.DeletePigBatch)
-			pigBatchGroup.PUT("/:id/pens", a.pigBatchController.UpdatePigBatchPens)
-		}
-		a.logger.Info("猪批次相关接口注册成功 (需要认证和审计)")
-
-	}
-}
-
 // Start 启动 HTTP 服务器
 // 接收一个地址字符串 (例如 ":8080")，并在一个新的 goroutine 中启动服务器，
 // 以便主线程可以继续执行其他任务（例如监听操作系统信号）。
@@ -250,8 +117,8 @@ func (a *API) Start() {
 
 	// 初始化标准库的 http.Server 实例
 	a.httpServer = &http.Server{
-		Addr:    addr,     // 服务器监听的地址从配置中获取
-		Handler: a.engine, // 将 Gin 引擎作为 HTTP 请求的处理程序
+		Addr:    addr,   // 服务器监听的地址从配置中获取
+		Handler: a.echo, // 将 Echo 引擎作为 HTTP 请求的处理程序
 	}
 
 	// 在独立的 goroutine 中启动服务器

internal/app/api/router.go

@@ -0,0 +1,185 @@
+package api
+
+import (
+	"net/http"
+	"net/http/pprof"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/middleware"
+	"github.com/labstack/echo/v4"
+	echoSwagger "github.com/swaggo/echo-swagger"
+)
+
+// setupRoutes 设置所有 API 路由
+// 在此方法中，使用已初始化的控制器实例将其路由注册到 Echo 引擎中。
+func (a *API) setupRoutes() {
+	a.logger.Info("开始初始化所有 API 路由")
+
+	// --- Public Routes ---
+	// 这些路由不需要身份验证
+
+	// 用户注册和登录
+	a.echo.POST("/api/v1/users", a.userController.CreateUser)  // 注册新用户
+	a.echo.POST("/api/v1/users/login", a.userController.Login) // 用户登录
+	a.logger.Debug("公开接口注册成功：用户注册、登录")
+
+	// 注册 pprof 路由
+	pprofGroup := a.echo.Group("/debug/pprof")
+	{
+		pprofGroup.GET("/", echo.WrapHandler(http.HandlerFunc(pprof.Index)))          // pprof 索引页
+		pprofGroup.GET("/cmdline", echo.WrapHandler(http.HandlerFunc(pprof.Cmdline))) // pprof 命令行参数
+		pprofGroup.GET("/profile", echo.WrapHandler(http.HandlerFunc(pprof.Profile))) // pprof CPU profile
+		pprofGroup.POST("/symbol", echo.WrapHandler(http.HandlerFunc(pprof.Symbol)))  // pprof 符号查找 (POST)
+		pprofGroup.GET("/symbol", echo.WrapHandler(http.HandlerFunc(pprof.Symbol)))   // pprof 符号查找 (GET)
+		pprofGroup.GET("/trace", echo.WrapHandler(http.HandlerFunc(pprof.Trace)))     // pprof 跟踪
+		pprofGroup.GET("/allocs", echo.WrapHandler(pprof.Handler("allocs")))          // pprof 内存分配
+		pprofGroup.GET("/block", echo.WrapHandler(pprof.Handler("block")))            // pprof 阻塞
+		pprofGroup.GET("/goroutine", echo.WrapHandler(pprof.Handler("goroutine")))
+		pprofGroup.GET("/heap", echo.WrapHandler(pprof.Handler("heap")))   // pprof 堆内存
+		pprofGroup.GET("/mutex", echo.WrapHandler(pprof.Handler("mutex"))) // pprof 互斥锁
+		pprofGroup.GET("/threadcreate", echo.WrapHandler(pprof.Handler("threadcreate")))
+	}
+	a.logger.Debug("pprof 接口注册成功")
+
+	// 上行事件监听路由
+	a.echo.POST("/upstream", echo.WrapHandler(a.listenHandler.Handler())) // 处理设备上行事件
+	a.logger.Debug("上行事件监听接口注册成功")
+
+	// 添加 Swagger UI 路由, Swagger UI可在 /swagger/index.html 上找到
+	a.echo.GET("/swagger/*any", echoSwagger.WrapHandler) // Swagger UI 接口
+	a.logger.Debug("Swagger UI 接口注册成功")
+
+	// --- Authenticated Routes ---
+	// 所有在此注册的路由都需要通过 JWT 身份验证
+	authGroup := a.echo.Group("/api/v1")
+	authGroup.Use(middleware.AuthMiddleware(a.tokenService, a.userRepo)) // 1. 身份认证中间件
+	authGroup.Use(middleware.AuditLogMiddleware(a.auditService))         // 2. 审计日志中间件
+	{
+		// 用户相关路由组
+		userGroup := authGroup.Group("/users")
+		{
+			userGroup.POST("/:id/notifications/test", a.userController.SendTestNotification)
+		}
+		a.logger.Debug("用户相关接口注册成功 (需要认证和审计)")
+
+		// 设备相关路由组
+		deviceGroup := authGroup.Group("/devices")
+		{
+			deviceGroup.POST("", a.deviceController.CreateDevice)                     // 创建设备
+			deviceGroup.GET("", a.deviceController.ListDevices)                       // 获取设备列表
+			deviceGroup.GET("/:id", a.deviceController.GetDevice)                     // 获取单个设备
+			deviceGroup.PUT("/:id", a.deviceController.UpdateDevice)                  // 更新设备
+			deviceGroup.DELETE("/:id", a.deviceController.DeleteDevice)               // 删除设备
+			deviceGroup.POST("/manual-control/:id", a.deviceController.ManualControl) // 手动控制设备
+		}
+		a.logger.Debug("设备相关接口注册成功 (需要认证和审计)")
+
+		// 区域主控相关路由组
+		areaControllerGroup := authGroup.Group("/area-controllers")
+		{
+			areaControllerGroup.POST("", a.deviceController.CreateAreaController)       // 创建区域主控
+			areaControllerGroup.GET("", a.deviceController.ListAreaControllers)         // 获取区域主控列表
+			areaControllerGroup.GET("/:id", a.deviceController.GetAreaController)       // 获取单个区域主控
+			areaControllerGroup.PUT("/:id", a.deviceController.UpdateAreaController)    // 更新区域主控
+			areaControllerGroup.DELETE("/:id", a.deviceController.DeleteAreaController) // 删除区域主控
+		}
+		a.logger.Debug("区域主控相关接口注册成功 (需要认证和审计)")
+
+		// 设备模板相关路由组
+		deviceTemplateGroup := authGroup.Group("/device-templates")
+		{
+			deviceTemplateGroup.POST("", a.deviceController.CreateDeviceTemplate)       // 创建设备模板
+			deviceTemplateGroup.GET("", a.deviceController.ListDeviceTemplates)         // 获取设备模板列表
+			deviceTemplateGroup.GET("/:id", a.deviceController.GetDeviceTemplate)       // 获取单个设备模板
+			deviceTemplateGroup.PUT("/:id", a.deviceController.UpdateDeviceTemplate)    // 更新设备模板
+			deviceTemplateGroup.DELETE("/:id", a.deviceController.DeleteDeviceTemplate) // 删除设备模板
+		}
+		a.logger.Debug("设备模板相关接口注册成功 (需要认证和审计)")
+
+		// 计划相关路由组
+		planGroup := authGroup.Group("/plans")
+		{
+			planGroup.POST("", a.planController.CreatePlan)          // 创建计划
+			planGroup.GET("", a.planController.ListPlans)            // 获取计划列表
+			planGroup.GET("/:id", a.planController.GetPlan)          // 获取单个计划
+			planGroup.PUT("/:id", a.planController.UpdatePlan)       // 更新计划
+			planGroup.DELETE("/:id", a.planController.DeletePlan)    // 删除计划
+			planGroup.POST("/:id/start", a.planController.StartPlan) // 启动计划
+			planGroup.POST("/:id/stop", a.planController.StopPlan)   // 停止计划
+		}
+		a.logger.Debug("计划相关接口注册成功 (需要认证和审计)")
+
+		// 猪舍相关路由组
+		pigHouseGroup := authGroup.Group("/pig-houses")
+		{
+			pigHouseGroup.POST("", a.pigFarmController.CreatePigHouse)       // 创建猪舍
+			pigHouseGroup.GET("", a.pigFarmController.ListPigHouses)         // 获取猪舍列表
+			pigHouseGroup.GET("/:id", a.pigFarmController.GetPigHouse)       // 获取单个猪舍
+			pigHouseGroup.PUT("/:id", a.pigFarmController.UpdatePigHouse)    // 更新猪舍
+			pigHouseGroup.DELETE("/:id", a.pigFarmController.DeletePigHouse) // 删除猪舍
+		}
+		a.logger.Debug("猪舍相关接口注册成功 (需要认证和审计)")
+
+		// 猪圈相关路由组
+		penGroup := authGroup.Group("/pens")
+		{
+			penGroup.POST("", a.pigFarmController.CreatePen)                 // 创建猪圈
+			penGroup.GET("", a.pigFarmController.ListPens)                   // 获取猪圈列表
+			penGroup.GET("/:id", a.pigFarmController.GetPen)                 // 获取单个猪圈
+			penGroup.PUT("/:id", a.pigFarmController.UpdatePen)              // 更新猪圈
+			penGroup.DELETE("/:id", a.pigFarmController.DeletePen)           // 删除猪圈
+			penGroup.PUT("/:id/status", a.pigFarmController.UpdatePenStatus) // 更新猪圈状态
+		}
+		a.logger.Debug("猪圈相关接口注册成功 (需要认证和审计)")
+
+		// 猪群相关路由组
+		pigBatchGroup := authGroup.Group("/pig-batches")
+		{
+			pigBatchGroup.POST("", a.pigBatchController.CreatePigBatch)                                                   // 创建猪群
+			pigBatchGroup.GET("", a.pigBatchController.ListPigBatches)                                                    // 获取猪群列表
+			pigBatchGroup.GET("/:id", a.pigBatchController.GetPigBatch)                                                   // 获取单个猪群
+			pigBatchGroup.PUT("/:id", a.pigBatchController.UpdatePigBatch)                                                // 更新猪群
+			pigBatchGroup.DELETE("/:id", a.pigBatchController.DeletePigBatch)                                             // 删除猪群
+			pigBatchGroup.POST("/assign-pens/:id", a.pigBatchController.AssignEmptyPensToBatch)                           // 为猪群分配空栏
+			pigBatchGroup.POST("/reclassify-pen/:fromBatchID", a.pigBatchController.ReclassifyPenToNewBatch)              // 将猪栏划拨到新群
+			pigBatchGroup.DELETE("/remove-pen/:penID/:batchID", a.pigBatchController.RemoveEmptyPenFromBatch)             // 从猪群移除空栏
+			pigBatchGroup.POST("/move-pigs-into-pen/:id", a.pigBatchController.MovePigsIntoPen)                           // 将猪只从“虚拟库存”移入指定猪栏
+			pigBatchGroup.POST("/sell-pigs/:id", a.pigBatchController.SellPigs)                                           // 处理卖猪业务
+			pigBatchGroup.POST("/buy-pigs/:id", a.pigBatchController.BuyPigs)                                             // 处理买猪业务
+			pigBatchGroup.POST("/transfer-across-batches/:sourceBatchID", a.pigBatchController.TransferPigsAcrossBatches) // 跨猪群调栏
+			pigBatchGroup.POST("/transfer-within-batch/:id", a.pigBatchController.TransferPigsWithinBatch)                // 群内调栏
+			pigBatchGroup.POST("/record-sick-pigs/:id", a.pigBatchController.RecordSickPigs)                              // 记录新增病猪事件
+			pigBatchGroup.POST("/record-sick-pig-recovery/:id", a.pigBatchController.RecordSickPigRecovery)               // 记录病猪康复事件
+			pigBatchGroup.POST("/record-sick-pig-death/:id", a.pigBatchController.RecordSickPigDeath)                     // 记录病猪死亡事件
+			pigBatchGroup.POST("/record-sick-pig-cull/:id", a.pigBatchController.RecordSickPigCull)                       // 记录病猪淘汰事件
+			pigBatchGroup.POST("/record-death/:id", a.pigBatchController.RecordDeath)                                     // 记录正常猪只死亡事件
+			pigBatchGroup.POST("/record-cull/:id", a.pigBatchController.RecordCull)                                       // 记录正常猪只淘汰事件
+		}
+		a.logger.Debug("猪群相关接口注册成功 (需要认证和审计)")
+
+		// 数据监控相关路由组
+		monitorGroup := authGroup.Group("/monitor")
+		{
+			monitorGroup.GET("/sensor-data", a.monitorController.ListSensorData)
+			monitorGroup.GET("/device-command-logs", a.monitorController.ListDeviceCommandLogs)
+			monitorGroup.GET("/plan-execution-logs", a.monitorController.ListPlanExecutionLogs)
+			monitorGroup.GET("/task-execution-logs", a.monitorController.ListTaskExecutionLogs)
+			monitorGroup.GET("/pending-collections", a.monitorController.ListPendingCollections)
+			monitorGroup.GET("/user-action-logs", a.monitorController.ListUserActionLogs)
+			monitorGroup.GET("/raw-material-purchases", a.monitorController.ListRawMaterialPurchases)
+			monitorGroup.GET("/raw-material-stock-logs", a.monitorController.ListRawMaterialStockLogs)
+			monitorGroup.GET("/feed-usage-records", a.monitorController.ListFeedUsageRecords)
+			monitorGroup.GET("/medication-logs", a.monitorController.ListMedicationLogs)
+			monitorGroup.GET("/pig-batch-logs", a.monitorController.ListPigBatchLogs)
+			monitorGroup.GET("/weighing-batches", a.monitorController.ListWeighingBatches)
+			monitorGroup.GET("/weighing-records", a.monitorController.ListWeighingRecords)
+			monitorGroup.GET("/pig-transfer-logs", a.monitorController.ListPigTransferLogs)
+			monitorGroup.GET("/pig-sick-logs", a.monitorController.ListPigSickLogs)
+			monitorGroup.GET("/pig-purchases", a.monitorController.ListPigPurchases)
+			monitorGroup.GET("/pig-sales", a.monitorController.ListPigSales)
+			monitorGroup.GET("/notifications", a.monitorController.ListNotifications)
+		}
+		a.logger.Debug("数据监控相关接口注册成功 (需要认证和审计)")
+	}
+
+	a.logger.Debug("所有接口注册成功")
+}

internal/app/controller/auth_utils.go

@@ -4,21 +4,21 @@ import (
 	"errors"
 
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"github.com/gin-gonic/gin"
+	"github.com/labstack/echo/v4"
 )
 
 var (
-	// ErrUserNotFoundInContext 表示在 gin.Context 中未找到用户信息。
+	// ErrUserNotFoundInContext 表示在 context 中未找到用户信息。
 	ErrUserNotFoundInContext = errors.New("context中未找到用户信息")
-	// ErrInvalidUserType 表示从 gin.Context 中获取的用户信息类型不正确。
+	// ErrInvalidUserType 表示从 context 中获取的用户信息类型不正确。
 	ErrInvalidUserType = errors.New("context中用户信息类型不正确")
 )
 
-// GetOperatorIDFromContext 从 gin.Context 中提取操作者ID。
+// GetOperatorIDFromContext 从 echo.Context 中提取操作者ID。
 // 假设操作者ID是由 AuthMiddleware 存储到 context 中的 *models.User 对象的 ID 字段。
-func GetOperatorIDFromContext(c *gin.Context) (uint, error) {
-	userVal, exists := c.Get(models.ContextUserKey.String())
-	if !exists {
+func GetOperatorIDFromContext(c echo.Context) (uint, error) {
+	userVal := c.Get(models.ContextUserKey.String())
+	if userVal == nil {
 		return 0, ErrUserNotFoundInContext
 	}
 
@@ -30,11 +30,11 @@ func GetOperatorIDFromContext(c *gin.Context) (uint, error) {
 	return user.ID, nil
 }
 
-// GetOperatorFromContext 从 gin.Context 中提取操作者。
-// 假设操作者是由 AuthMiddleware 存储到 context 中的 *models.User 对象的  字段。
-func GetOperatorFromContext(c *gin.Context) (*models.User, error) {
-	userVal, exists := c.Get(models.ContextUserKey.String())
-	if !exists {
+// GetOperatorFromContext 从 echo.Context 中提取操作者。
+// 假设操作者是由 AuthMiddleware 存储到 context 中的 *models.User 对象的字段。
+func GetOperatorFromContext(c echo.Context) (*models.User, error) {
+	userVal := c.Get(models.ContextUserKey.String())
+	if userVal == nil {
 		return nil, ErrUserNotFoundInContext
 	}
 

internal/app/controller/device/device_controller_test.go

@@ -1,741 +0,0 @@
-package device_test
-
-import (
-	"bytes"
-	"encoding/json"
-	"errors"
-	"io"
-	"net/http"
-	"net/http/httptest"
-	"testing"
-	"time"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller/device"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"github.com/gin-gonic/gin"
-	"github.com/stretchr/testify/assert"
-	"github.com/stretchr/testify/mock"
-	"gorm.io/datatypes"
-	"gorm.io/gorm"
-)
-
-// MockDeviceRepository 是 DeviceRepository 接口的模拟实现
-type MockDeviceRepository struct {
-	mock.Mock
-}
-
-// CreateTx 模拟 DeviceRepository 的 CreateTx 方法
-func (m *MockDeviceRepository) Create(device *models.Device) error {
-	args := m.Called(device)
-	return args.Error(0)
-}
-
-// FindByID 模拟 DeviceRepository 的 FindByID 方法
-func (m *MockDeviceRepository) FindByID(id uint) (*models.Device, error) {
-	args := m.Called(id)
-	if args.Get(0) == nil {
-		return nil, args.Error(1)
-	}
-	return args.Get(0).(*models.Device), args.Error(1)
-}
-
-// FindByIDString 模拟 DeviceRepository 的 FindByIDString 方法
-func (m *MockDeviceRepository) FindByIDString(id string) (*models.Device, error) {
-	args := m.Called(id)
-	if args.Get(0) == nil {
-		return nil, args.Error(1)
-	}
-	return args.Get(0).(*models.Device), args.Error(1)
-}
-
-// ListAll 模拟 DeviceRepository 的 ListAll 方法
-func (m *MockDeviceRepository) ListAll() ([]*models.Device, error) {
-	args := m.Called()
-	if args.Get(0) == nil {
-		return nil, args.Error(1)
-	}
-	return args.Get(0).([]*models.Device), args.Error(1)
-}
-
-// ListByParentID 模拟 DeviceRepository 的 ListByParentID 方法
-func (m *MockDeviceRepository) ListByParentID(parentID *uint) ([]*models.Device, error) {
-	args := m.Called(parentID)
-	if args.Get(0) == nil {
-		return nil, args.Error(1)
-	}
-	return args.Get(0).([]*models.Device), args.Error(1)
-}
-
-// Update 模拟 DeviceRepository 的 Update 方法
-func (m *MockDeviceRepository) Update(device *models.Device) error {
-	args := m.Called(device)
-	return args.Error(0)
-}
-
-// Delete 模拟 DeviceRepository 的 Delete 方法
-func (m *MockDeviceRepository) Delete(id uint) error {
-	args := m.Called(id)
-	return args.Error(0)
-}
-
-// testCase 结构体定义了所有测试用例的通用参数
-type testCase struct {
-	name             string
-	httpMethod       string // 新增字段：HTTP 方法
-	requestBody      interface{}
-	paramID          string // URL 中的 ID 参数
-	mockRepoSetup    func(*MockDeviceRepository)
-	expectedStatus   int // HTTP 状态码
-	expectedCode     int // 业务状态码
-	expectedMessage  string
-	expectedDataFunc func(interface{}) bool // 用于验证 data 字段的函数
-}
-
-// runTest 是一个辅助函数，用于执行单个测试用例
-func runTest(t *testing.T, tc testCase, controllerMethod func(*gin.Context, *MockDeviceRepository)) {
-	// 初始化 Gin 上下文
-	w := httptest.NewRecorder()
-	ctx, _ := gin.CreateTestContext(w)
-
-	// 设置请求体和 HTTP 方法
-	if tc.requestBody != nil {
-		jsonBody, _ := json.Marshal(tc.requestBody)
-		ctx.Request = httptest.NewRequest(tc.httpMethod, "/", io.NopCloser(bytes.NewBuffer(jsonBody)))
-		ctx.Request.Header.Set("Content-Type", "application/json")
-	} else {
-		// 对于没有请求体的请求 (GET, DELETE, 或没有 body 的 POST/PUT)
-		ctx.Request = httptest.NewRequest(tc.httpMethod, "/", nil)
-	}
-
-	// 设置 URL 参数
-	if tc.paramID != "" {
-		ctx.Params = append(ctx.Params, gin.Param{Key: "id", Value: tc.paramID})
-	}
-
-	// 创建 Mock Repository
-	mockRepo := new(MockDeviceRepository)
-	// 设置 Mock 行为
-	tc.mockRepoSetup(mockRepo)
-
-	// 调用被测试的方法，并传入 mockRepo
-	controllerMethod(ctx, mockRepo)
-
-	// 解析响应体
-	var responseBody controller.Response
-	err := json.Unmarshal(w.Body.Bytes(), &responseBody)
-	assert.NoError(t, err)
-
-	// 断言 HTTP 状态码始终为 200 OK
-	assert.Equal(t, tc.expectedStatus, w.Code)
-
-	// 断言业务状态码和消息
-	assert.Equal(t, tc.expectedCode, responseBody.Code)
-	assert.Equal(t, tc.expectedMessage, responseBody.Message)
-
-	// 断言数据字段
-	if tc.expectedDataFunc != nil {
-		var data interface{}
-		// 只有当 responseBody.Data 不为 nil 且其底层类型为 []byte 时才尝试 Unmarshal
-		if responseBody.Data != nil {
-			if byteData, ok := responseBody.Data.([]byte); ok {
-				err = json.Unmarshal(byteData, &data)
-				assert.NoError(t, err, "无法解析响应数据") // 增加对 Unmarshal 错误的断言
-			} else {
-				// 如果 Data 不为 nil 但也不是 []byte，这通常不应该发生
-				// 但为了健壮性，直接将原始 interface{} 赋值给 data
-				data = responseBody.Data
-			}
-		}
-		assert.True(t, tc.expectedDataFunc(data), "数据字段验证失败")
-	}
-
-	// 验证 Mock 期望是否都已满足
-	mockRepo.AssertExpectations(t)
-}
-
-func TestCreateDevice(t *testing.T) {
-	gin.SetMode(gin.TestMode)
-
-	tests := []testCase{
-		{
-			name:       "成功创建区域主控",
-			httpMethod: http.MethodPost,
-			requestBody: device.CreateDeviceRequest{
-				Name:       "主控A",
-				Type:       models.DeviceTypeAreaController,
-				Location:   "猪舍1",
-				Properties: controller.Properties(`{"lora_address":"0x1234"}`),
-			},
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("CreateTx", mock.MatchedBy(func(dev *models.Device) bool {
-					// 检查 Name 字段
-					nameMatch := dev.Name == "主控A"
-					// 检查 Type 字段
-					typeMatch := dev.Type == models.DeviceTypeAreaController
-					// 检查 Location 字段
-					locationMatch := dev.Location == "猪舍1"
-					// 检查 Properties 字段的字节内容
-					expectedProperties := controller.Properties(`{"lora_address":"0x1234"}`)
-					propertiesMatch := bytes.Equal(dev.Properties, expectedProperties)
-
-					return nameMatch && typeMatch && locationMatch && propertiesMatch
-				})).Return(nil).Run(func(args mock.Arguments) {
-					// 模拟 GORM 自动填充 ID
-					arg := args.Get(0).(*models.Device)
-					arg.ID = 1
-					arg.CreatedAt = time.Now()
-					arg.UpdatedAt = time.Now()
-				}).Once()
-			},
-			expectedStatus:  http.StatusOK,
-			expectedCode:    controller.CodeCreated,
-			expectedMessage: "设备创建成功",
-			expectedDataFunc: func(data interface{}) bool {
-				dataMap, ok := data.(map[string]interface{})
-				if !ok {
-					return false
-				}
-				return dataMap["id"] != nil &&
-					dataMap["name"] == "主控A" &&
-					dataMap["type"] == string(models.DeviceTypeAreaController) &&
-					dataMap["properties"] != nil
-			},
-		},
-		{
-			name:       "成功创建普通设备",
-			httpMethod: http.MethodPost,
-			requestBody: device.CreateDeviceRequest{
-				Name:       "温度传感器",
-				Type:       models.DeviceTypeDevice,
-				SubType:    models.SubTypeSensorTemp,
-				ParentID:   func() *uint { id := uint(1); return &id }(),
-				Location:   "猪舍1-A区",
-				Properties: controller.Properties(`{"bus_id":1,"bus_address":10}`),
-			},
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("CreateTx", mock.Anything).Return(nil).Run(func(args mock.Arguments) {
-					arg := args.Get(0).(*models.Device)
-					arg.ID = 2
-					arg.CreatedAt = time.Now()
-					arg.UpdatedAt = time.Now()
-				}).Once()
-			},
-			expectedStatus:  http.StatusOK,
-			expectedCode:    controller.CodeCreated,
-			expectedMessage: "设备创建成功",
-			expectedDataFunc: func(data interface{}) bool {
-				dataMap, ok := data.(map[string]interface{})
-				if !ok {
-					return false
-				}
-				return dataMap["id"] != nil &&
-					dataMap["name"] == "温度传感器" &&
-					dataMap["type"] == string(models.DeviceTypeDevice) &&
-					dataMap["sub_type"] == string(models.SubTypeSensorTemp) &&
-					dataMap["parent_id"] != nil &&
-					dataMap["properties"] != nil
-			},
-		},
-		{
-			name:       "请求参数绑定失败",
-			httpMethod: http.MethodPost,
-			requestBody: device.CreateDeviceRequest{
-				Name: "", // 缺少必填字段 Name
-				Type: models.DeviceTypeAreaController,
-			},
-			mockRepoSetup:    func(m *MockDeviceRepository) {},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeBadRequest,
-			expectedMessage:  "Key: 'CreateDeviceRequest.Name' Error:Field validation for 'Name' failed on the 'required' tag",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		{
-			name:       "数据库创建失败",
-			httpMethod: http.MethodPost,
-			requestBody: device.CreateDeviceRequest{
-				Name: "失败设备",
-				Type: models.DeviceTypeDevice,
-			},
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("CreateTx", mock.Anything).Return(errors.New("db error")).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeInternalError,
-			expectedMessage:  "创建设备失败",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		// 新增：Properties字段JSON格式无效
-		{
-			name:       "Properties字段JSON格式无效",
-			httpMethod: http.MethodPost,
-			requestBody: device.CreateDeviceRequest{
-				Name:       "无效JSON设备",
-				Type:       models.DeviceTypeDevice,
-				Properties: controller.Properties(`{invalid json}`),
-			},
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				// 期望 CreateTx 方法被调用，并返回一个模拟的数据库错误
-				// 这个错误模拟的是数据库层因为 Properties 字段的 JSON 格式无效而拒绝保存
-				m.On("CreateTx", mock.Anything).Return(errors.New("database error: invalid json format")).Run(func(args mock.Arguments) {
-					dev := args.Get(0).(*models.Device)
-					assert.Equal(t, "无效JSON设备", dev.Name)
-					assert.Equal(t, models.DeviceTypeDevice, dev.Type)
-					expectedProperties := controller.Properties(`{invalid json}`)
-					assert.True(t, bytes.Equal(dev.Properties, expectedProperties), "Properties should match")
-				}).Once()
-			},
-			expectedStatus:   http.StatusOK,                // HTTP status is 200 OK for business errors
-			expectedCode:     controller.CodeInternalError, // Business code for internal server error
-			expectedMessage:  "创建设备失败",                     // The message returned by the controller
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-	}
-
-	for _, tc := range tests {
-		t.Run(tc.name, func(t *testing.T) {
-			runTest(t, tc, func(ctx *gin.Context, repo *MockDeviceRepository) {
-				device.NewController(repo, logs.NewSilentLogger()).CreateDevice(ctx)
-			})
-		})
-	}
-}
-
-func TestGetDevice(t *testing.T) {
-	gin.SetMode(gin.TestMode)
-
-	tests := []testCase{
-		{
-			name:        "成功获取设备",
-			httpMethod:  http.MethodGet,
-			requestBody: nil,
-			paramID:     "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("FindByIDString", "1").Return(&models.Device{
-					Model: gorm.Model{
-						ID:        1,
-						CreatedAt: time.Now(),
-						UpdatedAt: time.Now(),
-					},
-					Name:       "测试设备",
-					Type:       models.DeviceTypeAreaController,
-					Location:   "测试地点",
-					Properties: datatypes.JSON(`{"key":"value"}`),
-				}, nil).Once()
-			},
-			expectedStatus:  http.StatusOK,
-			expectedCode:    controller.CodeSuccess,
-			expectedMessage: "获取设备信息成功",
-			expectedDataFunc: func(data interface{}) bool {
-				dataMap, ok := data.(map[string]interface{})
-				if !ok {
-					return false
-				}
-				return dataMap["id"] == float64(1) &&
-					dataMap["name"] == "测试设备" &&
-					dataMap["properties"] != nil
-			},
-		},
-		{
-			name:        "设备未找到",
-			httpMethod:  http.MethodGet,
-			requestBody: nil,
-			paramID:     "999",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("FindByIDString", "999").Return(nil, gorm.ErrRecordNotFound).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeNotFound,
-			expectedMessage:  "设备未找到",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		{
-			name:        "ID格式无效",
-			httpMethod:  http.MethodGet,
-			requestBody: nil,
-			paramID:     "abc",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("FindByIDString", "abc").Return(nil, errors.New("无效的设备ID格式")).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeBadRequest,
-			expectedMessage:  "无效的设备ID格式",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		{
-			name:        "数据库查询失败",
-			httpMethod:  http.MethodGet,
-			requestBody: nil,
-			paramID:     "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("FindByIDString", "1").Return(nil, errors.New("db error")).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeInternalError,
-			expectedMessage:  "获取设备信息失败",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-	}
-
-	for _, tc := range tests {
-		t.Run(tc.name, func(t *testing.T) {
-			runTest(t, tc, func(ctx *gin.Context, repo *MockDeviceRepository) {
-				device.NewController(repo, logs.NewSilentLogger()).GetDevice(ctx)
-			})
-		})
-	}
-}
-
-func TestListDevices(t *testing.T) {
-	gin.SetMode(gin.TestMode)
-
-	tests := []testCase{
-		{
-			name:        "成功获取空列表",
-			httpMethod:  http.MethodGet,
-			requestBody: nil,
-			paramID:     "",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("ListAll").Return([]*models.Device{}, nil).Once()
-			},
-			expectedStatus:  http.StatusOK,
-			expectedCode:    controller.CodeSuccess,
-			expectedMessage: "获取设备列表成功",
-			expectedDataFunc: func(data interface{}) bool {
-				s, ok := data.([]interface{})
-				return ok && len(s) == 0
-			},
-		},
-		{
-			name:        "成功获取包含设备的列表",
-			httpMethod:  http.MethodGet,
-			requestBody: nil,
-			paramID:     "",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("ListAll").Return([]*models.Device{
-					{
-						Model: gorm.Model{
-							ID:        1,
-							CreatedAt: time.Now(),
-							UpdatedAt: time.Now(),
-						},
-						Name: "设备1",
-						Type: models.DeviceTypeAreaController,
-					},
-					{
-						Model: gorm.Model{
-							ID:        2,
-							CreatedAt: time.Now(),
-							UpdatedAt: time.Now(),
-						},
-						Name:     "设备2",
-						Type:     models.DeviceTypeDevice,
-						SubType:  models.SubTypeFan,
-						ParentID: func() *uint { id := uint(1); return &id }(),
-					},
-				}, nil).Once()
-			},
-			expectedStatus:  http.StatusOK,
-			expectedCode:    controller.CodeSuccess,
-			expectedMessage: "获取设备列表成功",
-			expectedDataFunc: func(data interface{}) bool {
-				dataList, ok := data.([]interface{})
-				if !ok {
-					return false
-				}
-				// 检查长度
-				if len(dataList) != 2 {
-					return false
-				}
-				// 检查第一个设备
-				item1, ok1 := dataList[0].(map[string]interface{})
-				if !ok1 || item1["id"] != float64(1) || item1["name"] != "设备1" {
-					return false
-				}
-				// 检查第二个设备
-				item2, ok2 := dataList[1].(map[string]interface{})
-				if !ok2 || item2["id"] != float64(2) || item2["name"] != "设备2" {
-					return false
-				}
-				return true
-			},
-		},
-		{
-			name:        "数据库查询失败",
-			httpMethod:  http.MethodGet,
-			requestBody: nil,
-			paramID:     "",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("ListAll").Return(nil, errors.New("db error")).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeInternalError,
-			expectedMessage:  "获取设备列表失败",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-	}
-
-	for _, tc := range tests {
-		t.Run(tc.name, func(t *testing.T) {
-			runTest(t, tc, func(ctx *gin.Context, repo *MockDeviceRepository) {
-				device.NewController(repo, logs.NewSilentLogger()).ListDevices(ctx)
-			})
-		})
-	}
-}
-
-func TestUpdateDevice(t *testing.T) {
-	gin.SetMode(gin.TestMode)
-
-	tests := []testCase{
-		{
-			name:       "成功更新设备",
-			httpMethod: http.MethodPut,
-			requestBody: device.UpdateDeviceRequest{
-				Name:       "更新后的主控",
-				Type:       models.DeviceTypeAreaController,
-				Location:   "新地点",
-				Properties: controller.Properties(`{"lora_address":"0x5678"}`),
-			},
-			paramID: "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				// 模拟 FindByIDString 找到设备
-				m.On("FindByIDString", "1").Return(&models.Device{
-					Model: gorm.Model{
-						ID:        1,
-						CreatedAt: time.Now(),
-						UpdatedAt: time.Now(),
-					},
-					Name:       "旧主控",
-					Type:       models.DeviceTypeAreaController,
-					Location:   "旧地点",
-					Properties: datatypes.JSON(`{"lora_address":"0x1234"}`),
-				}, nil).Once()
-				// 模拟 Update 成功
-				m.On("Update", mock.AnythingOfType("*models.Device")).Return(nil).Once()
-			},
-			expectedStatus:  http.StatusOK,
-			expectedCode:    controller.CodeSuccess,
-			expectedMessage: "设备更新成功",
-			expectedDataFunc: func(data interface{}) bool {
-				dataMap, ok := data.(map[string]interface{})
-				if !ok {
-					return false
-				}
-				return dataMap["id"] == float64(1) &&
-					dataMap["name"] == "更新后的主控" &&
-					dataMap["location"] == "新地点" &&
-					dataMap["properties"] != nil
-			},
-		},
-		{
-			name:       "请求参数绑定失败",
-			httpMethod: http.MethodPut,
-			requestBody: device.UpdateDeviceRequest{
-				Name: "", // 缺少必填字段 Name
-				Type: models.DeviceTypeAreaController,
-			},
-			paramID: "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				// 模拟 FindByIDString 找到设备，以便进入参数绑定阶段
-				m.On("FindByIDString", "1").Return(&models.Device{Model: gorm.Model{ID: 1}}, nil).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeBadRequest,
-			expectedMessage:  "Key: 'UpdateDeviceRequest.Name' Error:Field validation for 'Name' failed on the 'required' tag",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		{
-			name:       "设备未找到",
-			httpMethod: http.MethodPut,
-			requestBody: device.UpdateDeviceRequest{
-				Name: "任意名称", Type: models.DeviceTypeAreaController,
-			},
-			paramID: "999",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("FindByIDString", "999").Return(nil, gorm.ErrRecordNotFound).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeNotFound,
-			expectedMessage:  "设备未找到",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		{
-			name:       "ID格式无效",
-			httpMethod: http.MethodPut,
-			requestBody: device.UpdateDeviceRequest{
-				Name: "任意名称", Type: models.DeviceTypeAreaController,
-			},
-			paramID: "abc",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("FindByIDString", "abc").Return(nil, errors.New("无效的设备ID格式")).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeBadRequest,
-			expectedMessage:  "无效的设备ID格式",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		{
-			name:       "数据库更新失败",
-			httpMethod: http.MethodPut,
-			requestBody: device.UpdateDeviceRequest{
-				Name: "更新失败设备", Type: models.DeviceTypeAreaController,
-			},
-			paramID: "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("FindByIDString", "1").Return(&models.Device{Model: gorm.Model{ID: 1}}, nil).Once()
-				m.On("Update", mock.AnythingOfType("*models.Device")).Return(errors.New("db error")).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeInternalError,
-			expectedMessage:  "更新设备失败",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		// 新增：Properties字段JSON格式无效
-		{
-			name:       "Properties字段JSON格式无效",
-			httpMethod: http.MethodPut,
-			requestBody: device.UpdateDeviceRequest{
-				Name:       "无效JSON设备",
-				Type:       models.DeviceTypeDevice,
-				Properties: controller.Properties(`{invalid json}`),
-			},
-			paramID: "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				// 模拟 FindByIDString 找到设备，以便进入参数绑定阶段
-				m.On("FindByIDString", "1").Return(&models.Device{Model: gorm.Model{ID: 1}}, nil).Once()
-				// 期望 Update 方法被调用，并返回一个模拟的数据库错误
-				m.On("Update", mock.Anything).Return(errors.New("database error: invalid json format")).Run(func(args mock.Arguments) {
-					dev := args.Get(0).(*models.Device)
-					assert.Equal(t, "无效JSON设备", dev.Name)
-					assert.Equal(t, models.DeviceTypeDevice, dev.Type)
-					expectedProperties := controller.Properties(`{invalid json}`)
-					assert.True(t, bytes.Equal(dev.Properties, expectedProperties), "Properties should match")
-				}).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeInternalError, // Expected to be internal server error due to DB error
-			expectedMessage:  "更新设备失败",                     // The message returned by the controller
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		// 新增：成功更新设备的ParentID
-		{
-			name:       "成功更新设备的ParentID",
-			httpMethod: http.MethodPut,
-			requestBody: device.UpdateDeviceRequest{
-				Name:       "更新ParentID设备",
-				Type:       models.DeviceTypeDevice,
-				ParentID:   func() *uint { id := uint(10); return &id }(),
-				Location:   "新地点",
-				Properties: controller.Properties(`{"key":"value"}`),
-			},
-			paramID: "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				// 模拟 FindByIDString 找到设备
-				m.On("FindByIDString", "1").Return(&models.Device{
-					Model: gorm.Model{
-						ID:        1,
-						CreatedAt: time.Now(),
-						UpdatedAt: time.Now(),
-					},
-					Name:       "旧设备",
-					Type:       models.DeviceTypeDevice,
-					ParentID:   func() *uint { id := uint(1); return &id }(),
-					Location:   "旧地点",
-					Properties: datatypes.JSON(`{"old_key":"old_value"}`),
-				}, nil).Once()
-				// 模拟 Update 成功，并验证 ParentID 被更新
-				m.On("Update", mock.MatchedBy(func(dev *models.Device) bool {
-					return dev.ID == 1 && *dev.ParentID == 10
-				})).Return(nil).Once()
-			},
-			expectedStatus:  http.StatusOK,
-			expectedCode:    controller.CodeSuccess,
-			expectedMessage: "设备更新成功",
-			expectedDataFunc: func(data interface{}) bool {
-				dataMap, ok := data.(map[string]interface{})
-				if !ok {
-					return false
-				}
-				return dataMap["id"] == float64(1) &&
-					dataMap["parent_id"] == float64(10) &&
-					dataMap["properties"] != nil
-			},
-		},
-	}
-
-	for _, tc := range tests {
-		t.Run(tc.name, func(t *testing.T) {
-			runTest(t, tc, func(ctx *gin.Context, repo *MockDeviceRepository) {
-				device.NewController(repo, logs.NewSilentLogger()).UpdateDevice(ctx)
-			})
-		})
-	}
-}
-
-func TestDeleteDevice(t *testing.T) {
-	gin.SetMode(gin.TestMode)
-
-	tests := []testCase{
-		{
-			name:        "成功删除设备",
-			httpMethod:  http.MethodDelete,
-			requestBody: nil,
-			paramID:     "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("Delete", uint(1)).Return(nil).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeSuccess,
-			expectedMessage:  "设备删除成功",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		{
-			name:             "ID格式无效",
-			httpMethod:       http.MethodDelete,
-			requestBody:      nil,
-			paramID:          "abc",
-			mockRepoSetup:    func(m *MockDeviceRepository) {},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeBadRequest,
-			expectedMessage:  "无效的设备ID格式",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		{
-			name:        "数据库删除失败",
-			httpMethod:  http.MethodDelete,
-			requestBody: nil,
-			paramID:     "1",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("Delete", uint(1)).Return(errors.New("db error")).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeInternalError,
-			expectedMessage:  "删除设备失败",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-		// 新增：删除设备未找到
-		{
-			name:        "删除设备未找到",
-			httpMethod:  http.MethodDelete,
-			requestBody: nil,
-			paramID:     "999",
-			mockRepoSetup: func(m *MockDeviceRepository) {
-				m.On("Delete", uint(999)).Return(gorm.ErrRecordNotFound).Once()
-			},
-			expectedStatus:   http.StatusOK,
-			expectedCode:     controller.CodeInternalError, // 当前控制器逻辑会将 ErrRecordNotFound 视为内部错误
-			expectedMessage:  "删除设备失败",
-			expectedDataFunc: func(data interface{}) bool { return data == nil },
-		},
-	}
-
-	for _, tc := range tests {
-		t.Run(tc.name, func(t *testing.T) {
-			runTest(t, tc, func(ctx *gin.Context, repo *MockDeviceRepository) {
-				device.NewController(repo, logs.NewSilentLogger()).DeleteDevice(ctx)
-			})
-		})
-	}
-}

internal/app/controller/management/controller_helpers.go

@@ -0,0 +1,227 @@
+package management
+
+import (
+	"errors"
+	"fmt"
+	"strconv"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
+	"github.com/labstack/echo/v4"
+)
+
+// mapAndSendError 统一映射服务层错误并发送响应。
+// 这个函数将服务层返回的错误转换为控制器层应返回的HTTP状态码和审计信息。
+func mapAndSendError(c *PigBatchController, ctx echo.Context, action string, err error, id uint) error {
+	if errors.Is(err, service.ErrPigBatchNotFound) ||
+		errors.Is(err, service.ErrPenNotFound) ||
+		errors.Is(err, service.ErrPenNotAssociatedWithBatch) {
+		return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), action, err.Error(), id)
+	} else if errors.Is(err, service.ErrInvalidOperation) ||
+		errors.Is(err, service.ErrPigBatchActive) ||
+		errors.Is(err, service.ErrPigBatchNotActive) ||
+		errors.Is(err, service.ErrPenOccupiedByOtherBatch) ||
+		errors.Is(err, service.ErrPenStatusInvalidForAllocation) ||
+		errors.Is(err, service.ErrPenNotEmpty) {
+		return controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), action, err.Error(), id)
+	} else {
+		c.logger.Errorf("操作[%s]业务逻辑失败: %v", action, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, fmt.Sprintf("操作失败: %v", err), action, err.Error(), id)
+	}
+}
+
+// idExtractorFunc 定义了一个函数类型，用于从echo.Context中提取主ID。
+type idExtractorFunc func(ctx echo.Context) (uint, error)
+
+// extractOperatorAndPrimaryID 封装了从echo.Context中提取操作员ID和主ID的通用逻辑。
+// 它负责处理ID提取过程中的错误，并发送相应的HTTP响应。
+//
+// 参数:
+//
+//	c: *PigBatchController - 控制器实例，用于访问其日志。
+//	ctx: echo.Context - Echo上下文。
+//	action: string - 当前操作的描述，用于日志和审计。
+//	idExtractor: idExtractorFunc - 可选函数，用于从ctx中提取主ID。如果为nil，则尝试从":id"路径参数中提取。
+//
+// 返回值:
+//
+//	operatorID: uint - 提取到的操作员ID。
+//	primaryID: uint - 提取到的主ID。
+//	err: error - 如果ID提取失败或发送错误响应，则返回错误。
+func extractOperatorAndPrimaryID(
+	c *PigBatchController,
+	ctx echo.Context,
+	action string,
+	idExtractor idExtractorFunc,
+) (operatorID uint, primaryID uint, err error) {
+	// 1. 获取操作员ID
+	operatorID, err = controller.GetOperatorIDFromContext(ctx)
+	if err != nil {
+		return 0, 0, controller.SendErrorWithAudit(ctx, controller.CodeUnauthorized, "未授权", action, "无法获取操作员ID", nil)
+	}
+
+	// 2. 提取主ID
+	if idExtractor != nil {
+		primaryID, err = idExtractor(ctx)
+		if err != nil {
+			return 0, 0, controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", err.Error())
+		}
+	} else { // 默认从 ":id" 路径参数提取
+		idParam := ctx.Param("id")
+		if idParam == "" { // 有些端点可能没有 "id" 参数，例如列表或创建操作
+			// 如果没有ID参数且没有自定义提取器，primaryID保持为0，这对于某些操作是可接受的
+		} else {
+			parsedID, err := strconv.ParseUint(idParam, 10, 32)
+			if err != nil {
+				return 0, 0, controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", idParam)
+			}
+			primaryID = uint(parsedID)
+		}
+	}
+
+	return operatorID, primaryID, nil
+}
+
+// handleAPIRequest 封装了控制器中处理带有请求体和路径参数的API请求的通用逻辑。
+// 它负责请求体绑定、操作员ID获取、服务层调用、错误映射和响应发送。
+func handleAPIRequest[Req any](
+	c *PigBatchController,
+	ctx echo.Context,
+	action string,
+	reqDTO Req,
+	serviceExecutor func(ctx echo.Context, operatorID uint, primaryID uint, req Req) error,
+	successMsg string,
+	idExtractor idExtractorFunc,
+) error {
+	// 1. 绑定请求体
+	if err := ctx.Bind(&reqDTO); err != nil {
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", reqDTO)
+	}
+
+	// 2. 提取操作员ID和主ID
+	operatorID, primaryID, err := extractOperatorAndPrimaryID(c, ctx, action, idExtractor)
+	if err != nil {
+		return err // 错误已在 extractOperatorAndPrimaryID 中处理
+	}
+
+	// 3. 执行服务层逻辑
+	err = serviceExecutor(ctx, operatorID, primaryID, reqDTO)
+	if err != nil {
+		return mapAndSendError(c, ctx, action, err, primaryID)
+	}
+
+	// 4. 发送成功响应
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, successMsg, nil, action, successMsg, primaryID)
+}
+
+// handleNoBodyAPIRequest 封装了处理不带请求体，但有路径参数和操作员ID的API请求的通用逻辑。
+func handleNoBodyAPIRequest(
+	c *PigBatchController,
+	ctx echo.Context,
+	action string,
+	serviceExecutor func(ctx echo.Context, operatorID uint, primaryID uint) error,
+	successMsg string,
+	idExtractor idExtractorFunc,
+) error {
+	// 1. 提取操作员ID和主ID
+	operatorID, primaryID, err := extractOperatorAndPrimaryID(c, ctx, action, idExtractor)
+	if err != nil {
+		return err // 错误已在 extractOperatorAndPrimaryID 中处理
+	}
+
+	// 2. 执行服务层逻辑
+	err = serviceExecutor(ctx, operatorID, primaryID)
+	if err != nil {
+		return mapAndSendError(c, ctx, action, err, primaryID)
+	}
+
+	// 3. 发送成功响应
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, successMsg, nil, action, successMsg, primaryID)
+}
+
+// handleAPIRequestWithResponse 封装了控制器中处理带有请求体、路径参数并返回响应DTO的API请求的通用逻辑。
+func handleAPIRequestWithResponse[Req any, Resp any](
+	c *PigBatchController,
+	ctx echo.Context,
+	action string,
+	reqDTO Req,
+	serviceExecutor func(ctx echo.Context, operatorID uint, primaryID uint, req Req) (Resp, error), // serviceExecutor现在返回Resp
+	successMsg string,
+	idExtractor idExtractorFunc,
+) error {
+	// 1. 绑定请求体
+	if err := ctx.Bind(&reqDTO); err != nil {
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, fmt.Sprintf("无效的请求体: %v", err), action, fmt.Sprintf("请求体绑定失败: %v", err), reqDTO)
+	}
+
+	// 2. 提取操作员ID和主ID
+	operatorID, primaryID, err := extractOperatorAndPrimaryID(c, ctx, action, idExtractor)
+	if err != nil {
+		return err // 错误已在 extractOperatorAndPrimaryID 中处理
+	}
+
+	// 3. 执行服务层逻辑
+	respDTO, err := serviceExecutor(ctx, operatorID, primaryID, reqDTO)
+	if err != nil {
+		return mapAndSendError(c, ctx, action, err, primaryID)
+	}
+
+	// 4. 发送成功响应
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, successMsg, respDTO, action, successMsg, primaryID)
+}
+
+// handleNoBodyAPIRequestWithResponse 封装了处理不带请求体，但有路径参数和操作员ID，并返回响应DTO的API请求的通用逻辑。
+func handleNoBodyAPIRequestWithResponse[Resp any](
+	c *PigBatchController,
+	ctx echo.Context,
+	action string,
+	serviceExecutor func(ctx echo.Context, operatorID uint, primaryID uint) (Resp, error), // serviceExecutor现在返回Resp
+	successMsg string,
+	idExtractor idExtractorFunc,
+) error {
+	// 1. 提取操作员ID和主ID
+	operatorID, primaryID, err := extractOperatorAndPrimaryID(c, ctx, action, idExtractor)
+	if err != nil {
+		return err // 错误已在 extractOperatorAndPrimaryID 中处理
+	}
+
+	// 2. 执行服务层逻辑
+	respDTO, err := serviceExecutor(ctx, operatorID, primaryID)
+	if err != nil {
+		return mapAndSendError(c, ctx, action, err, primaryID)
+	}
+
+	// 3. 发送成功响应
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, successMsg, respDTO, action, successMsg, primaryID)
+}
+
+// handleQueryAPIRequestWithResponse 封装了处理带有查询参数并返回响应DTO的API请求的通用逻辑。
+func handleQueryAPIRequestWithResponse[Query any, Resp any](
+	c *PigBatchController,
+	ctx echo.Context,
+	action string,
+	queryDTO Query,
+	serviceExecutor func(ctx echo.Context, operatorID uint, query Query) (Resp, error), // serviceExecutor现在接收queryDTO
+	successMsg string,
+) error {
+	// 1. 绑定查询参数
+	if err := ctx.Bind(&queryDTO); err != nil {
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数", action, "查询参数绑定失败", queryDTO)
+	}
+
+	// 2. 获取操作员ID
+	operatorID, err := controller.GetOperatorIDFromContext(ctx)
+	if err != nil {
+		return controller.SendErrorWithAudit(ctx, controller.CodeUnauthorized, "未授权", action, "无法获取操作员ID", nil)
+	}
+
+	// 3. 执行服务层逻辑
+	respDTO, err := serviceExecutor(ctx, operatorID, queryDTO)
+	if err != nil {
+		// 对于列表查询，通常没有primaryID，所以传递0
+		return mapAndSendError(c, ctx, action, err, 0)
+	}
+
+	// 4. 发送成功响应
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, successMsg, respDTO, action, successMsg, nil)
+}

internal/app/controller/management/feed_controller.go

@@ -1 +0,0 @@
-package management

internal/app/controller/management/medication_controller.go

@@ -1 +0,0 @@
-package management

internal/app/controller/management/pig_batch_controller.go

@@ -1,15 +1,13 @@
 package management
 
 import (
-	"errors"
 	"strconv"
 
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
 
-	"github.com/gin-gonic/gin"
+	"github.com/labstack/echo/v4"
 )
 
 // PigBatchController 负责处理猪批次相关的API请求
@@ -29,209 +27,234 @@ func NewPigBatchController(logger *logs.Logger, service service.PigBatchService)
 // CreatePigBatch godoc
 // @Summary      创建猪批次
 // @Description  创建一个新的猪批次
-// @Tags         猪批次管理
+// @Tags         猪群管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        body body dto.PigBatchCreateDTO true "猪批次信息"
 // @Success      201 {object} controller.Response{data=dto.PigBatchResponseDTO} "创建成功"
-// @Failure      400 {object} controller.Response "请求参数错误"
-// @Failure      500 {object} controller.Response "内部服务器错误"
 // @Router       /api/v1/pig-batches [post]
-func (c *PigBatchController) CreatePigBatch(ctx *gin.Context) {
+func (c *PigBatchController) CreatePigBatch(ctx echo.Context) error {
 	const action = "创建猪批次"
 	var req dto.PigBatchCreateDTO
-	if err := ctx.ShouldBindJSON(&req); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
-		return
-	}
 
-	userID, err := controller.GetOperatorIDFromContext(ctx)
-
-	respDTO, err := c.service.CreatePigBatch(userID, &req)
-	if err != nil {
-		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建猪批次失败", action, "业务逻辑失败", req)
-		return
-	}
-
-	controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "创建成功", respDTO, action, "创建成功", respDTO)
+	return handleAPIRequestWithResponse(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.PigBatchCreateDTO) (*dto.PigBatchResponseDTO, error) {
+			// 对于创建操作，primaryID通常不从路径中获取，而是由服务层生成
+			return c.service.CreatePigBatch(operatorID, req)
+		},
+		"创建成功",
+		nil, // 无需自定义ID提取器，primaryID将为0
+	)
 }
 
 // GetPigBatch godoc
 // @Summary      获取单个猪批次
 // @Description  根据ID获取单个猪批次信息
-// @Tags         猪批次管理
+// @Tags         猪群管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "猪批次ID"
 // @Success      200 {object} controller.Response{data=dto.PigBatchResponseDTO} "获取成功"
-// @Failure      400 {object} controller.Response "无效的ID格式"
-// @Failure      404 {object} controller.Response "猪批次不存在"
-// @Failure      500 {object} controller.Response "内部服务器错误"
 // @Router       /api/v1/pig-batches/{id} [get]
-func (c *PigBatchController) GetPigBatch(ctx *gin.Context) {
+func (c *PigBatchController) GetPigBatch(ctx echo.Context) error {
 	const action = "获取猪批次"
-	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
-	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
-	}
 
-	respDTO, err := c.service.GetPigBatch(uint(id))
-	if err != nil {
-		if errors.Is(err, service.ErrPigBatchNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪批次不存在", action, "猪批次不存在", id)
-			return
-		}
-		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪批次失败", action, "业务逻辑失败", id)
-		return
-	}
-
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", respDTO, action, "获取成功", respDTO)
+	return handleNoBodyAPIRequestWithResponse(
+		c, ctx, action,
+		func(ctx echo.Context, operatorID uint, primaryID uint) (*dto.PigBatchResponseDTO, error) {
+			return c.service.GetPigBatch(primaryID)
+		},
+		"获取成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
 }
 
 // UpdatePigBatch godoc
 // @Summary      更新猪批次
 // @Description  更新一个已存在的猪批次信息
-// @Tags         猪批次管理
+// @Tags         猪群管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        id path int true "猪批次ID"
 // @Param        body body dto.PigBatchUpdateDTO true "猪批次信息"
 // @Success      200 {object} controller.Response{data=dto.PigBatchResponseDTO} "更新成功"
-// @Failure      400 {object} controller.Response "请求参数错误或无效的ID格式"
-// @Failure      404 {object} controller.Response "猪批次不存在"
-// @Failure      500 {object} controller.Response "内部服务器错误"
 // @Router       /api/v1/pig-batches/{id} [put]
-func (c *PigBatchController) UpdatePigBatch(ctx *gin.Context) {
+func (c *PigBatchController) UpdatePigBatch(ctx echo.Context) error {
 	const action = "更新猪批次"
-	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
-	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
-	}
-
 	var req dto.PigBatchUpdateDTO
-	if err := ctx.ShouldBindJSON(&req); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
-		return
-	}
 
-	respDTO, err := c.service.UpdatePigBatch(uint(id), &req)
-	if err != nil {
-		if errors.Is(err, service.ErrPigBatchNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪批次不存在", action, "猪批次不存在", id)
-			return
-		}
-		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新猪批次失败", action, "业务逻辑失败", req)
-		return
-	}
-
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "更新成功", respDTO, action, "更新成功", respDTO)
+	return handleAPIRequestWithResponse(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.PigBatchUpdateDTO) (*dto.PigBatchResponseDTO, error) {
+			return c.service.UpdatePigBatch(primaryID, req)
+		},
+		"更新成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
 }
 
 // DeletePigBatch godoc
 // @Summary      删除猪批次
 // @Description  根据ID删除一个猪批次
-// @Tags         猪批次管理
+// @Tags         猪群管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "猪批次ID"
 // @Success      200 {object} controller.Response "删除成功"
-// @Failure      400 {object} controller.Response "无效的ID格式"
-// @Failure      404 {object} controller.Response "猪批次不存在"
-// @Failure      500 {object} controller.Response "内部服务器错误"
 // @Router       /api/v1/pig-batches/{id} [delete]
-func (c *PigBatchController) DeletePigBatch(ctx *gin.Context) {
+func (c *PigBatchController) DeletePigBatch(ctx echo.Context) error {
 	const action = "删除猪批次"
-	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
-	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
-	}
 
-	if err := c.service.DeletePigBatch(uint(id)); err != nil {
-		if errors.Is(err, service.ErrPigBatchNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪批次不存在", action, "猪批次不存在", id)
-			return
-		}
-		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除猪批次失败", action, "业务逻辑失败", id)
-		return
-	}
-
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "删除成功", nil, action, "删除成功", id)
+	return handleNoBodyAPIRequest(
+		c, ctx, action,
+		func(ctx echo.Context, operatorID uint, primaryID uint) error {
+			return c.service.DeletePigBatch(primaryID)
+		},
+		"删除成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
 }
 
 // ListPigBatches godoc
 // @Summary      获取猪批次列表
 // @Description  获取所有猪批次的列表，支持按活跃状态筛选
-// @Tags         猪批次管理
+// @Tags         猪群管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        is_active query bool false "是否活跃 (true/false)"
 // @Success      200 {object} controller.Response{data=[]dto.PigBatchResponseDTO} "获取成功"
-// @Failure      500 {object} controller.Response "内部服务器错误"
 // @Router       /api/v1/pig-batches [get]
-func (c *PigBatchController) ListPigBatches(ctx *gin.Context) {
+func (c *PigBatchController) ListPigBatches(ctx echo.Context) error {
 	const action = "获取猪批次列表"
 	var query dto.PigBatchQueryDTO
-	// ShouldBindQuery 会自动处理 URL 查询参数，例如 ?is_active=true
-	if err := ctx.ShouldBindQuery(&query); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数", action, "查询参数绑定失败", nil)
-		return
-	}
 
-	respDTOs, err := c.service.ListPigBatches(query.IsActive)
-	if err != nil {
-		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪批次列表失败", action, "业务逻辑失败", nil)
-		return
-	}
-
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", respDTOs, action, "获取成功", respDTOs)
+	return handleQueryAPIRequestWithResponse(
+		c, ctx, action, &query,
+		func(ctx echo.Context, operatorID uint, query *dto.PigBatchQueryDTO) ([]*dto.PigBatchResponseDTO, error) {
+			return c.service.ListPigBatches(query.IsActive)
+		},
+		"获取成功",
+	)
 }
 
-// UpdatePigBatchPens godoc
-// @Summary      更新猪批次关联的猪栏
-// @Description  更新指定猪批次当前关联的猪栏列表
-// @Tags         猪批次管理
+// AssignEmptyPensToBatch godoc
+// @Summary      为猪批次分配空栏
+// @Description  将一个或多个空闲猪栏分配给指定的猪批次
+// @Tags         猪群管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        id path int true "猪批次ID"
-// @Param        body body dto.PigBatchUpdatePensRequest true "猪批次关联的猪栏ID列表"
-// @Success      200 {object} controller.Response "更新成功"
-// @Failure      400 {object} controller.Response "请求参数错误或无效的ID格式"
-// @Failure      404 {object} controller.Response "猪批次或猪栏不存在"
-// @Failure      409 {object} controller.Response "业务逻辑冲突 (如猪栏已被使用)"
-// @Failure      500 {object} controller.Response "内部服务器错误"
-// @Router       /api/v1/pig-batches/{id}/pens [put]
-func (c *PigBatchController) UpdatePigBatchPens(ctx *gin.Context) {
-	const action = "更新猪批次关联猪栏"
-	batchID, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
-	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的猪批次ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
-	}
+// @Param        body body dto.AssignEmptyPensToBatchRequest true "待分配的猪栏ID列表"
+// @Success      200 {object} controller.Response "分配成功"
+// @Router       /api/v1/pig-batches/assign-pens/{id} [post]
+func (c *PigBatchController) AssignEmptyPensToBatch(ctx echo.Context) error {
+	const action = "为猪批次分配空栏"
+	var req dto.AssignEmptyPensToBatchRequest
 
-	var req dto.PigBatchUpdatePensRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
-		return
-	}
-
-	err = c.service.UpdatePigBatchPens(uint(batchID), req.PenIDs)
-	if err != nil {
-		if errors.Is(err, service.ErrPigBatchNotFound) || errors.Is(err, service.ErrPenNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), action, err.Error(), batchID)
-			return
-		} else if errors.Is(err, service.ErrPigBatchNotActive) || errors.Is(err, service.ErrPenOccupiedByOtherBatch) || errors.Is(err, service.ErrPenStatusInvalidForAllocation) || errors.Is(err, service.ErrPenNotAssociatedWithBatch) {
-			controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), action, err.Error(), batchID)
-			return
-		}
-		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新猪批次关联猪栏失败", action, err.Error(), batchID)
-		return
-	}
-
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "更新成功", nil, action, "更新成功", batchID)
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.AssignEmptyPensToBatchRequest) error {
+			return c.service.AssignEmptyPensToBatch(primaryID, req.PenIDs, operatorID)
+		},
+		"分配成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}
+
+// ReclassifyPenToNewBatch godoc
+// @Summary      将猪栏划拨到新批次
+// @Description  将一个猪栏（连同其中的猪只）从一个批次整体划拨到另一个批次
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        fromBatchID path int true "源猪批次ID"
+// @Param        body body dto.ReclassifyPenToNewBatchRequest true "划拨请求信息 (包含目标批次ID、猪栏ID和备注)"
+// @Success      200 {object} controller.Response "划拨成功"
+// @Router       /api/v1/pig-batches/reclassify-pen/{fromBatchID} [post]
+func (c *PigBatchController) ReclassifyPenToNewBatch(ctx echo.Context) error {
+	const action = "划拨猪栏到新批次"
+	var req dto.ReclassifyPenToNewBatchRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.ReclassifyPenToNewBatchRequest) error {
+			// primaryID 在这里是 fromBatchID
+			return c.service.ReclassifyPenToNewBatch(primaryID, req.ToBatchID, req.PenID, operatorID, req.Remarks)
+		},
+		"划拨成功",
+		func(ctx echo.Context) (uint, error) { // 自定义ID提取器，从 ":fromBatchID" 路径参数提取
+			idParam := ctx.Param("fromBatchID")
+			parsedID, err := strconv.ParseUint(idParam, 10, 32)
+			if err != nil {
+				return 0, err
+			}
+			return uint(parsedID), nil
+		},
+	)
+}
+
+// RemoveEmptyPenFromBatch godoc
+// @Summary      从猪批次移除空栏
+// @Description  将一个空闲猪栏从指定的猪批次中移除
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Produce      json
+// @Param        batchID path int true "猪批次ID"
+// @Param        penID path int true "待移除的猪栏ID"
+// @Success      200 {object} controller.Response "移除成功"
+// @Router       /api/v1/pig-batches/remove-pen/{penID}/{batchID} [delete]
+func (c *PigBatchController) RemoveEmptyPenFromBatch(ctx echo.Context) error {
+	const action = "从猪批次移除空栏"
+
+	return handleNoBodyAPIRequest(
+		c, ctx, action,
+		func(ctx echo.Context, operatorID uint, primaryID uint) error {
+			// primaryID 在这里是 batchID
+			penIDParam := ctx.Param("penID")
+			parsedPenID, err := strconv.ParseUint(penIDParam, 10, 32)
+			if err != nil {
+				return err // 返回错误，因为 penID 格式无效
+			}
+			return c.service.RemoveEmptyPenFromBatch(primaryID, uint(parsedPenID))
+		},
+		"移除成功",
+		func(ctx echo.Context) (uint, error) { // 自定义ID提取器，从 ":batchID" 路径参数提取
+			idParam := ctx.Param("batchID")
+			parsedID, err := strconv.ParseUint(idParam, 10, 32)
+			if err != nil {
+				return 0, err
+			}
+			return uint(parsedID), nil
+		},
+	)
+}
+
+// MovePigsIntoPen godoc
+// @Summary      将猪只从“虚拟库存”移入指定猪栏
+// @Description  将指定数量的猪只从批次的“虚拟库存”移入一个已分配的猪栏
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.MovePigsIntoPenRequest true "移入猪只请求信息 (包含目标猪栏ID、数量和备注)"
+// @Success      200 {object} controller.Response "移入成功"
+// @Router       /api/v1/pig-batches/move-pigs-into-pen/{id} [post]
+func (c *PigBatchController) MovePigsIntoPen(ctx echo.Context) error {
+	const action = "将猪只移入猪栏"
+	var req dto.MovePigsIntoPenRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.MovePigsIntoPenRequest) error {
+			return c.service.MovePigsIntoPen(primaryID, req.ToPenID, req.Quantity, operatorID, req.Remarks)
+		},
+		"移入成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
 }

internal/app/controller/management/pig_batch_health_controller.go

@@ -0,0 +1,156 @@
+package management
+
+import (
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	"github.com/labstack/echo/v4"
+)
+
+// RecordSickPigs godoc
+// @Summary      记录新增病猪事件
+// @Description  记录猪批次中新增病猪的数量、治疗地点和发生时间
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.RecordSickPigsRequest true "记录病猪请求信息"
+// @Success      200 {object} controller.Response "记录成功"
+// @Router       /api/v1/pig-batches/record-sick-pigs/{id} [post]
+func (c *PigBatchController) RecordSickPigs(ctx echo.Context) error {
+	const action = "记录新增病猪事件"
+	var req dto.RecordSickPigsRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.RecordSickPigsRequest) error {
+			return c.service.RecordSickPigs(operatorID, primaryID, req.PenID, req.Quantity, req.TreatmentLocation, req.HappenedAt, req.Remarks)
+		},
+		"记录成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}
+
+// RecordSickPigRecovery godoc
+// @Summary      记录病猪康复事件
+// @Description  记录猪批次中病猪康复的数量、治疗地点和发生时间
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.RecordSickPigRecoveryRequest true "记录病猪康复请求信息"
+// @Success      200 {object} controller.Response "记录成功"
+// @Router       /api/v1/pig-batches/record-sick-pig-recovery/{id} [post]
+func (c *PigBatchController) RecordSickPigRecovery(ctx echo.Context) error {
+	const action = "记录病猪康复事件"
+	var req dto.RecordSickPigRecoveryRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.RecordSickPigRecoveryRequest) error {
+			return c.service.RecordSickPigRecovery(operatorID, primaryID, req.PenID, req.Quantity, req.TreatmentLocation, req.HappenedAt, req.Remarks)
+		},
+		"记录成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}
+
+// RecordSickPigDeath godoc
+// @Summary      记录病猪死亡事件
+// @Description  记录猪批次中病猪死亡的数量、治疗地点和发生时间
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.RecordSickPigDeathRequest true "记录病猪死亡请求信息"
+// @Success      200 {object} controller.Response "记录成功"
+// @Router       /api/v1/pig-batches/record-sick-pig-death/{id} [post]
+func (c *PigBatchController) RecordSickPigDeath(ctx echo.Context) error {
+	const action = "记录病猪死亡事件"
+	var req dto.RecordSickPigDeathRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.RecordSickPigDeathRequest) error {
+			return c.service.RecordSickPigDeath(operatorID, primaryID, req.PenID, req.Quantity, req.TreatmentLocation, req.HappenedAt, req.Remarks)
+		},
+		"记录成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}
+
+// RecordSickPigCull godoc
+// @Summary      记录病猪淘汰事件
+// @Description  记录猪批次中病猪淘汰的数量、治疗地点和发生时间
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.RecordSickPigCullRequest true "记录病猪淘汰请求信息"
+// @Success      200 {object} controller.Response "记录成功"
+// @Router       /api/v1/pig-batches/record-sick-pig-cull/{id} [post]
+func (c *PigBatchController) RecordSickPigCull(ctx echo.Context) error {
+	const action = "记录病猪淘汰事件"
+	var req dto.RecordSickPigCullRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.RecordSickPigCullRequest) error {
+			return c.service.RecordSickPigCull(operatorID, primaryID, req.PenID, req.Quantity, req.TreatmentLocation, req.HappenedAt, req.Remarks)
+		},
+		"记录成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}
+
+// RecordDeath godoc
+// @Summary      记录正常猪只死亡事件
+// @Description  记录猪批次中正常猪只死亡的数量和发生时间
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.RecordDeathRequest true "记录正常猪只死亡请求信息"
+// @Success      200 {object} controller.Response "记录成功"
+// @Router       /api/v1/pig-batches/record-death/{id} [post]
+func (c *PigBatchController) RecordDeath(ctx echo.Context) error {
+	const action = "记录正常猪只死亡事件"
+	var req dto.RecordDeathRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.RecordDeathRequest) error {
+			return c.service.RecordDeath(operatorID, primaryID, req.PenID, req.Quantity, req.HappenedAt, req.Remarks)
+		},
+		"记录成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}
+
+// RecordCull godoc
+// @Summary      记录正常猪只淘汰事件
+// @Description  记录猪批次中正常猪只淘汰的数量和发生时间
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.RecordCullRequest true "记录正常猪只淘汰请求信息"
+// @Success      200 {object} controller.Response "记录成功"
+// @Router       /api/v1/pig-batches/record-cull/{id} [post]
+func (c *PigBatchController) RecordCull(ctx echo.Context) error {
+	const action = "记录正常猪只淘汰事件"
+	var req dto.RecordCullRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.RecordCullRequest) error {
+			return c.service.RecordCull(operatorID, primaryID, req.PenID, req.Quantity, req.HappenedAt, req.Remarks)
+		},
+		"记录成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}

internal/app/controller/management/pig_batch_trade_controller.go

@@ -0,0 +1,56 @@
+package management
+
+import (
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	"github.com/labstack/echo/v4"
+)
+
+// SellPigs godoc
+// @Summary      处理卖猪的业务逻辑
+// @Description  记录猪批次中的猪只出售事件
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.SellPigsRequest true "卖猪请求信息"
+// @Success      200 {object} controller.Response "卖猪成功"
+// @Router       /api/v1/pig-batches/sell-pigs/{id} [post]
+func (c *PigBatchController) SellPigs(ctx echo.Context) error {
+	const action = "卖猪"
+	var req dto.SellPigsRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.SellPigsRequest) error {
+			return c.service.SellPigs(primaryID, req.PenID, req.Quantity, req.UnitPrice, req.TotalPrice, req.TraderName, req.TradeDate, req.Remarks, operatorID)
+		},
+		"卖猪成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}
+
+// BuyPigs godoc
+// @Summary      处理买猪的业务逻辑
+// @Description  记录猪批次中的猪只购买事件
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.BuyPigsRequest true "买猪请求信息"
+// @Success      200 {object} controller.Response "买猪成功"
+// @Router       /api/v1/pig-batches/buy-pigs/{id} [post]
+func (c *PigBatchController) BuyPigs(ctx echo.Context) error {
+	const action = "买猪"
+	var req dto.BuyPigsRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.BuyPigsRequest) error {
+			return c.service.BuyPigs(primaryID, req.PenID, req.Quantity, req.UnitPrice, req.TotalPrice, req.TraderName, req.TradeDate, req.Remarks, operatorID)
+		},
+		"买猪成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}

internal/app/controller/management/pig_batch_transfer_controller.go

@@ -0,0 +1,67 @@
+package management
+
+import (
+	"strconv"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	"github.com/labstack/echo/v4"
+)
+
+// TransferPigsAcrossBatches godoc
+// @Summary      跨猪群调栏
+// @Description  将指定数量的猪只从一个猪群的猪栏调动到另一个猪群的猪栏
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        sourceBatchID path int true "源猪批次ID"
+// @Param        body body dto.TransferPigsAcrossBatchesRequest true "跨群调栏请求信息"
+// @Success      200 {object} controller.Response "调栏成功"
+// @Router       /api/v1/pig-batches/transfer-across-batches/{sourceBatchID} [post]
+func (c *PigBatchController) TransferPigsAcrossBatches(ctx echo.Context) error {
+	const action = "跨猪群调栏"
+	var req dto.TransferPigsAcrossBatchesRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.TransferPigsAcrossBatchesRequest) error {
+			// primaryID 在这里是 sourceBatchID
+			return c.service.TransferPigsAcrossBatches(primaryID, req.DestBatchID, req.FromPenID, req.ToPenID, req.Quantity, operatorID, req.Remarks)
+		},
+		"调栏成功",
+		func(ctx echo.Context) (uint, error) { // 自定义ID提取器，从 ":sourceBatchID" 路径参数提取
+			idParam := ctx.Param("sourceBatchID")
+			parsedID, err := strconv.ParseUint(idParam, 10, 32)
+			if err != nil {
+				return 0, err
+			}
+			return uint(parsedID), nil
+		},
+	)
+}
+
+// TransferPigsWithinBatch godoc
+// @Summary      群内调栏
+// @Description  将指定数量的猪只在同一个猪群的不同猪栏间调动
+// @Tags         猪群管理
+// @Security     BearerAuth
+// @Accept       json
+// @Produce      json
+// @Param        id path int true "猪批次ID"
+// @Param        body body dto.TransferPigsWithinBatchRequest true "群内调栏请求信息"
+// @Success      200 {object} controller.Response "调栏成功"
+// @Router       /api/v1/pig-batches/transfer-within-batch/{id} [post]
+func (c *PigBatchController) TransferPigsWithinBatch(ctx echo.Context) error {
+	const action = "群内调栏"
+	var req dto.TransferPigsWithinBatchRequest
+
+	return handleAPIRequest(
+		c, ctx, action, &req,
+		func(ctx echo.Context, operatorID uint, primaryID uint, req *dto.TransferPigsWithinBatchRequest) error {
+			// primaryID 在这里是 batchID
+			return c.service.TransferPigsWithinBatch(primaryID, req.FromPenID, req.ToPenID, req.Quantity, operatorID, req.Remarks)
+		},
+		"调栏成功",
+		nil, // 默认从 ":id" 路径参数提取ID
+	)
+}

internal/app/controller/management/pig_controller.go

@@ -1 +0,0 @@
-package management

internal/app/controller/management/pig_farm_controller.go

@@ -8,7 +8,7 @@ import (
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
-	"github.com/gin-gonic/gin"
+	"github.com/labstack/echo/v4"
 )
 
 // --- 控制器定义 ---
@@ -31,174 +31,142 @@ func NewPigFarmController(logger *logs.Logger, service service.PigFarmService) *
 
 // CreatePigHouse godoc
 // @Summary      创建猪舍
-// @Description  创建一个新的猪舍
+// @Description  根据提供的信息创建一个新猪舍
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        body body dto.CreatePigHouseRequest true "猪舍信息"
 // @Success      201 {object} controller.Response{data=dto.PigHouseResponse} "创建成功"
 // @Router       /api/v1/pig-houses [post]
-func (c *PigFarmController) CreatePigHouse(ctx *gin.Context) {
+func (c *PigFarmController) CreatePigHouse(ctx echo.Context) error {
 	const action = "创建猪舍"
 	var req dto.CreatePigHouseRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
-		return
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", action, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
 	}
 
 	house, err := c.service.CreatePigHouse(req.Name, req.Description)
 	if err != nil {
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建猪舍失败", action, "业务逻辑失败", req)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建猪舍失败", action, "业务逻辑失败", req)
 	}
 
-	resp := dto.PigHouseResponse{
-		ID:          house.ID,
-		Name:        house.Name,
-		Description: house.Description,
-	}
-	controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "创建成功", resp, action, "创建成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "创建成功", house, action, "创建成功", house)
 }
 
 // GetPigHouse godoc
 // @Summary      获取单个猪舍
 // @Description  根据ID获取单个猪舍信息
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "猪舍ID"
 // @Success      200 {object} controller.Response{data=dto.PigHouseResponse} "获取成功"
 // @Router       /api/v1/pig-houses/{id} [get]
-func (c *PigFarmController) GetPigHouse(ctx *gin.Context) {
+func (c *PigFarmController) GetPigHouse(ctx echo.Context) error {
 	const action = "获取猪舍"
 	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
 	}
 
 	house, err := c.service.GetPigHouseByID(uint(id))
 	if err != nil {
 		if errors.Is(err, service.ErrHouseNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪舍不存在", action, "猪舍不存在", id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪舍不存在", action, "猪舍不存在", id)
 		}
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪舍失败", action, "业务逻辑失败", id)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪舍失败", action, "业务逻辑失败", id)
 	}
 
-	resp := dto.PigHouseResponse{
-		ID:          house.ID,
-		Name:        house.Name,
-		Description: house.Description,
-	}
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", resp, action, "获取成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", house, action, "获取成功", house)
 }
 
 // ListPigHouses godoc
 // @Summary      获取猪舍列表
 // @Description  获取所有猪舍的列表
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Produce      json
 // @Success      200 {object} controller.Response{data=[]dto.PigHouseResponse} "获取成功"
 // @Router       /api/v1/pig-houses [get]
-func (c *PigFarmController) ListPigHouses(ctx *gin.Context) {
+func (c *PigFarmController) ListPigHouses(ctx echo.Context) error {
 	const action = "获取猪舍列表"
 	houses, err := c.service.ListPigHouses()
 	if err != nil {
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取列表失败", action, "业务逻辑失败", nil)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取列表失败", action, "业务逻辑失败", nil)
 	}
 
-	var resp []dto.PigHouseResponse
-	for _, house := range houses {
-		resp = append(resp, dto.PigHouseResponse{
-			ID:          house.ID,
-			Name:        house.Name,
-			Description: house.Description,
-		})
-	}
-
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", resp, action, "获取成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", houses, action, "获取成功", houses)
 }
 
 // UpdatePigHouse godoc
 // @Summary      更新猪舍
 // @Description  更新一个已存在的猪舍信息
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        id path int true "猪舍ID"
 // @Param        body body dto.UpdatePigHouseRequest true "猪舍信息"
 // @Success      200 {object} controller.Response{data=dto.PigHouseResponse} "更新成功"
 // @Router       /api/v1/pig-houses/{id} [put]
-func (c *PigFarmController) UpdatePigHouse(ctx *gin.Context) {
+func (c *PigFarmController) UpdatePigHouse(ctx echo.Context) error {
 	const action = "更新猪舍"
 	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
 	}
 
 	var req dto.UpdatePigHouseRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
-		return
+	if err := ctx.Bind(&req); err != nil {
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
 	}
 
 	house, err := c.service.UpdatePigHouse(uint(id), req.Name, req.Description)
 	if err != nil {
 		if errors.Is(err, service.ErrHouseNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪舍不存在", action, "猪舍不存在", id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪舍不存在", action, "猪舍不存在", id)
 		}
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新失败", action, "业务逻辑失败", req)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新失败", action, "业务逻辑失败", req)
 	}
 
-	resp := dto.PigHouseResponse{
-		ID:          house.ID,
-		Name:        house.Name,
-		Description: house.Description,
-	}
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "更新成功", resp, action, "更新成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "更新成功", house, action, "更新成功", house)
 }
 
 // DeletePigHouse godoc
 // @Summary      删除猪舍
 // @Description  根据ID删除一个猪舍
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "猪舍ID"
 // @Success      200 {object} controller.Response "删除成功"
 // @Router       /api/v1/pig-houses/{id} [delete]
-func (c *PigFarmController) DeletePigHouse(ctx *gin.Context) {
+func (c *PigFarmController) DeletePigHouse(ctx echo.Context) error {
 	const action = "删除猪舍"
 	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
 	}
 
 	if err := c.service.DeletePigHouse(uint(id)); err != nil {
 		if errors.Is(err, service.ErrHouseNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪舍不存在", action, "猪舍不存在", id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪舍不存在", action, "猪舍不存在", id)
 		}
 		// 检查是否是业务逻辑错误
 		if errors.Is(err, service.ErrHouseContainsPens) {
-			controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), action, err.Error(), id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), action, err.Error(), id)
 		}
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除失败", action, "业务逻辑失败", id)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除失败", action, "业务逻辑失败", id)
 	}
 
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "删除成功", nil, action, "删除成功", id)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "删除成功", nil, action, "删除成功", id)
 }
 
 // --- 猪栏 (Pen) API 实现 ---
@@ -207,237 +175,179 @@ func (c *PigFarmController) DeletePigHouse(ctx *gin.Context) {
 // @Summary      创建猪栏
 // @Description  创建一个新的猪栏
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        body body dto.CreatePenRequest true "猪栏信息"
 // @Success      201 {object} controller.Response{data=dto.PenResponse} "创建成功"
 // @Router       /api/v1/pens [post]
-func (c *PigFarmController) CreatePen(ctx *gin.Context) {
+func (c *PigFarmController) CreatePen(ctx echo.Context) error {
 	const action = "创建猪栏"
 	var req dto.CreatePenRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
-		return
+	if err := ctx.Bind(&req); err != nil {
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
 	}
 
 	pen, err := c.service.CreatePen(req.PenNumber, req.HouseID, req.Capacity)
 	if err != nil {
 		// 检查是否是业务逻辑错误
 		if errors.Is(err, service.ErrHouseNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), action, err.Error(), req)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), action, err.Error(), req)
 		}
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建猪栏失败", action, "业务逻辑失败", req)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建猪栏失败", action, "业务逻辑失败", req)
 	}
 
-	resp := dto.PenResponse{
-		ID:         pen.ID,
-		PenNumber:  pen.PenNumber,
-		HouseID:    pen.HouseID,
-		Capacity:   pen.Capacity,
-		Status:     pen.Status,
-		PigBatchID: *pen.PigBatchID,
-	}
-	controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "创建成功", resp, action, "创建成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "创建成功", pen, action, "创建成功", pen)
 }
 
 // GetPen godoc
 // @Summary      获取单个猪栏
 // @Description  根据ID获取单个猪栏信息
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "猪栏ID"
 // @Success      200 {object} controller.Response{data=dto.PenResponse} "获取成功"
 // @Router       /api/v1/pens/{id} [get]
-func (c *PigFarmController) GetPen(ctx *gin.Context) {
+func (c *PigFarmController) GetPen(ctx echo.Context) error {
 	const action = "获取猪栏"
 	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
 	}
 
 	pen, err := c.service.GetPenByID(uint(id))
 	if err != nil {
 		if errors.Is(err, service.ErrPenNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪栏不存在", action, "猪栏不存在", id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪栏不存在", action, "猪栏不存在", id)
 		}
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪栏失败", action, "业务逻辑失败", id)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪栏失败", action, "业务逻辑失败", id)
 	}
 
-	resp := dto.PenResponse{
-		ID:         pen.ID,
-		PenNumber:  pen.PenNumber,
-		HouseID:    pen.HouseID,
-		Capacity:   pen.Capacity,
-		Status:     pen.Status,
-		PigBatchID: *pen.PigBatchID,
-	}
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", resp, action, "获取成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", pen, action, "获取成功", pen)
 }
 
 // ListPens godoc
 // @Summary      获取猪栏列表
 // @Description  获取所有猪栏的列表
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Produce      json
 // @Success      200 {object} controller.Response{data=[]dto.PenResponse} "获取成功"
 // @Router       /api/v1/pens [get]
-func (c *PigFarmController) ListPens(ctx *gin.Context) {
+func (c *PigFarmController) ListPens(ctx echo.Context) error {
 	const action = "获取猪栏列表"
 	pens, err := c.service.ListPens()
 	if err != nil {
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取列表失败", action, "业务逻辑失败", nil)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取列表失败", action, "业务逻辑失败", nil)
 	}
 
-	var resp []dto.PenResponse
-	for _, pen := range pens {
-		resp = append(resp, dto.PenResponse{
-			ID:         pen.ID,
-			PenNumber:  pen.PenNumber,
-			HouseID:    pen.HouseID,
-			Capacity:   pen.Capacity,
-			Status:     pen.Status,
-			PigBatchID: *pen.PigBatchID,
-		})
-	}
-
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", resp, action, "获取成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取成功", pens, action, "获取成功", pens)
 }
 
 // UpdatePen godoc
 // @Summary      更新猪栏
 // @Description  更新一个已存在的猪栏信息
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        id path int true "猪栏ID"
 // @Param        body body dto.UpdatePenRequest true "猪栏信息"
 // @Success      200 {object} controller.Response{data=dto.PenResponse} "更新成功"
 // @Router       /api/v1/pens/{id} [put]
-func (c *PigFarmController) UpdatePen(ctx *gin.Context) {
+func (c *PigFarmController) UpdatePen(ctx echo.Context) error {
 	const action = "更新猪栏"
 	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
 	}
 
 	var req dto.UpdatePenRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
-		return
+	if err := ctx.Bind(&req); err != nil {
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
 	}
 
 	pen, err := c.service.UpdatePen(uint(id), req.PenNumber, req.HouseID, req.Capacity, req.Status)
 	if err != nil {
 		if errors.Is(err, service.ErrPenNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪栏不存在", action, "猪栏不存在", id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪栏不存在", action, "猪栏不存在", id)
 		}
 		// 其他业务逻辑错误可以在这里添加处理
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新失败", action, "业务逻辑失败", req)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新失败", action, "业务逻辑失败", req)
 	}
 
-	resp := dto.PenResponse{
-		ID:         pen.ID,
-		PenNumber:  pen.PenNumber,
-		HouseID:    pen.HouseID,
-		Capacity:   pen.Capacity,
-		Status:     pen.Status,
-		PigBatchID: *pen.PigBatchID,
-	}
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "更新成功", resp, action, "更新成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "更新成功", pen, action, "更新成功", pen)
 }
 
 // DeletePen godoc
 // @Summary      删除猪栏
 // @Description  根据ID删除一个猪栏
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "猪栏ID"
 // @Success      200 {object} controller.Response "删除成功"
 // @Router       /api/v1/pens/{id} [delete]
-func (c *PigFarmController) DeletePen(ctx *gin.Context) {
+func (c *PigFarmController) DeletePen(ctx echo.Context) error {
 	const action = "删除猪栏"
 	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
 	}
 
 	if err := c.service.DeletePen(uint(id)); err != nil {
 		if errors.Is(err, service.ErrPenNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪栏不存在", action, "猪栏不存在", id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "猪栏不存在", action, "猪栏不存在", id)
 		}
 		// 检查是否是业务逻辑错误
 		if errors.Is(err, service.ErrPenInUse) {
-			controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), action, err.Error(), id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), action, err.Error(), id)
 		}
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除失败", action, "业务逻辑失败", id)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除失败", action, "业务逻辑失败", id)
 	}
 
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "删除成功", nil, action, "删除成功", id)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "删除成功", nil, action, "删除成功", id)
 }
 
 // UpdatePenStatus godoc
 // @Summary      更新猪栏状态
 // @Description  更新指定猪栏的当前状态
 // @Tags         猪场管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        id path int true "猪栏ID"
 // @Param        body body dto.UpdatePenStatusRequest true "新的猪栏状态"
 // @Success      200 {object} controller.Response{data=dto.PenResponse} "更新成功"
 // @Router       /api/v1/pens/{id}/status [put]
-func (c *PigFarmController) UpdatePenStatus(ctx *gin.Context) {
+func (c *PigFarmController) UpdatePenStatus(ctx echo.Context) error {
 	const action = "更新猪栏状态"
 	id, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 	if err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的ID格式", action, "ID格式错误", ctx.Param("id"))
 	}
 
 	var req dto.UpdatePenStatusRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
-		return
+	if err := ctx.Bind(&req); err != nil {
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体", action, "请求体绑定失败", req)
 	}
 
 	pen, err := c.service.UpdatePenStatus(uint(id), req.Status)
 	if err != nil {
 		if errors.Is(err, service.ErrPenNotFound) {
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), action, err.Error(), id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), action, err.Error(), id)
 		} else if errors.Is(err, service.ErrPenStatusInvalidForOccupiedPen) || errors.Is(err, service.ErrPenStatusInvalidForUnoccupiedPen) {
-			controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), action, err.Error(), id)
-			return
+			return controller.SendErrorWithAudit(ctx, controller.CodeConflict, err.Error(), action, err.Error(), id)
 		}
 		c.logger.Errorf("%s: 业务逻辑失败: %v", action, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新猪栏状态失败", action, err.Error(), id)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新猪栏状态失败", action, err.Error(), id)
 	}
 
-	resp := dto.PenResponse{
-		ID:         pen.ID,
-		PenNumber:  pen.PenNumber,
-		HouseID:    pen.HouseID,
-		Capacity:   pen.Capacity,
-		Status:     pen.Status,
-		PigBatchID: *pen.PigBatchID,
-	}
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "更新成功", resp, action, "更新成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "更新成功", pen, action, "更新成功", pen)
 }

internal/app/controller/monitor/monitor_controller.go

@@ -0,0 +1,620 @@
+package monitor
+
+import (
+	"errors"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+	"github.com/labstack/echo/v4"
+)
+
+// Controller 监控控制器，封装了所有与数据监控相关的业务逻辑
+type Controller struct {
+	monitorService service.MonitorService
+	logger         *logs.Logger
+}
+
+// NewController 创建一个新的监控控制器实例
+func NewController(monitorService service.MonitorService, logger *logs.Logger) *Controller {
+	return &Controller{
+		monitorService: monitorService,
+		logger:         logger,
+	}
+}
+
+// ListSensorData godoc
+// @Summary      获取传感器数据列表
+// @Description  根据提供的过滤条件，分页获取传感器数据
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListSensorDataRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListSensorDataResponse}
+// @Router       /api/v1/monitor/sensor-data [get]
+func (c *Controller) ListSensorData(ctx echo.Context) error {
+	const actionType = "获取传感器数据列表"
+
+	var req dto.ListSensorDataRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListSensorData(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取传感器数据失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取传感器数据成功", resp, actionType, "获取传感器数据成功", req)
+}
+
+// ListDeviceCommandLogs godoc
+// @Summary      获取设备命令日志列表
+// @Description  根据提供的过滤条件，分页获取设备命令日志
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListDeviceCommandLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListDeviceCommandLogResponse}
+// @Router       /api/v1/monitor/device-command-logs [get]
+func (c *Controller) ListDeviceCommandLogs(ctx echo.Context) error {
+	const actionType = "获取设备命令日志列表"
+
+	var req dto.ListDeviceCommandLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListDeviceCommandLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取设备命令日志失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取设备命令日志成功", resp, actionType, "获取设备命令日志成功", req)
+}
+
+// ListPlanExecutionLogs godoc
+// @Summary      获取计划执行日志列表
+// @Description  根据提供的过滤条件，分页获取计划执行日志
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListPlanExecutionLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPlanExecutionLogResponse}
+// @Router       /api/v1/monitor/plan-execution-logs [get]
+func (c *Controller) ListPlanExecutionLogs(ctx echo.Context) error {
+	const actionType = "获取计划执行日志列表"
+
+	var req dto.ListPlanExecutionLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListPlanExecutionLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划执行日志失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取计划执行日志成功", resp, actionType, "获取计划执行日志成功", req)
+}
+
+// ListTaskExecutionLogs godoc
+// @Summary      获取任务执行日志列表
+// @Description  根据提供的过滤条件，分页获取任务执行日志
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListTaskExecutionLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListTaskExecutionLogResponse}
+// @Router       /api/v1/monitor/task-execution-logs [get]
+func (c *Controller) ListTaskExecutionLogs(ctx echo.Context) error {
+	const actionType = "获取任务执行日志列表"
+
+	var req dto.ListTaskExecutionLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListTaskExecutionLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取任务执行日志失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取任务执行日志成功", resp, actionType, "获取任务执行日志成功", req)
+}
+
+// ListPendingCollections godoc
+// @Summary      获取待采集请求列表
+// @Description  根据提供的过滤条件，分页获取待采集请求
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListPendingCollectionRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPendingCollectionResponse}
+// @Router       /api/v1/monitor/pending-collections [get]
+func (c *Controller) ListPendingCollections(ctx echo.Context) error {
+	const actionType = "获取待采集请求列表"
+
+	var req dto.ListPendingCollectionRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListPendingCollections(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取待采集请求失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取待采集请求成功", resp, actionType, "获取待采集请求成功", req)
+}
+
+// ListUserActionLogs godoc
+// @Summary      获取用户操作日志列表
+// @Description  根据提供的过滤条件，分页获取用户操作日志
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListUserActionLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListUserActionLogResponse}
+// @Router       /api/v1/monitor/user-action-logs [get]
+func (c *Controller) ListUserActionLogs(ctx echo.Context) error {
+	const actionType = "获取用户操作日志列表"
+
+	var req dto.ListUserActionLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListUserActionLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取用户操作日志失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取用户操作日志成功", resp, actionType, "获取用户操作日志成功", req)
+}
+
+// ListRawMaterialPurchases godoc
+// @Summary      获取原料采购记录列表
+// @Description  根据提供的过滤条件，分页获取原料采购记录
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListRawMaterialPurchaseRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListRawMaterialPurchaseResponse}
+// @Router       /api/v1/monitor/raw-material-purchases [get]
+func (c *Controller) ListRawMaterialPurchases(ctx echo.Context) error {
+	const actionType = "获取原料采购记录列表"
+
+	var req dto.ListRawMaterialPurchaseRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListRawMaterialPurchases(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取原料采购记录失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取原料采购记录成功", resp, actionType, "获取原料采购记录成功", req)
+}
+
+// ListRawMaterialStockLogs godoc
+// @Summary      获取原料库存日志列表
+// @Description  根据提供的过滤条件，分页获取原料库存日志
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListRawMaterialStockLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListRawMaterialStockLogResponse}
+// @Router       /api/v1/monitor/raw-material-stock-logs [get]
+func (c *Controller) ListRawMaterialStockLogs(ctx echo.Context) error {
+	const actionType = "获取原料库存日志列表"
+
+	var req dto.ListRawMaterialStockLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListRawMaterialStockLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取原料库存日志失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取原料库存日志成功", resp, actionType, "获取原料库存日志成功", req)
+}
+
+// ListFeedUsageRecords godoc
+// @Summary      获取饲料使用记录列表
+// @Description  根据提供的过滤条件，分页获取饲料使用记录
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListFeedUsageRecordRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListFeedUsageRecordResponse}
+// @Router       /api/v1/monitor/feed-usage-records [get]
+func (c *Controller) ListFeedUsageRecords(ctx echo.Context) error {
+	const actionType = "获取饲料使用记录列表"
+
+	var req dto.ListFeedUsageRecordRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListFeedUsageRecords(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取饲料使用记录失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取饲料使用记录成功", resp, actionType, "获取饲料使用记录成功", req)
+}
+
+// ListMedicationLogs godoc
+// @Summary      获取用药记录列表
+// @Description  根据提供的过滤条件，分页获取用药记录
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListMedicationLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListMedicationLogResponse}
+// @Router       /api/v1/monitor/medication-logs [get]
+func (c *Controller) ListMedicationLogs(ctx echo.Context) error {
+	const actionType = "获取用药记录列表"
+
+	var req dto.ListMedicationLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListMedicationLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取用药记录失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取用药记录成功", resp, actionType, "获取用药记录成功", req)
+}
+
+// ListPigBatchLogs godoc
+// @Summary      获取猪批次日志列表
+// @Description  根据提供的过滤条件，分页获取猪批次日志
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListPigBatchLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPigBatchLogResponse}
+// @Router       /api/v1/monitor/pig-batch-logs [get]
+func (c *Controller) ListPigBatchLogs(ctx echo.Context) error {
+	const actionType = "获取猪批次日志列表"
+
+	var req dto.ListPigBatchLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListPigBatchLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪批次日志失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取猪批次日志成功", resp, actionType, "获取猪批次日志成功", req)
+}
+
+// ListWeighingBatches godoc
+// @Summary      获取批次称重记录列表
+// @Description  根据提供的过滤条件，分页获取批次称重记录
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListWeighingBatchRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListWeighingBatchResponse}
+// @Router       /api/v1/monitor/weighing-batches [get]
+func (c *Controller) ListWeighingBatches(ctx echo.Context) error {
+	const actionType = "获取批次称重记录列表"
+
+	var req dto.ListWeighingBatchRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListWeighingBatches(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取批次称重记录失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取批次称重记录成功", resp, actionType, "获取批次称重记录成功", req)
+}
+
+// ListWeighingRecords godoc
+// @Summary      获取单次称重记录列表
+// @Description  根据提供的过滤条件，分页获取单次称重记录
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListWeighingRecordRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListWeighingRecordResponse}
+// @Router       /api/v1/monitor/weighing-records [get]
+func (c *Controller) ListWeighingRecords(ctx echo.Context) error {
+	const actionType = "获取单次称重记录列表"
+
+	var req dto.ListWeighingRecordRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListWeighingRecords(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取单次称重记录失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取单次称重记录成功", resp, actionType, "获取单次称重记录成功", req)
+}
+
+// ListPigTransferLogs godoc
+// @Summary      获取猪只迁移日志列表
+// @Description  根据提供的过滤条件，分页获取猪只迁移日志
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListPigTransferLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPigTransferLogResponse}
+// @Router       /api/v1/monitor/pig-transfer-logs [get]
+func (c *Controller) ListPigTransferLogs(ctx echo.Context) error {
+	const actionType = "获取猪只迁移日志列表"
+
+	var req dto.ListPigTransferLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListPigTransferLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪只迁移日志失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取猪只迁移日志成功", resp, actionType, "获取猪只迁移日志成功", req)
+}
+
+// ListPigSickLogs godoc
+// @Summary      获取病猪日志列表
+// @Description  根据提供的过滤条件，分页获取病猪日志
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListPigSickLogRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPigSickLogResponse}
+// @Router       /api/v1/monitor/pig-sick-logs [get]
+func (c *Controller) ListPigSickLogs(ctx echo.Context) error {
+	const actionType = "获取病猪日志列表"
+
+	var req dto.ListPigSickLogRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListPigSickLogs(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取病猪日志失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取病猪日志成功", resp, actionType, "获取病猪日志成功", req)
+}
+
+// ListPigPurchases godoc
+// @Summary      获取猪只采购记录列表
+// @Description  根据提供的过滤条件，分页获取猪只采购记录
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListPigPurchaseRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPigPurchaseResponse}
+// @Router       /api/v1/monitor/pig-purchases [get]
+func (c *Controller) ListPigPurchases(ctx echo.Context) error {
+	const actionType = "获取猪只采购记录列表"
+
+	var req dto.ListPigPurchaseRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListPigPurchases(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪只采购记录失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取猪只采购记录成功", resp, actionType, "获取猪只采购记录成功", req)
+}
+
+// ListPigSales godoc
+// @Summary      获取猪只售卖记录列表
+// @Description  根据提供的过滤条件，分页获取猪只售卖记录
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListPigSaleRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPigSaleResponse}
+// @Router       /api/v1/monitor/pig-sales [get]
+func (c *Controller) ListPigSales(ctx echo.Context) error {
+	const actionType = "获取猪只售卖记录列表"
+
+	var req dto.ListPigSaleRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListPigSales(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取猪只售卖记录失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取猪只售卖记录成功", resp, actionType, "获取猪只售卖记录成功", req)
+}
+
+// ListNotifications godoc
+// @Summary      批量查询通知
+// @Description  根据提供的过滤条件，分页获取通知列表
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListNotificationRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListNotificationResponse}
+// @Router       /api/v1/monitor/notifications [get]
+func (c *Controller) ListNotifications(ctx echo.Context) error {
+	const actionType = "批量查询通知"
+
+	var req dto.ListNotificationRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+	}
+
+	resp, err := c.monitorService.ListNotifications(&req)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "批量查询通知失败: "+err.Error(), actionType, "服务层查询失败", req)
+	}
+
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(resp.List), resp.Pagination.Total)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "批量查询通知成功", resp, actionType, "批量查询通知成功", req)
+}

internal/app/controller/plan/plan_controller.go

@@ -6,29 +6,25 @@ import (
 
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/task"
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/plan"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
-	"github.com/gin-gonic/gin"
-	"gorm.io/gorm"
+	"github.com/labstack/echo/v4"
 )
 
-// --- Controller 定义 ---
+// --- 控制器定义 ---
 
 // Controller 定义了计划相关的控制器
 type Controller struct {
-	logger                  *logs.Logger
-	planRepo                repository.PlanRepository
-	analysisPlanTaskManager *task.AnalysisPlanTaskManager
+	logger      *logs.Logger
+	planService service.PlanService
 }
 
 // NewController 创建一个新的 Controller 实例
-func NewController(logger *logs.Logger, planRepo repository.PlanRepository, analysisPlanTaskManager *task.AnalysisPlanTaskManager) *Controller {
+func NewController(logger *logs.Logger, planService service.PlanService) *Controller {
 	return &Controller{
-		logger:                  logger,
-		planRepo:                planRepo,
-		analysisPlanTaskManager: analysisPlanTaskManager,
+		logger:      logger,
+		planService: planService,
 	}
 }
 
@@ -38,423 +34,251 @@ func NewController(logger *logs.Logger, planRepo repository.PlanRepository, anal
 // @Summary      创建计划
 // @Description  创建一个新的计划，包括其基本信息和所有关联的子计划/任务。
 // @Tags         计划管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        plan body dto.CreatePlanRequest true "计划信息"
 // @Success      200 {object} controller.Response{data=dto.PlanResponse} "业务码为201代表创建成功"
 // @Router       /api/v1/plans [post]
-func (c *Controller) CreatePlan(ctx *gin.Context) {
+func (c *Controller) CreatePlan(ctx echo.Context) error {
 	var req dto.CreatePlanRequest
 	const actionType = "创建计划"
-	if err := ctx.ShouldBindJSON(&req); err != nil {
+	if err := ctx.Bind(&req); err != nil {
 		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体: "+err.Error(), actionType, "请求体绑定失败", req)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体: "+err.Error(), actionType, "请求体绑定失败", req)
 	}
 
-	// 使用已有的转换函数，它已经包含了验证和重排逻辑
-	planToCreate, err := dto.NewPlanFromCreateRequest(&req)
+	// 调用服务层创建计划
+	resp, err := c.planService.CreatePlan(&req)
 	if err != nil {
-		c.logger.Errorf("%s: 计划数据校验失败: %v", actionType, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "计划数据校验失败: "+err.Error(), actionType, "计划数据校验失败", req)
-		return
-	}
-
-	// --- 自动判断 ContentType ---
-	if len(req.SubPlanIDs) > 0 {
-		planToCreate.ContentType = models.PlanContentTypeSubPlans
-	} else {
-		// 如果 SubPlanIDs 未提供，则默认为 Tasks 类型（即使 Tasks 字段也未提供）
-		planToCreate.ContentType = models.PlanContentTypeTasks
-	}
-
-	// 调用仓库方法创建计划
-	if err := c.planRepo.CreatePlan(planToCreate); err != nil {
-		c.logger.Errorf("%s: 数据库创建计划失败: %v", actionType, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建计划失败: "+err.Error(), actionType, "数据库创建计划失败", planToCreate)
-		return
-	}
-
-	// 创建成功后，调用 manager 确保触发器任务定义存在，但不立即加入待执行队列
-	if err := c.analysisPlanTaskManager.EnsureAnalysisTaskDefinition(planToCreate.ID); err != nil {
-		// 这是一个非阻塞性错误，我们只记录日志，因为主流程（创建计划）已经成功
-		c.logger.Errorf("为新创建的计划 %d 确保触发器任务定义失败: %v", planToCreate.ID, err)
-	}
-
-	// 使用已有的转换函数将创建后的模型转换为响应对象
-	resp, err := dto.NewPlanToResponse(planToCreate)
-	if err != nil {
-		c.logger.Errorf("%s: 序列化响应失败: %v", actionType, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "计划创建成功，但响应生成失败", actionType, "响应序列化失败", planToCreate)
-		return
+		c.logger.Errorf("%s: 服务层创建计划失败: %v", actionType, err)
+		// 根据服务层返回的错误类型，转换为相应的HTTP状态码
+		if errors.Is(err, plan.ErrPlanNotFound) { // 修改为 plan.ErrPlanNotFound
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), actionType, "计划数据校验失败或关联计划不存在", req)
+		}
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建计划失败: "+err.Error(), actionType, "服务层创建计划失败", req)
 	}
 
 	// 使用统一的成功响应函数
-	c.logger.Infof("%s: 计划创建成功, ID: %d", actionType, planToCreate.ID)
-	controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "计划创建成功", resp, actionType, "计划创建成功", resp)
+	c.logger.Infof("%s: 计划创建成功, ID: %d", actionType, resp.ID)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "计划创建成功", resp, actionType, "计划创建成功", resp)
 }
 
 // GetPlan godoc
 // @Summary      获取计划详情
 // @Description  根据计划ID获取单个计划的详细信息。
 // @Tags         计划管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "计划ID"
 // @Success      200 {object} controller.Response{data=dto.PlanResponse} "业务码为200代表成功获取"
 // @Router       /api/v1/plans/{id} [get]
-func (c *Controller) GetPlan(ctx *gin.Context) {
+func (c *Controller) GetPlan(ctx echo.Context) error {
 	const actionType = "获取计划详情"
 	// 1. 从 URL 路径中获取 ID
 	idStr := ctx.Param("id")
 	id, err := strconv.ParseUint(idStr, 10, 32)
 	if err != nil {
 		c.logger.Errorf("%s: 计划ID格式错误: %v, ID: %s", actionType, err, idStr)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
 	}
 
-	// 2. 调用仓库层获取计划详情
-	plan, err := c.planRepo.GetPlanByID(uint(id))
+	// 调用服务层获取计划详情
+	resp, err := c.planService.GetPlanByID(uint(id))
 	if err != nil {
-		// 判断是否为“未找到”错误
-		if errors.Is(err, gorm.ErrRecordNotFound) {
-			c.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "计划不存在", actionType, "计划不存在", id)
-			return
+		c.logger.Errorf("%s: 服务层获取计划详情失败: %v, ID: %d", actionType, err, id)
+		if errors.Is(err, plan.ErrPlanNotFound) { // 修改为 plan.ErrPlanNotFound
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), actionType, "计划不存在", id)
 		}
-		// 其他数据库错误视为内部错误
-		c.logger.Errorf("%s: 数据库查询失败: %v, ID: %d", actionType, err, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划详情时发生内部错误", actionType, "数据库查询失败", id)
-		return
-	}
-
-	// 3. 将模型转换为响应 DTO
-	resp, err := dto.NewPlanToResponse(plan)
-	if err != nil {
-		c.logger.Errorf("%s: 序列化响应失败: %v, Plan: %+v", actionType, err, plan)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划详情失败: 内部数据格式错误", actionType, "响应序列化失败", plan)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划详情失败: "+err.Error(), actionType, "服务层获取计划详情失败", id)
 	}
 
 	// 4. 发送成功响应
 	c.logger.Infof("%s: 获取计划详情成功, ID: %d", actionType, id)
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取计划详情成功", resp, actionType, "获取计划详情成功", resp)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取计划详情成功", resp, actionType, "获取计划详情成功", resp)
 }
 
 // ListPlans godoc
 // @Summary      获取计划列表
-// @Description  获取所有计划的列表
+// @Description  获取所有计划的列表，支持按类型过滤和分页
 // @Tags         计划管理
+// @Security     BearerAuth
 // @Produce      json
-// @Success      200 {object} controller.Response{data=[]dto.PlanResponse} "业务码为200代表成功获取列表"
+// @Param        query query dto.ListPlansQuery false "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPlansResponse} "业务码为200代表成功获取列表"
 // @Router       /api/v1/plans [get]
-func (c *Controller) ListPlans(ctx *gin.Context) {
+func (c *Controller) ListPlans(ctx echo.Context) error {
 	const actionType = "获取计划列表"
-	// 1. 调用仓库层获取所有计划
-	plans, err := c.planRepo.ListBasicPlans()
+	var query dto.ListPlansQuery
+	if err := ctx.Bind(&query); err != nil {
+		c.logger.Errorf("%s: 查询参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "查询参数绑定失败", query)
+	}
+
+	// 调用服务层获取计划列表
+	resp, err := c.planService.ListPlans(&query)
 	if err != nil {
-		c.logger.Errorf("%s: 数据库查询失败: %v", actionType, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划列表时发生内部错误", actionType, "数据库查询失败", nil)
-		return
+		c.logger.Errorf("%s: 服务层获取计划列表失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划列表失败: "+err.Error(), actionType, "服务层获取计划列表失败", nil)
 	}
 
-	// 2. 将模型转换为响应 DTO
-	planResponses := make([]dto.PlanResponse, 0, len(plans))
-	for _, p := range plans {
-		resp, err := dto.NewPlanToResponse(&p)
-		if err != nil {
-			c.logger.Errorf("%s: 序列化响应失败: %v, Plan: %+v", actionType, err, p)
-			controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划列表失败: 内部数据格式错误", actionType, "响应序列化失败", p)
-			return
-		}
-		planResponses = append(planResponses, *resp)
-	}
-
-	// 3. 构造并发送成功响应
-	resp := dto.ListPlansResponse{
-		Plans: planResponses,
-		Total: len(planResponses),
-	}
-	c.logger.Infof("%s: 获取计划列表成功, 数量: %d", actionType, len(planResponses))
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取计划列表成功", resp, actionType, "获取计划列表成功", resp)
+	c.logger.Infof("%s: 获取计划列表成功, 数量: %d", actionType, len(resp.Plans))
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取计划列表成功", resp, actionType, "获取计划列表成功", resp)
 }
 
 // UpdatePlan godoc
 // @Summary      更新计划
-// @Description  根据计划ID更新计划的详细信息。
+// @Description  根据计划ID更新计划的详细信息。系统计划不允许修改。
 // @Tags         计划管理
+// @Security     BearerAuth
 // @Accept       json
 // @Produce      json
 // @Param        id path int true "计划ID"
 // @Param        plan body dto.UpdatePlanRequest true "更新后的计划信息"
 // @Success      200 {object} controller.Response{data=dto.PlanResponse} "业务码为200代表更新成功"
 // @Router       /api/v1/plans/{id} [put]
-func (c *Controller) UpdatePlan(ctx *gin.Context) {
+func (c *Controller) UpdatePlan(ctx echo.Context) error {
 	const actionType = "更新计划"
 	// 1. 从 URL 路径中获取 ID
 	idStr := ctx.Param("id")
 	id, err := strconv.ParseUint(idStr, 10, 32)
 	if err != nil {
 		c.logger.Errorf("%s: 计划ID格式错误: %v, ID: %s", actionType, err, idStr)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
 	}
 
 	// 2. 绑定请求体
 	var req dto.UpdatePlanRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
+	if err := ctx.Bind(&req); err != nil {
 		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体: "+err.Error(), actionType, "请求体绑定失败", req)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体: "+err.Error(), actionType, "请求体绑定失败", req)
 	}
 
-	// 3. 将请求转换为模型(转换函数带校验)
-	planToUpdate, err := dto.NewPlanFromUpdateRequest(&req)
+	// 调用服务层更新计划
+	resp, err := c.planService.UpdatePlan(uint(id), &req)
 	if err != nil {
-		c.logger.Errorf("%s: 计划数据校验失败: %v", actionType, err)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "计划数据校验失败: "+err.Error(), actionType, "计划数据校验失败", req)
-		return
-	}
-	planToUpdate.ID = uint(id) // 确保ID被设置
-
-	// --- 自动判断 ContentType ---
-	if len(req.SubPlanIDs) > 0 {
-		planToUpdate.ContentType = models.PlanContentTypeSubPlans
-	} else {
-		// 如果 SubPlanIDs 未提供，则默认为 Tasks 类型（即使 Tasks 字段也未提供）
-		planToUpdate.ContentType = models.PlanContentTypeTasks
-	}
-
-	// 4. 检查计划是否存在
-	_, err = c.planRepo.GetBasicPlanByID(uint(id))
-	if err != nil {
-		if errors.Is(err, gorm.ErrRecordNotFound) {
-			c.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "计划不存在", actionType, "计划不存在", id)
-			return
+		c.logger.Errorf("%s: 服务层更新计划失败: %v, ID: %d", actionType, err, id)
+		if errors.Is(err, plan.ErrPlanNotFound) { // 修改为 plan.ErrPlanNotFound
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), actionType, "计划不存在", id)
+		} else if errors.Is(err, plan.ErrPlanCannotBeModified) { // 修改为 plan.ErrPlanCannotBeModified
+			return controller.SendErrorWithAudit(ctx, controller.CodeForbidden, err.Error(), actionType, "系统计划不允许修改", id)
 		}
-		c.logger.Errorf("%s: 获取计划信息失败: %v, ID: %d", actionType, err, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划信息时发生内部错误", actionType, "数据库查询失败", id)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新计划失败: "+err.Error(), actionType, "服务层更新计划失败", req)
 	}
 
-	// 5. 调用仓库方法更新计划
-	// 只要是更新任务，就重置执行计数器
-	planToUpdate.ExecuteCount = 0 // 重置计数器
-	c.logger.Infof("计划 #%d 被更新，执行计数器已重置为 0。", planToUpdate.ID)
-
-	if err := c.planRepo.UpdatePlan(planToUpdate); err != nil {
-		c.logger.Errorf("%s: 数据库更新计划失败: %v, Plan: %+v", actionType, err, planToUpdate)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新计划失败: "+err.Error(), actionType, "数据库更新计划失败", planToUpdate)
-		return
-	}
-
-	// 更新成功后，调用 manager 确保触发器任务定义存在
-	if err := c.analysisPlanTaskManager.EnsureAnalysisTaskDefinition(planToUpdate.ID); err != nil {
-		// 这是一个非阻塞性错误，我们只记录日志
-		c.logger.Errorf("为更新后的计划 %d 确保触发器任务定义失败: %v", planToUpdate.ID, err)
-	}
-
-	// 6. 获取更新后的完整计划用于响应
-	updatedPlan, err := c.planRepo.GetPlanByID(uint(id))
-	if err != nil {
-		c.logger.Errorf("%s: 获取更新后计划详情失败: %v, ID: %d", actionType, err, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取更新后计划详情时发生内部错误", actionType, "获取更新后计划详情失败", id)
-		return
-	}
-
-	// 7. 将模型转换为响应 DTO
-	resp, err := dto.NewPlanToResponse(updatedPlan)
-	if err != nil {
-		c.logger.Errorf("%s: 序列化响应失败: %v, Updated Plan: %+v", actionType, err, updatedPlan)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "计划更新成功，但响应生成失败", actionType, "响应序列化失败", updatedPlan)
-		return
-	}
-
-	// 8. 发送成功响应
-	c.logger.Infof("%s: 计划更新成功, ID: %d", actionType, updatedPlan.ID)
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "计划更新成功", resp, actionType, "计划更新成功", resp)
+	// 9. 发送成功响应
+	c.logger.Infof("%s: 计划更新成功, ID: %d", actionType, resp.ID)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "计划更新成功", resp, actionType, "计划更新成功", resp)
 }
 
 // DeletePlan godoc
 // @Summary      删除计划
-// @Description  根据计划ID删除计划。（软删除）
+// @Description  根据计划ID删除计划。（软删除）系统计划不允许删除。
 // @Tags         计划管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "计划ID"
 // @Success      200 {object} controller.Response "业务码为200代表删除成功"
 // @Router       /api/v1/plans/{id} [delete]
-func (c *Controller) DeletePlan(ctx *gin.Context) {
+func (c *Controller) DeletePlan(ctx echo.Context) error {
 	const actionType = "删除计划"
 	// 1. 从 URL 路径中获取 ID
 	idStr := ctx.Param("id")
 	id, err := strconv.ParseUint(idStr, 10, 32)
 	if err != nil {
 		c.logger.Errorf("%s: 计划ID格式错误: %v, ID: %s", actionType, err, idStr)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
 	}
 
-	// 2. 检查计划是否存在
-	plan, err := c.planRepo.GetBasicPlanByID(uint(id))
+	// 调用服务层删除计划
+	err = c.planService.DeletePlan(uint(id))
 	if err != nil {
-		if errors.Is(err, gorm.ErrRecordNotFound) {
-			c.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "计划不存在", actionType, "计划不存在", id)
-			return
+		c.logger.Errorf("%s: 服务层删除计划失败: %v, ID: %d", actionType, err, id)
+		if errors.Is(err, plan.ErrPlanNotFound) { // 修改为 plan.ErrPlanNotFound
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), actionType, "计划不存在", id)
+		} else if errors.Is(err, plan.ErrPlanCannotBeDeleted) { // 修改为 plan.ErrPlanCannotBeDeleted
+			return controller.SendErrorWithAudit(ctx, controller.CodeForbidden, err.Error(), actionType, "系统计划不允许删除", id)
 		}
-		c.logger.Errorf("%s: 获取计划信息失败: %v, ID: %d", actionType, err, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划信息时发生内部错误", actionType, "数据库查询失败", id)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除计划失败: "+err.Error(), actionType, "服务层删除计划失败", id)
 	}
 
-	// 3. 停止这个计划
-	if plan.Status == models.PlanStatusEnabled {
-		if err := c.planRepo.StopPlanTransactionally(uint(id)); err != nil {
-			c.logger.Errorf("%s: 停止计划失败: %v, ID: %d", actionType, err, id)
-			controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "停止计划时发生内部错误: "+err.Error(), actionType, "停止计划失败", id)
-			return
-		}
-	}
-
-	// 4. 调用仓库层删除计划
-	if err := c.planRepo.DeletePlan(uint(id)); err != nil {
-		c.logger.Errorf("%s: 数据库删除失败: %v, ID: %d", actionType, err, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除计划时发生内部错误", actionType, "数据库删除失败", id)
-		return
-	}
-
-	// 5. 发送成功响应
+	// 6. 发送成功响应
 	c.logger.Infof("%s: 计划删除成功, ID: %d", actionType, id)
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "计划删除成功", nil, actionType, "计划删除成功", id)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "计划删除成功", nil, actionType, "计划删除成功", id)
 }
 
 // StartPlan godoc
 // @Summary      启动计划
-// @Description  根据计划ID启动一个计划的执行。
+// @Description  根据计划ID启动一个计划的执行。系统计划不允许手动启动。
 // @Tags         计划管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "计划ID"
 // @Success      200 {object} controller.Response "业务码为200代表成功启动计划"
 // @Router       /api/v1/plans/{id}/start [post]
-func (c *Controller) StartPlan(ctx *gin.Context) {
+func (c *Controller) StartPlan(ctx echo.Context) error {
 	const actionType = "启动计划"
 	// 1. 从 URL 路径中获取 ID
 	idStr := ctx.Param("id")
 	id, err := strconv.ParseUint(idStr, 10, 32)
 	if err != nil {
 		c.logger.Errorf("%s: 计划ID格式错误: %v, ID: %s", actionType, err, idStr)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
 	}
 
-	// 2. 检查计划是否存在
-	plan, err := c.planRepo.GetBasicPlanByID(uint(id))
+	// 调用服务层启动计划
+	err = c.planService.StartPlan(uint(id))
 	if err != nil {
-		if errors.Is(err, gorm.ErrRecordNotFound) {
-			c.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "计划不存在", actionType, "计划不存在", id)
-			return
+		c.logger.Errorf("%s: 服务层启动计划失败: %v, ID: %d", actionType, err, id)
+		if errors.Is(err, plan.ErrPlanNotFound) { // 修改为 plan.ErrPlanNotFound
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), actionType, "计划不存在", id)
+		} else if errors.Is(err, plan.ErrPlanCannotBeStarted) { // 修改为 plan.ErrPlanCannotBeStarted
+			return controller.SendErrorWithAudit(ctx, controller.CodeForbidden, err.Error(), actionType, "系统计划不允许手动启动", id)
+		} else if errors.Is(err, plan.ErrPlanAlreadyEnabled) { // 修改为 plan.ErrPlanAlreadyEnabled
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, err.Error(), actionType, "计划已处于启动状态", id)
 		}
-		c.logger.Errorf("%s: 获取计划信息失败: %v, ID: %d", actionType, err, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划信息时发生内部错误", actionType, "数据库查询失败", id)
-		return
-	}
-
-	// 3. 检查计划当前状态
-	if plan.Status == models.PlanStatusEnabled {
-		c.logger.Warnf("%s: 计划已处于启动状态，无需重复操作, ID: %d", actionType, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "计划已处于启动状态，无需重复操作", actionType, "计划已处于启动状态", id)
-		return
-	}
-
-	// 4. 检查并重置执行计数器，然后更新计划状态为“已启动”
-	// 只有当计划是从非 Enabled 状态（如 Disabled, Stopeed, Failed）启动时，才需要重置计数器
-	if plan.Status != models.PlanStatusEnabled {
-		// 如果计划是从停止或失败状态重新启动，且计数器不为0，则重置执行计数
-		if plan.ExecuteCount > 0 {
-			if err := c.planRepo.UpdateExecuteCount(plan.ID, 0); err != nil {
-				c.logger.Errorf("%s: 重置计划执行计数失败: %v, ID: %d", actionType, err, plan.ID)
-				controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "重置计划执行计数失败", actionType, "重置执行计数失败", plan.ID)
-				return
-			}
-			c.logger.Infof("计划 #%d 的执行计数器已重置为 0。", plan.ID)
-		}
-
-		// 更新计划状态为“已启动”
-		if err := c.planRepo.UpdatePlanStatus(plan.ID, models.PlanStatusEnabled); err != nil {
-			c.logger.Errorf("%s: 更新计划状态失败: %v, ID: %d", actionType, err, plan.ID)
-			controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新计划状态失败", actionType, "更新计划状态失败", plan.ID)
-			return
-		}
-		c.logger.Infof("已成功更新计划 #%d 的状态为 '已启动'。", plan.ID)
-	} else {
-		// 如果计划已经处于 Enabled 状态，则无需更新
-		c.logger.Infof("计划 #%d 已处于启动状态，无需重复操作。", plan.ID)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "计划已处于启动状态，无需重复操作", actionType, "计划已处于启动状态", plan.ID)
-		return
-	}
-
-	// 5. 为计划创建或更新触发器
-	if err := c.analysisPlanTaskManager.CreateOrUpdateTrigger(plan.ID); err != nil {
-		// 此处错误不回滚状态，因为状态更新已成功，但需要明确告知用户触发器创建失败
-		c.logger.Errorf("%s: 创建或更新触发器失败: %v, ID: %d", actionType, err, plan.ID)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "计划状态已更新，但创建执行触发器失败，请检查计划配置或稍后重试", actionType, "创建执行触发器失败", plan.ID)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "启动计划失败: "+err.Error(), actionType, "服务层启动计划失败", id)
 	}
 
 	// 6. 发送成功响应
 	c.logger.Infof("%s: 计划已成功启动, ID: %d", actionType, id)
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "计划已成功启动", nil, actionType, "计划已成功启动", id)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "计划已成功启动", nil, actionType, "计划已成功启动", id)
 }
 
 // StopPlan godoc
 // @Summary      停止计划
-// @Description  根据计划ID停止一个正在执行的计划。
+// @Description  根据计划ID停止一个正在执行的计划。系统计划不能被停止。
 // @Tags         计划管理
+// @Security     BearerAuth
 // @Produce      json
 // @Param        id path int true "计划ID"
 // @Success      200 {object} controller.Response "业务码为200代表成功停止计划"
 // @Router       /api/v1/plans/{id}/stop [post]
-func (c *Controller) StopPlan(ctx *gin.Context) {
+func (c *Controller) StopPlan(ctx echo.Context) error {
 	const actionType = "停止计划"
 	// 1. 从 URL 路径中获取 ID
 	idStr := ctx.Param("id")
 	id, err := strconv.ParseUint(idStr, 10, 32)
 	if err != nil {
 		c.logger.Errorf("%s: 计划ID格式错误: %v, ID: %s", actionType, err, idStr)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的计划ID格式", actionType, "计划ID格式错误", idStr)
 	}
 
-	// 2. 检查计划是否存在
-	plan, err := c.planRepo.GetBasicPlanByID(uint(id))
+	// 调用服务层停止计划
+	err = c.planService.StopPlan(uint(id))
 	if err != nil {
-		if errors.Is(err, gorm.ErrRecordNotFound) {
-			c.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
-			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "计划不存在", actionType, "计划不存在", id)
-			return
+		c.logger.Errorf("%s: 服务层停止计划失败: %v, ID: %d", actionType, err, id)
+		if errors.Is(err, plan.ErrPlanNotFound) { // 修改为 plan.ErrPlanNotFound
+			return controller.SendErrorWithAudit(ctx, controller.CodeNotFound, err.Error(), actionType, "计划不存在", id)
+		} else if errors.Is(err, plan.ErrPlanCannotBeStopped) { // 修改为 plan.ErrPlanCannotBeStopped
+			return controller.SendErrorWithAudit(ctx, controller.CodeForbidden, err.Error(), actionType, "系统计划不允许停止", id)
+		} else if errors.Is(err, plan.ErrPlanNotEnabled) { // 修改为 plan.ErrPlanNotEnabled
+			return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, err.Error(), actionType, "计划未启用", id)
 		}
-		c.logger.Errorf("%s: 获取计划信息失败: %v, ID: %d", actionType, err, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取计划信息时发生内部错误", actionType, "数据库查询失败", id)
-		return
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "停止计划失败: "+err.Error(), actionType, "服务层停止计划失败", id)
 	}
 
-	// 3. 检查计划当前状态
-	if plan.Status != models.PlanStatusEnabled {
-		c.logger.Warnf("%s: 计划当前不是启用状态, ID: %d, Status: %s", actionType, id, plan.Status)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "计划当前不是启用状态", actionType, "计划未启用", id)
-		return
-	}
-
-	// 4. 调用仓库层方法，该方法内部处理事务
-	if err := c.planRepo.StopPlanTransactionally(uint(id)); err != nil {
-		c.logger.Errorf("%s: 停止计划失败: %v, ID: %d", actionType, err, id)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "停止计划时发生内部错误: "+err.Error(), actionType, "停止计划失败", id)
-		return
-	}
-
-	// 5. 发送成功响应
+	// 6. 发送成功响应
 	c.logger.Infof("%s: 计划已成功停止, ID: %d", actionType, id)
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "计划已成功停止", nil, actionType, "计划已成功停止", id)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "计划已成功停止", nil, actionType, "计划已成功停止", id)
 }

internal/app/controller/plan/plan_controller_test.go

@@ -1,827 +0,0 @@
-package plan
-
-import (
-	"bytes"
-	"encoding/json"
-	"errors"
-	"net/http"
-	"net/http/httptest"
-	"strconv"
-	"testing"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
-	"github.com/gin-gonic/gin"
-	"github.com/stretchr/testify/assert"
-	"gorm.io/gorm"
-)
-
-// MockPlanRepository 是 repository.PlanRepository 的一个模拟实现，用于测试
-type MockPlanRepository struct {
-	// CreatePlanFunc 模拟 CreatePlan 方法的行为
-	CreatePlanFunc func(plan *models.Plan) error
-	// GetPlanByIDFunc 模拟 GetPlanByID 方法的行为
-	GetPlanByIDFunc func(id uint) (*models.Plan, error)
-	// GetBasicPlanByIDFunc 模拟 GetBasicPlanByID 方法的行为
-	GetBasicPlanByIDFunc func(id uint) (*models.Plan, error)
-	// ListBasicPlansFunc 模拟 ListBasicPlans 方法的行为
-	ListBasicPlansFunc func() ([]models.Plan, error)
-	// UpdatePlanFunc 模拟 UpdatePlan 方法的行为
-	UpdatePlanFunc func(plan *models.Plan) error
-	// DeletePlanFunc 模拟 DeletePlan 方法的行为
-	DeletePlanFunc func(id uint) error
-}
-
-// ListBasicPlans 实现了 MockPlanRepository 接口的 ListBasicPlans 方法
-func (m *MockPlanRepository) ListBasicPlans() ([]models.Plan, error) {
-	return m.ListBasicPlansFunc()
-}
-
-// GetBasicPlanByID 实现了 MockPlanRepository 接口的 GetBasicPlanByID 方法
-func (m *MockPlanRepository) GetBasicPlanByID(id uint) (*models.Plan, error) {
-	return m.GetBasicPlanByIDFunc(id)
-}
-
-// GetPlanByID 实现了 MockPlanRepository 接口的 GetPlanByID 方法
-func (m *MockPlanRepository) GetPlanByID(id uint) (*models.Plan, error) {
-	return m.GetPlanByIDFunc(id)
-}
-
-// CreatePlan 实现了 MockPlanRepository 接口的 CreatePlan 方法
-func (m *MockPlanRepository) CreatePlan(plan *models.Plan) error {
-	return m.CreatePlanFunc(plan)
-}
-
-// UpdatePlan 实现了 MockPlanRepository 接口的 UpdatePlan 方法
-func (m *MockPlanRepository) UpdatePlan(plan *models.Plan) error {
-	return m.UpdatePlanFunc(plan)
-}
-
-// DeletePlan 实现了 MockPlanRepository 接口的 DeletePlan 方法
-func (m *MockPlanRepository) DeletePlan(id uint) error {
-	return m.DeletePlanFunc(id)
-}
-
-// setupTestRouter 创建一个用于测试的 gin 引擎和控制器实例
-func setupTestRouter(repo repository.PlanRepository) *gin.Engine {
-	gin.SetMode(gin.TestMode)
-	router := gin.Default()
-	logger := logs.NewSilentLogger()
-	planController := NewController(logger, repo)
-	router.POST("/plans", planController.CreatePlan)
-	router.GET("/plans/:id", planController.GetPlan)
-	router.GET("/plans", planController.ListPlans)
-	router.PUT("/plans/:id", planController.UpdatePlan)
-	router.DELETE("/plans/:id", planController.DeletePlan)
-	return router
-}
-
-// TestController_CreatePlan 测试 CreatePlan 方法
-func TestController_CreatePlan(t *testing.T) {
-	t.Run("成功-创建包含任务的计划", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库行为：CreatePlan 成功时，为计划和任务分配ID
-		mockRepo := &MockPlanRepository{
-			CreatePlanFunc: func(plan *models.Plan) error {
-				plan.ID = 1
-				for i := range plan.Tasks {
-					plan.Tasks[i].ID = uint(i + 1)
-					plan.Tasks[i].PlanID = plan.ID
-				}
-				return nil
-			},
-		}
-		// 设置 Gin 路由器，并注入模拟仓库
-		router := setupTestRouter(mockRepo)
-
-		// 准备请求体
-		reqBody := CreatePlanRequest{
-			Name:          "Test Plan with Tasks",
-			ExecutionType: models.PlanExecutionTypeManual,
-			ContentType:   models.PlanContentTypeTasks,
-			Tasks: []TaskRequest{
-				{Name: "Task 1", ExecutionOrder: 1, Type: models.TaskTypeWaiting},
-			},
-		}
-		bodyBytes, _ := json.Marshal(reqBody)
-
-		// 创建 HTTP 请求
-		req, _ := http.NewRequest(http.MethodPost, "/plans", bytes.NewBuffer(bodyBytes))
-		req.Header.Set("Content-Type", "application/json")
-		w := httptest.NewRecorder()
-
-		// Act (执行阶段)
-		// 发送 HTTP 请求到路由器
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		// 验证 HTTP 状态码
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		// 解析响应体
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		// 验证业务响应码和消息
-		assert.Equal(t, controller.CodeCreated, resp.Code)
-		assert.Equal(t, "计划创建成功", resp.Message)
-
-		// 验证返回数据中的计划ID
-		dataMap, ok := resp.Data.(map[string]interface{})
-		assert.True(t, ok)
-		assert.Equal(t, float64(1), dataMap["id"])
-	})
-}
-
-// TestController_GetPlan 是为 GetPlan 方法新增的单元测试函数
-func TestController_GetPlan(t *testing.T) {
-	t.Run("成功-获取计划详情", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库行为：GetPlanByID 成功时返回一个计划
-		mockRepo := &MockPlanRepository{
-			GetPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				assert.Equal(t, uint(1), id)
-				return &models.Plan{
-					Model:       gorm.Model{ID: 1},
-					Name:        "Test Plan",
-					ContentType: models.PlanContentTypeTasks,
-				}, nil
-			},
-		}
-		// 设置 Gin 路由器
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		// 创建 HTTP 请求
-		req, _ := http.NewRequest(http.MethodGet, "/plans/1", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeSuccess, resp.Code)
-		dataMap, ok := resp.Data.(map[string]interface{})
-		assert.True(t, ok)
-		assert.Equal(t, float64(1), dataMap["id"])
-	})
-
-	t.Run("成功-获取内容为空的计划详情", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库行为：GetPlanByID 成功时返回一个任务列表为空的计划
-		mockRepo := &MockPlanRepository{
-			GetPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				assert.Equal(t, uint(3), id)
-				return &models.Plan{
-					Model:       gorm.Model{ID: 3},
-					Name:        "Empty Plan",
-					ContentType: models.PlanContentTypeTasks,
-					Tasks:       []models.Task{}, // 任务列表为空
-				}, nil
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodGet, "/plans/3", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeSuccess, resp.Code)
-
-		dataMap, ok := resp.Data.(map[string]interface{})
-		assert.True(t, ok)
-		assert.Equal(t, float64(3), dataMap["id"])
-		assert.Equal(t, "Empty Plan", dataMap["name"])
-
-		// 关键断言：因为 omitempty 标签，当 tasks 列表为空时，该字段不应该出现在JSON中
-		_, ok = dataMap["tasks"]
-		assert.False(t, ok, "当任务列表为空时，'tasks' 字段因为 omitempty 标签，不应该出现在JSON响应中")
-	})
-
-	t.Run("失败-计划不存在", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库行为：GetPlanByID 返回记录未找到错误
-		mockRepo := &MockPlanRepository{
-			GetPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				return nil, gorm.ErrRecordNotFound
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodGet, "/plans/999", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeNotFound, resp.Code)
-		assert.Equal(t, "计划不存在", resp.Message)
-	})
-
-	t.Run("失败-无效的ID格式", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库为空，因为预期不会调用仓库方法
-		mockRepo := &MockPlanRepository{}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		// 创建带有无效ID格式的 HTTP 请求
-		req, _ := http.NewRequest(http.MethodGet, "/plans/abc", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeBadRequest, resp.Code)
-		assert.Equal(t, "无效的计划ID格式", resp.Message)
-	})
-
-	t.Run("失败-仓库层内部错误", func(t *testing.T) {
-		// Arrange (准备阶段)
-		internalErr := errors.New("database connection lost")
-		// 模拟仓库行为：GetPlanByID 返回内部错误
-		mockRepo := &MockPlanRepository{
-			GetPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				return nil, internalErr
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodGet, "/plans/1", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeInternalError, resp.Code)
-		assert.Equal(t, "获取计划详情时发生内部错误", resp.Message)
-	})
-}
-
-// TestController_ListPlans 测试 ListPlans 方法
-func TestController_ListPlans(t *testing.T) {
-	t.Run("成功-获取计划列表", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟返回的计划列表
-		mockPlans := []models.Plan{
-			{Model: gorm.Model{ID: 1}, Name: "Plan 1", ContentType: models.PlanContentTypeTasks},
-			{Model: gorm.Model{ID: 2}, Name: "Plan 2", ContentType: models.PlanContentTypeTasks},
-		}
-		// 模拟仓库行为：ListBasicPlans 成功时返回计划列表
-		mockRepo := &MockPlanRepository{
-			ListBasicPlansFunc: func() ([]models.Plan, error) {
-				return mockPlans, nil
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodGet, "/plans", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeSuccess, resp.Code)
-		assert.Equal(t, "获取计划列表成功", resp.Message)
-
-		dataBytes, err := json.Marshal(resp.Data)
-		assert.NoError(t, err)
-		var listResp ListPlansResponse
-		err = json.Unmarshal(dataBytes, &listResp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, 2, listResp.Total)
-		assert.Len(t, listResp.Plans, 2)
-		assert.Equal(t, uint(1), listResp.Plans[0].ID)
-		assert.Equal(t, "Plan 1", listResp.Plans[0].Name)
-	})
-
-	t.Run("成功-返回空列表", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库行为：ListBasicPlans 返回空列表
-		mockRepo := &MockPlanRepository{
-			ListBasicPlansFunc: func() ([]models.Plan, error) {
-				return []models.Plan{}, nil
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodGet, "/plans", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeSuccess, resp.Code)
-
-		dataBytes, err := json.Marshal(resp.Data)
-		assert.NoError(t, err)
-		var listResp ListPlansResponse
-		err = json.Unmarshal(dataBytes, &listResp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, 0, listResp.Total)
-		assert.Len(t, listResp.Plans, 0)
-	})
-
-	t.Run("失败-仓库层返回错误", func(t *testing.T) {
-		// Arrange (准备阶段)
-		dbErr := errors.New("db error")
-		// 模拟仓库行为：ListBasicPlans 返回数据库错误
-		mockRepo := &MockPlanRepository{
-			ListBasicPlansFunc: func() ([]models.Plan, error) {
-				return nil, dbErr
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodGet, "/plans", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeInternalError, resp.Code)
-		assert.Equal(t, "获取计划列表时发生内部错误", resp.Message)
-	})
-}
-
-// TestController_UpdatePlan 是 UpdatePlan 的测试函数
-func TestController_UpdatePlan(t *testing.T) {
-	t.Run("成功-更新计划", func(t *testing.T) {
-		// Arrange (准备阶段)
-		planID := uint(1)
-		updatedName := "Updated Plan Name"
-		// 模拟一个已存在的计划
-		mockPlan := &models.Plan{
-			Model:       gorm.Model{ID: planID},
-			Name:        "Original Plan",
-			Description: "Original Description",
-			ContentType: models.PlanContentTypeTasks,
-		}
-		// 配置模拟仓库的行为
-		mockRepo := &MockPlanRepository{
-			// 模拟 GetBasicPlanByID 成功返回现有计划
-			GetBasicPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				assert.Equal(t, planID, id)
-				return mockPlan, nil
-			},
-			// 模拟 UpdatePlan 成功更新计划，并更新 mockPlan 的名称
-			UpdatePlanFunc: func(plan *models.Plan) error {
-				assert.Equal(t, planID, plan.ID)
-				assert.Equal(t, updatedName, plan.Name)
-				mockPlan.Name = plan.Name // 模拟更新操作
-				return nil
-			},
-			// 模拟 GetPlanByID 返回更新后的计划
-			GetPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				assert.Equal(t, planID, id)
-				return mockPlan, nil // 返回已更新的 mockPlan
-			},
-		}
-		// 设置 Gin 路由器，并注入模拟仓库
-		router := setupTestRouter(mockRepo)
-
-		// 准备更新请求体
-		reqBody := UpdatePlanRequest{
-			Name:          updatedName,
-			Description:   "Updated Description",
-			ExecutionType: models.PlanExecutionTypeAutomatic,
-			ContentType:   models.PlanContentTypeTasks,
-		}
-		bodyBytes, _ := json.Marshal(reqBody)
-
-		// 创建 HTTP PUT 请求
-		req, _ := http.NewRequest(http.MethodPut, "/plans/"+strconv.Itoa(int(planID)), bytes.NewBuffer(bodyBytes))
-		req.Header.Set("Content-Type", "application/json")
-		w := httptest.NewRecorder()
-
-		// Act (执行阶段)
-		// 发送 HTTP 请求到路由器
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		// 验证 HTTP 状态码
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		// 解析响应体
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		// 验证业务响应码、消息和返回数据
-		assert.Equal(t, controller.CodeSuccess, resp.Code)
-		assert.Equal(t, "计划更新成功", resp.Message)
-
-		dataMap, ok := resp.Data.(map[string]interface{})
-		assert.True(t, ok)
-		assert.Equal(t, float64(planID), dataMap["id"])
-		assert.Equal(t, updatedName, dataMap["name"])
-	})
-
-	t.Run("失败-无效的ID格式", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库为空，因为预期不会调用仓库方法
-		mockRepo := &MockPlanRepository{}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		// 创建带有无效ID格式的 HTTP PUT 请求
-		req, _ := http.NewRequest(http.MethodPut, "/plans/abc", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeBadRequest, resp.Code)
-		assert.Equal(t, "无效的计划ID格式", resp.Message)
-	})
-
-	t.Run("失败-请求体绑定失败", func(t *testing.T) {
-		// Arrange (准备阶段)
-		planID := uint(1)
-		// 模拟仓库为空，因为预期不会调用仓库方法（请求体绑定失败发生在控制器内部）
-		mockRepo := &MockPlanRepository{}
-		router := setupTestRouter(mockRepo)
-
-		// 准备一个无效的 JSON 请求体，例如 execution_type 类型错误
-		reqBody := `{\"name\": \"Updated Plan Name\",}`
-		req, _ := http.NewRequest(http.MethodPut, "/plans/"+strconv.Itoa(int(planID)), bytes.NewBufferString(reqBody))
-		req.Header.Set("Content-Type", "application/json")
-		w := httptest.NewRecorder()
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeBadRequest, resp.Code)
-		assert.Contains(t, resp.Message, "无效的请求体")
-	})
-
-	t.Run("失败-计划不存在", func(t *testing.T) {
-		// Arrange (准备阶段)
-		planID := uint(999)
-		// 模拟仓库行为：GetBasicPlanByID 返回记录未找到错误
-		mockRepo := &MockPlanRepository{
-			GetBasicPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				assert.Equal(t, planID, id)
-				return nil, gorm.ErrRecordNotFound
-			},
-		}
-		router := setupTestRouter(mockRepo)
-
-		// 准备有效的请求体
-		reqBody := UpdatePlanRequest{
-			Name:          "Updated Plan Name",
-			Description:   "Updated Description",
-			ExecutionType: models.PlanExecutionTypeAutomatic,
-			ContentType:   models.PlanContentTypeTasks,
-		}
-		bodyBytes, _ := json.Marshal(reqBody)
-
-		// 创建 HTTP PUT 请求
-		req, _ := http.NewRequest(http.MethodPut, "/plans/"+strconv.Itoa(int(planID)), bytes.NewBuffer(bodyBytes))
-		req.Header.Set("Content-Type", "application/json")
-		w := httptest.NewRecorder()
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeNotFound, resp.Code)
-		assert.Equal(t, "计划不存在", resp.Message)
-	})
-
-	t.Run("失败-计划数据校验失败", func(t *testing.T) {
-		// Arrange (准备阶段)
-		planID := uint(1)
-		// 模拟一个已存在的计划
-		mockPlan := &models.Plan{
-			Model:       gorm.Model{ID: planID},
-			Name:        "Original Plan",
-			Description: "Original Description",
-			ContentType: models.PlanContentTypeTasks,
-		}
-		// 配置模拟仓库行为：GetBasicPlanByID 成功返回现有计划
-		mockRepo := &MockPlanRepository{
-			GetBasicPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				return mockPlan, nil
-			},
-		}
-		router := setupTestRouter(mockRepo)
-
-		// 准备一个会导致 PlanFromUpdateRequest 校验失败的请求体。
-		// 这里通过提供重复的 ExecutionOrder 来触发 ValidateExecutionOrder 错误。
-		reqBody := UpdatePlanRequest{
-			Name:          "Invalid Plan",
-			ExecutionType: models.PlanExecutionTypeAutomatic,
-			ContentType:   models.PlanContentTypeTasks, // 设置为任务类型
-			Tasks: []TaskRequest{
-				{Name: "Task 1", ExecutionOrder: 1, Type: models.TaskTypeWaiting},
-				{Name: "Task 2", ExecutionOrder: 1, Type: models.TaskTypeWaiting}, // 重复的执行顺序
-			},
-		}
-		bodyBytes, _ := json.Marshal(reqBody)
-
-		// 创建 HTTP PUT 请求
-		req, _ := http.NewRequest(http.MethodPut, "/plans/"+strconv.Itoa(int(planID)), bytes.NewBuffer(bodyBytes))
-		req.Header.Set("Content-Type", "application/json")
-		w := httptest.NewRecorder()
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeBadRequest, resp.Code)
-		assert.Contains(t, resp.Message, "计划数据校验失败")
-	})
-
-	t.Run("失败-仓库层更新失败", func(t *testing.T) {
-		// Arrange (准备阶段)
-		planID := uint(1)
-		// 模拟一个已存在的计划
-		mockPlan := &models.Plan{
-			Model:       gorm.Model{ID: planID},
-			Name:        "Original Plan",
-			Description: "Original Description",
-			ContentType: models.PlanContentTypeTasks,
-		}
-		updateErr := errors.New("failed to update in repository")
-		// 配置模拟仓库行为
-		mockRepo := &MockPlanRepository{
-			// 模拟 GetBasicPlanByID 成功返回现有计划
-			GetBasicPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				return mockPlan, nil
-			},
-			// 模拟 UpdatePlan 返回更新失败错误
-			UpdatePlanFunc: func(plan *models.Plan) error {
-				return updateErr // 模拟更新失败
-			},
-		}
-		router := setupTestRouter(mockRepo)
-
-		// 准备有效的请求体
-		reqBody := UpdatePlanRequest{
-			Name:          "Updated Plan Name",
-			Description:   "Updated Description",
-			ExecutionType: models.PlanExecutionTypeAutomatic,
-			ContentType:   models.PlanContentTypeTasks,
-		}
-		bodyBytes, _ := json.Marshal(reqBody)
-
-		// 创建 HTTP PUT 请求
-		req, _ := http.NewRequest(http.MethodPut, "/plans/"+strconv.Itoa(int(planID)), bytes.NewBuffer(bodyBytes))
-		req.Header.Set("Content-Type", "application/json")
-		w := httptest.NewRecorder()
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeBadRequest, resp.Code)
-		assert.Equal(t, "更新计划失败: "+updateErr.Error(), resp.Message)
-	})
-
-	t.Run("失败-获取更新后计划失败", func(t *testing.T) {
-		// Arrange (准备阶段)
-		planID := uint(1)
-		// 模拟一个已存在的计划
-		mockPlan := &models.Plan{
-			Model:       gorm.Model{ID: planID},
-			Name:        "Original Plan",
-			Description: "Original Description",
-			ContentType: models.PlanContentTypeTasks,
-		}
-		getUpdatedErr := errors.New("failed to get updated plan from repository")
-		// 配置模拟仓库行为
-		mockRepo := &MockPlanRepository{
-			// 模拟 GetBasicPlanByID 成功返回现有计划
-			GetBasicPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				return mockPlan, nil
-			},
-			// 模拟 UpdatePlan 成功
-			UpdatePlanFunc: func(plan *models.Plan) error {
-				return nil // 模拟成功更新
-			},
-			// 模拟 GetPlanByID 返回获取失败错误
-			GetPlanByIDFunc: func(id uint) (*models.Plan, error) {
-				return nil, getUpdatedErr // 模拟获取更新后计划失败
-			},
-		}
-		router := setupTestRouter(mockRepo)
-
-		// 准备有效的请求体
-		reqBody := UpdatePlanRequest{
-			Name:          "Updated Plan Name",
-			Description:   "Updated Description",
-			ExecutionType: models.PlanExecutionTypeAutomatic,
-			ContentType:   models.PlanContentTypeTasks,
-		}
-		bodyBytes, _ := json.Marshal(reqBody)
-
-		// 创建 HTTP PUT 请求
-		req, _ := http.NewRequest(http.MethodPut, "/plans/"+strconv.Itoa(int(planID)), bytes.NewBuffer(bodyBytes))
-		req.Header.Set("Content-Type", "application/json")
-		w := httptest.NewRecorder()
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeInternalError, resp.Code)
-		assert.Equal(t, "获取更新后计划详情时发生内部错误", resp.Message)
-	})
-}
-
-// TestController_DeletePlan 是 DeletePlan 的单元测试
-func TestController_DeletePlan(t *testing.T) {
-	t.Run("成功-删除计划", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库行为：DeletePlan 成功
-		mockRepo := &MockPlanRepository{
-			DeletePlanFunc: func(id uint) error {
-				assert.Equal(t, uint(1), id)
-				return nil // 模拟成功删除
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodDelete, "/plans/1", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeSuccess, resp.Code)
-		assert.Equal(t, "计划删除成功", resp.Message)
-		assert.Nil(t, resp.Data)
-	})
-
-	t.Run("失败-计划不存在", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库行为：DeletePlan 返回记录未找到错误
-		mockRepo := &MockPlanRepository{
-			DeletePlanFunc: func(id uint) error {
-				return gorm.ErrRecordNotFound // 模拟未找到记录
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodDelete, "/plans/999", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeInternalError, resp.Code)
-		assert.Equal(t, "删除计划时发生内部错误", resp.Message)
-	})
-
-	t.Run("失败-无效的ID格式", func(t *testing.T) {
-		// Arrange (准备阶段)
-		// 模拟仓库为空，因为预期不会调用仓库方法
-		mockRepo := &MockPlanRepository{}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		// 创建带有无效ID格式的 HTTP DELETE 请求
-		req, _ := http.NewRequest(http.MethodDelete, "/plans/abc", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeBadRequest, resp.Code)
-		assert.Equal(t, "无效的计划ID格式", resp.Message)
-	})
-
-	t.Run("失败-仓库层内部错误", func(t *testing.T) {
-		// Arrange (准备阶段)
-		internalErr := errors.New("something went wrong")
-		// 模拟仓库行为：DeletePlan 返回内部错误
-		mockRepo := &MockPlanRepository{
-
-			DeletePlanFunc: func(id uint) error {
-				return internalErr // 模拟内部错误
-			},
-		}
-		router := setupTestRouter(mockRepo)
-		w := httptest.NewRecorder()
-		req, _ := http.NewRequest(http.MethodDelete, "/plans/1", nil)
-
-		// Act (执行阶段)
-		router.ServeHTTP(w, req)
-
-		// Assert (断言阶段)
-		assert.Equal(t, http.StatusOK, w.Code)
-
-		var resp controller.Response
-		err := json.Unmarshal(w.Body.Bytes(), &resp)
-		assert.NoError(t, err)
-
-		assert.Equal(t, controller.CodeInternalError, resp.Code)
-		assert.Equal(t, "删除计划时发生内部错误", resp.Message)
-	})
-}

internal/app/controller/response.go

@@ -4,7 +4,7 @@ import (
 	"net/http"
 
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"github.com/gin-gonic/gin"
+	"github.com/labstack/echo/v4"
 )
 
 // --- 业务状态码 ---
@@ -18,6 +18,7 @@ const (
 	// 客户端错误状态码 (4000-4999)
 	CodeBadRequest   ResponseCode = 4000 // 请求参数错误
 	CodeUnauthorized ResponseCode = 4001 // 未授权
+	CodeForbidden    ResponseCode = 4003 // 禁止访问
 	CodeNotFound     ResponseCode = 4004 // 资源未找到
 	CodeConflict     ResponseCode = 4009 // 资源冲突
 
@@ -30,14 +31,15 @@ const (
 
 // Response 定义统一的API响应结构体
 type Response struct {
-	Code    ResponseCode `json:"code"`    // 业务状态码
-	Message string       `json:"message"` // 提示信息
-	Data    interface{}  `json:"data"`    // 业务数据
+	Code    ResponseCode `json:"code"`           // 业务状态码
+	Message string       `json:"message"`        // 提示信息
+	Data    interface{}  `json:"data,omitempty"` // 业务数据, omitempty表示如果为空则不序列化
 }
 
 // SendResponse 发送统一格式的JSON响应 (基础函数，不带审计)
-func SendResponse(ctx *gin.Context, code ResponseCode, message string, data interface{}) {
-	ctx.JSON(http.StatusOK, Response{
+// 所有的业务API都应该使用这个函数返回，以确保HTTP状态码始终为200 OK。
+func SendResponse(c echo.Context, code ResponseCode, message string, data interface{}) error {
+	return c.JSON(http.StatusOK, Response{
 		Code:    code,
 		Message: message,
 		Data:    data,
@@ -45,51 +47,63 @@ func SendResponse(ctx *gin.Context, code ResponseCode, message string, data inte
 }
 
 // SendErrorResponse 发送统一格式的错误响应 (基础函数，不带审计)
-func SendErrorResponse(ctx *gin.Context, code ResponseCode, message string) {
-	SendResponse(ctx, code, message, nil)
+// HTTP状态码为200 OK，通过业务码表示错误。
+func SendErrorResponse(c echo.Context, code ResponseCode, message string) error {
+	return SendResponse(c, code, message, nil)
+}
+
+// SendErrorWithStatus 发送带有指定HTTP状态码的错误响应。
+// 这个函数主要用于中间件或特殊场景（如认证失败），在这些场景下需要返回非200的HTTP状态码。
+func SendErrorWithStatus(c echo.Context, httpStatus int, code ResponseCode, message string) error {
+	return c.JSON(httpStatus, Response{
+		Code:    code,
+		Message: message,
+	})
 }
 
 // --- 带审计功能的响应函数 ---
 
-// setAuditDetails 是一个内部辅助函数，用于在 gin.Context 中设置业务相关的审计信息。
-func setAuditDetails(c *gin.Context, actionType, description string, targetResource interface{}) {
+// setAuditDetails 是一个内部辅助函数，用于在 echo.Context 中统一设置所有业务相关的审计信息。
+func setAuditDetails(c echo.Context, actionType, description string, targetResource interface{}, status models.AuditStatus, resultDetails string) {
 	// 只有当 actionType 不为空时，才设置审计信息，这作为触发审计的标志
 	if actionType != "" {
 		c.Set(models.ContextAuditActionType.String(), actionType)
 		c.Set(models.ContextAuditDescription.String(), description)
 		c.Set(models.ContextAuditTargetResource.String(), targetResource)
+		c.Set(models.ContextAuditStatus.String(), status)
+		c.Set(models.ContextAuditResultDetails.String(), resultDetails)
 	}
 }
 
 // SendSuccessWithAudit 发送成功的响应，并设置审计日志所需的信息。
 // 这是控制器中用于记录成功操作并返回响应的首选函数。
 func SendSuccessWithAudit(
-	ctx *gin.Context, // Gin上下文，用于处理HTTP请求和响应
+	c echo.Context, // Echo上下文，用于处理HTTP请求和响应
 	code ResponseCode, // 业务状态码，表示操作结果
 	message string, // 提示信息，向用户展示操作结果的文本描述
 	data interface{}, // 业务数据，操作成功后返回的具体数据
 	actionType string, // 审计操作类型，例如"创建用户", "更新配置"
 	description string, // 审计描述，对操作的详细说明
 	targetResource interface{}, // 审计目标资源，被操作的资源对象或其标识
-) {
+) error {
 	// 1. 设置审计信息
-	setAuditDetails(ctx, actionType, description, targetResource)
+	setAuditDetails(c, actionType, description, targetResource, models.AuditStatusSuccess, "")
 	// 2. 发送响应
-	SendResponse(ctx, code, message, data)
+	return SendResponse(c, code, message, data)
 }
 
 // SendErrorWithAudit 发送失败的响应，并设置审计日志所需的信息。
 // 这是控制器中用于记录失败操作并返回响应的首选函数。
 func SendErrorWithAudit(
-	ctx *gin.Context, // Gin上下文，用于处理HTTP请求和响应
+	c echo.Context, // Echo上下文，用于处理HTTP请求和响应
 	code ResponseCode, // 业务状态码，表示操作结果
 	message string, // 提示信息，向用户展示操作结果的文本描述
 	actionType string, // 审计操作类型，例如"登录失败", "删除失败"
 	description string, // 审计描述，对操作的详细说明
 	targetResource interface{}, // 审计目标资源，被操作的资源对象或其标识
-) {
+) error {
 	// 1. 设置审计信息
-	setAuditDetails(ctx, actionType, description, targetResource)
+	setAuditDetails(c, actionType, description, targetResource, models.AuditStatusFailed, message)
 	// 2. 发送响应
-	SendErrorResponse(ctx, code, message)
+	return SendErrorResponse(c, code, message)
 }

internal/app/controller/user/user_controller.go

@@ -2,33 +2,28 @@ package user
 
 import (
 	"strconv"
-	"time"
 
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/token"
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
-	"github.com/gin-gonic/gin"
-	"gorm.io/gorm"
+	"github.com/labstack/echo/v4"
 )
 
 // Controller 用户控制器
 type Controller struct {
-	userRepo     repository.UserRepository
-	auditRepo    repository.UserActionLogRepository
-	logger       *logs.Logger
-	tokenService token.TokenService // 注入 token 服务
+	userService service.UserService
+	logger      *logs.Logger
 }
 
 // NewController 创建用户控制器实例
-func NewController(userRepo repository.UserRepository, auditRepo repository.UserActionLogRepository, logger *logs.Logger, tokenService token.TokenService) *Controller {
+func NewController(
+	userService service.UserService,
+	logger *logs.Logger,
+) *Controller {
 	return &Controller{
-		userRepo:     userRepo,
-		auditRepo:    auditRepo,
-		logger:       logger,
-		tokenService: tokenService,
+		userService: userService,
+		logger:      logger,
 	}
 }
 
@@ -43,38 +38,20 @@ func NewController(userRepo repository.UserRepository, auditRepo repository.User
 // @Param        user body dto.CreateUserRequest true "用户信息"
 // @Success      200 {object} controller.Response{data=dto.CreateUserResponse} "业务码为201代表创建成功"
 // @Router       /api/v1/users [post]
-func (c *Controller) CreateUser(ctx *gin.Context) {
+func (c *Controller) CreateUser(ctx echo.Context) error {
 	var req dto.CreateUserRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
+	if err := ctx.Bind(&req); err != nil {
 		c.logger.Errorf("创建用户: 参数绑定失败: %v", err)
-		controller.SendErrorResponse(ctx, controller.CodeBadRequest, err.Error())
-		return
+		return controller.SendErrorResponse(ctx, controller.CodeBadRequest, err.Error())
 	}
 
-	user := &models.User{
-		Username: req.Username,
-		Password: req.Password, // 密码会在 BeforeSave 钩子中哈希
+	resp, err := c.userService.CreateUser(&req)
+	if err != nil {
+		c.logger.Errorf("创建用户: 服务层调用失败: %v", err)
+		return controller.SendErrorResponse(ctx, controller.CodeInternalError, err.Error())
 	}
 
-	if err := c.userRepo.Create(user); err != nil {
-		c.logger.Errorf("创建用户: 创建用户失败: %v", err)
-
-		// 尝试查询用户，以判断是否是用户名重复导致的错误
-		_, findErr := c.userRepo.FindByUsername(req.Username)
-		if findErr == nil { // 如果能找到用户，说明是用户名重复
-			controller.SendErrorResponse(ctx, controller.CodeConflict, "用户名已存在")
-			return
-		}
-
-		// 其他创建失败的情况
-		controller.SendErrorResponse(ctx, controller.CodeInternalError, "创建用户失败")
-		return
-	}
-
-	controller.SendResponse(ctx, controller.CodeCreated, "用户创建成功", dto.CreateUserResponse{
-		Username: user.Username,
-		ID:       user.ID,
-	})
+	return controller.SendResponse(ctx, controller.CodeCreated, "用户创建成功", resp)
 }
 
 // Login godoc
@@ -86,115 +63,58 @@ func (c *Controller) CreateUser(ctx *gin.Context) {
 // @Param        credentials body dto.LoginRequest true "登录凭证"
 // @Success      200 {object} controller.Response{data=dto.LoginResponse} "业务码为200代表登录成功"
 // @Router       /api/v1/users/login [post]
-func (c *Controller) Login(ctx *gin.Context) {
+func (c *Controller) Login(ctx echo.Context) error {
 	var req dto.LoginRequest
-	if err := ctx.ShouldBindJSON(&req); err != nil {
+	if err := ctx.Bind(&req); err != nil {
 		c.logger.Errorf("登录: 参数绑定失败: %v", err)
-		controller.SendErrorResponse(ctx, controller.CodeBadRequest, err.Error())
-		return
+		return controller.SendErrorResponse(ctx, controller.CodeBadRequest, err.Error())
 	}
 
-	// 使用新的方法，通过唯一标识符（用户名、邮箱等）查找用户
-	user, err := c.userRepo.FindUserForLogin(req.Identifier)
+	resp, err := c.userService.Login(&req)
 	if err != nil {
-		if err == gorm.ErrRecordNotFound {
-			controller.SendErrorResponse(ctx, controller.CodeUnauthorized, "登录凭证不正确")
-			return
-		}
-		c.logger.Errorf("登录: 查询用户失败: %v", err)
-		controller.SendErrorResponse(ctx, controller.CodeInternalError, "登录失败")
-		return
+		c.logger.Errorf("登录: 服务层调用失败: %v", err)
+		return controller.SendErrorResponse(ctx, controller.CodeUnauthorized, err.Error())
 	}
 
-	if !user.CheckPassword(req.Password) {
-		controller.SendErrorResponse(ctx, controller.CodeUnauthorized, "登录凭证不正确")
-		return
-	}
-
-	// 登录成功，生成 JWT token
-	tokenString, err := c.tokenService.GenerateToken(user.ID)
-	if err != nil {
-		c.logger.Errorf("登录: 生成令牌失败: %v", err)
-		controller.SendErrorResponse(ctx, controller.CodeInternalError, "登录失败，无法生成认证信息")
-		return
-	}
-
-	controller.SendResponse(ctx, controller.CodeSuccess, "登录成功", dto.LoginResponse{
-		Username: user.Username,
-		ID:       user.ID,
-		Token:    tokenString,
-	})
+	return controller.SendResponse(ctx, controller.CodeSuccess, "登录成功", resp)
 }
 
-// ListUserHistory godoc
-// @Summary      获取指定用户的操作历史
-// @Description  根据用户ID，分页获取该用户的操作审计日志。
+// SendTestNotification godoc
+// @Summary      发送测试通知
+// @Description  为指定用户发送一条特定渠道的测试消息，以验证其配置是否正确。
 // @Tags         用户管理
+// @Security     BearerAuth
+// @Accept       json
 // @Produce      json
-// @Param        id   path      int    true  "用户ID"
-// @Param        page query     int    false "页码" default(1)
-// @Param        page_size query int    false "每页大小" default(10)
-// @Param        action_type query string false "按操作类型过滤"
-// @Success      200  {object}  controller.Response{data=dto.ListHistoryResponse} "业务码为200代表成功获取"
-// @Router       /api/v1/users/{id}/history [get]
-func (c *Controller) ListUserHistory(ctx *gin.Context) {
-	const actionType = "获取用户操作历史"
+// @Param        id   path      int  true  "用户ID"
+// @Param        body body      dto.SendTestNotificationRequest  true  "请求体"
+// @Success      200  {object}  controller.Response{data=string}  "成功响应"
+// @Router       /api/v1/users/{id}/notifications/test [post]
+func (c *Controller) SendTestNotification(ctx echo.Context) error {
+	const actionType = "发送测试通知"
 
-	// 1. 解析路径中的用户ID
-	userIDStr := ctx.Param("id")
-	userID, err := strconv.ParseUint(userIDStr, 10, 64)
+	// 1. 从 URL 中获取用户 ID
+	userID, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 	if err != nil {
-		c.logger.Errorf("%s: 无效的用户ID格式: %v, ID: %s", actionType, err, userIDStr)
-		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的用户ID格式", actionType, "无效的用户ID格式", userIDStr)
-		return
+		c.logger.Errorf("%s: 无效的用户ID格式: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的用户ID格式", actionType, "无效的用户ID格式", ctx.Param("id"))
 	}
 
-	// 2. 解析分页和过滤参数
-	page, _ := strconv.Atoi(ctx.DefaultQuery("page", "1"))
-	pageSize, _ := strconv.Atoi(ctx.DefaultQuery("page_size", "10"))
-	actionTypeFilter := ctx.Query("action_type")
-
-	// 确保分页参数有效
-	if page <= 0 {
-		page = 1
-	}
-	if pageSize <= 0 || pageSize > 100 {
-		pageSize = 10
+	// 2. 从请求体 (JSON Body) 中获取要测试的通知类型
+	var req dto.SendTestNotificationRequest
+	if err := ctx.Bind(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "请求体格式错误或缺少 'type' 字段: "+err.Error(), actionType, "请求体绑定失败", req)
 	}
 
-	// 3. 调用审计仓库层获取历史数据
-	id := uint(userID)
-	findOptions := repository.FindAuditLogOptions{
-		UserID:     &id,
-		ActionType: actionTypeFilter,
-		Page:       page,
-		PageSize:   pageSize,
-	}
-	logs, total, err := c.auditRepo.List(findOptions)
+	// 3. 调用服务层
+	err = c.userService.SendTestNotification(uint(userID), &req)
 	if err != nil {
-		c.logger.Errorf("%s: 查询历史记录失败: %v, Options: %+v", actionType, err, findOptions)
-		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "查询历史记录失败", actionType, "查询历史记录失败", findOptions)
-		return
+		c.logger.Errorf("%s: 服务层调用失败: %v", actionType, err)
+		return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "发送测试消息失败: "+err.Error(), actionType, "服务层调用失败", map[string]interface{}{"userID": userID, "type": req.Type})
 	}
 
-	// 4. 将数据库模型转换为响应 DTO
-	historyResponses := make([]dto.HistoryResponse, 0, len(logs))
-	for _, log := range logs {
-		historyResponses = append(historyResponses, dto.HistoryResponse{
-			UserID:         log.UserID,
-			Username:       log.Username,
-			ActionType:     log.ActionType,
-			Description:    log.Description,
-			TargetResource: log.TargetResource,
-			Time:           log.Time.Format(time.RFC3339),
-		})
-	}
-
-	// 5. 发送成功响应
-	resp := dto.ListHistoryResponse{
-		History: historyResponses,
-		Total:   total,
-	}
-	c.logger.Infof("%s: 成功获取用户 %d 的操作历史, 数量: %d", actionType, userID, len(historyResponses))
-	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取用户操作历史成功", resp, actionType, "获取用户操作历史成功", resp)
+	// 4. 返回成功响应
+	c.logger.Infof("%s: 成功为用户 %d 发送类型为 %s 的测试消息", actionType, userID, req.Type)
+	return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "测试消息已发送，请检查您的接收端。", nil, actionType, "测试消息发送成功", map[string]interface{}{"userID": userID, "type": req.Type})
 }

internal/app/controller/user/user_controller_test.go

@@ -1,450 +0,0 @@
-package user_test
-
-import (
-	"bytes"
-	"encoding/json"
-	"errors"
-	"io"
-	"net/http"
-	"net/http/httptest"
-	"testing"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller/user"
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/service/token"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"github.com/gin-gonic/gin"
-	"github.com/stretchr/testify/assert"
-	"github.com/stretchr/testify/mock"
-	"gorm.io/gorm"
-)
-
-// MockUserRepository 是 UserRepository 接口的模拟实现
-type MockUserRepository struct {
-	mock.Mock
-}
-
-// CreateTx 模拟 UserRepository 的 CreateTx 方法
-func (m *MockUserRepository) Create(user *models.User) error {
-	args := m.Called(user)
-	return args.Error(0)
-}
-
-// FindByUsername 模拟 UserRepository 的 FindByUsername 方法
-// 返回类型改回 *models.User
-func (m *MockUserRepository) FindByUsername(username string) (*models.User, error) {
-	args := m.Called(username)
-	if args.Get(0) == nil {
-		return nil, args.Error(1)
-	}
-	return args.Get(0).(*models.User), args.Error(1)
-}
-
-// FindByID 模拟 UserRepository 的 FindByID 方法
-func (m *MockUserRepository) FindByID(id uint) (*models.User, error) {
-	args := m.Called(id)
-	if args.Get(0) == nil {
-		return nil, args.Error(1)
-	}
-	return args.Get(0).(*models.User), args.Error(1)
-}
-
-// MockTokenService 是 token.TokenService 接口的模拟实现
-type MockTokenService struct {
-	mock.Mock
-}
-
-// GenerateToken 模拟 TokenService 的 GenerateToken 方法
-func (m *MockTokenService) GenerateToken(userID uint) (string, error) {
-	args := m.Called(userID)
-	return args.String(0), args.Error(1)
-}
-
-// ParseToken 模拟 TokenService 的 ParseToken 方法
-func (m *MockTokenService) ParseToken(tokenString string) (*token.Claims, error) {
-	args := m.Called(tokenString)
-	if args.Get(0) == nil {
-		return nil, args.Error(1)
-	}
-	return args.Get(0).(*token.Claims), args.Error(1)
-}
-
-// TestCreateUser 测试 CreateUser 方法
-func TestCreateUser(t *testing.T) {
-	gin.SetMode(gin.TestMode) // 设置 Gin 为测试模式
-
-	// 创建一个不输出日志的真实 logs.Logger 实例
-	silentLogger := logs.NewSilentLogger()
-
-	tests := []struct {
-		name             string
-		requestBody      user.CreateUserRequest
-		mockRepoSetup    func(*MockUserRepository)
-		expectedResponse map[string]interface{}
-	}{
-		{
-			name: "成功创建用户",
-			requestBody: user.CreateUserRequest{
-				Username: "testuser",
-				Password: "password123",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				// 模拟 CreateTx 成功
-				m.On("CreateTx", mock.AnythingOfType("*models.User")).Return(nil).Run(func(args mock.Arguments) {
-					// 模拟数据库自动填充 ID
-					userArg := args.Get(0).(*models.User)
-					userArg.ID = 1 // 设置一个非零的 ID
-				}).Once()
-				// 在成功创建用户的路径下，FindByUsername 不会被调用，因此这里不需要设置其期望
-			},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeCreated), // 修改这里：使用自定义状态码
-				"message": "用户创建成功",
-				"data": map[string]interface{}{
-					"username": "testuser",
-					// "id":       mock.Anything, // 移除这里的 id，在断言时单独检查
-				},
-			},
-		},
-		{
-			name: "请求参数绑定失败_密码过短",
-			requestBody: user.CreateUserRequest{
-				Username: "testuser2",
-				Password: "123", // 密码少于6位
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				// 不会调用 CreateTx 或 FindByUsername
-			},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeBadRequest),
-				"message": "Key: 'CreateUserRequest.Password' Error:Field validation for 'Password' failed on the 'min' tag",
-				"data":    nil,
-			},
-		},
-		{
-			name: "请求参数绑定失败_缺少用户名",
-			requestBody: user.CreateUserRequest{
-				Password: "password123",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				// 不会调用 CreateTx 或 FindByUsername
-			},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeBadRequest),
-				"message": "Key: 'CreateUserRequest.Username' Error:Field validation for 'Username' failed on the 'required' tag",
-				"data":    nil,
-			},
-		},
-		{
-			name: "用户名已存在",
-			requestBody: user.CreateUserRequest{
-				Username: "existinguser",
-				Password: "password123",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				// 模拟 CreateTx 失败，因为用户名已存在
-				m.On("CreateTx", mock.AnythingOfType("*models.User")).Return(errors.New("duplicate entry")).Once()
-				// 模拟 FindByUsername 找到用户，确认是用户名重复
-				m.On("FindByUsername", "existinguser").Return(&models.User{Username: "existinguser"}, nil).Once()
-			},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeConflict),
-				"message": "用户名已存在",
-				"data":    nil,
-			},
-		},
-		{
-			name: "创建用户失败_通用数据库错误",
-			requestBody: user.CreateUserRequest{
-				Username: "db_error_user",
-				Password: "password123",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				// 模拟 CreateTx 失败，通用数据库错误
-				m.On("CreateTx", mock.AnythingOfType("*models.User")).Return(errors.New("database error")).Once()
-				// 模拟 FindByUsername 找不到用户，确认不是用户名重复
-				m.On("FindByUsername", "db_error_user").Return(nil, gorm.ErrRecordNotFound).Once()
-			},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeInternalError),
-				"message": "创建用户失败",
-				"data":    nil,
-			},
-		},
-	}
-
-	for _, tt := range tests {
-		t.Run(tt.name, func(t *testing.T) {
-			// 初始化 Gin 上下文和记录器
-			w := httptest.NewRecorder()
-			ctx, _ := gin.CreateTestContext(w)
-			ctx.Request = httptest.NewRequest(http.MethodPost, "/users", nil) // URL 路径不重要，因为我们不测试路由
-
-			// 设置请求体
-			jsonBody, _ := json.Marshal(tt.requestBody)
-			ctx.Request.Body = io.NopCloser(bytes.NewBuffer(jsonBody))
-			ctx.Request.Header.Set("Content-Type", "application/json")
-
-			// 创建 Mock UserRepository
-			mockRepo := new(MockUserRepository)
-
-			// 设置 Mock UserRepository 行为
-			tt.mockRepoSetup(mockRepo)
-
-			// 创建控制器实例，使用静默日志器
-			userController := user.NewController(mockRepo, silentLogger, nil) // tokenService 在 CreateUser 中未使用，设为 nil
-
-			// 调用被测试的方法
-			userController.CreateUser(ctx)
-
-			// 解析响应体
-			var responseBody map[string]interface{}
-			err := json.Unmarshal(w.Body.Bytes(), &responseBody)
-			assert.NoError(t, err)
-
-			// 断言响应体中的 code 字段
-			assert.Equal(t, tt.expectedResponse["code"], responseBody["code"])
-
-			// 断言响应内容 (除了 code 字段)
-			if tt.expectedResponse["code"] == float64(controller.CodeCreated) {
-				// 确保 data 字段存在且是 map[string]interface{} 类型
-				data, ok := responseBody["data"].(map[string]interface{})
-				assert.True(t, ok, "响应体中的 data 字段应为 map[string]interface{}")
-				// 确保 id 字段存在且不为零
-				id, idOk := data["id"].(float64)
-				assert.True(t, idOk, "响应体中的 data.id 字段应为 float64 类型")
-				assert.NotEqual(t, float64(0), id, "响应体中的 data.id 不应为零")
-
-				// 移除 ID 字段以便进行通用断言
-				delete(responseBody["data"].(map[string]interface{}), "id")
-				// 移除 expectedResponse 中的 id 字段，因为我们已经单独验证了
-				if expectedData, ok := tt.expectedResponse["data"].(map[string]interface{}); ok {
-					delete(expectedData, "id")
-				}
-			}
-			// 移除 code 字段以便进行通用断言
-			delete(responseBody, "code")
-			delete(tt.expectedResponse, "code")
-			assert.Equal(t, tt.expectedResponse, responseBody)
-
-			// 验证 Mock 期望是否都已满足
-			mockRepo.AssertExpectations(t)
-		})
-	}
-}
-
-// TestLogin 测试 Login 方法
-func TestLogin(t *testing.T) {
-	// 设置release模式阻止废话日志
-	gin.SetMode(gin.ReleaseMode)
-
-	// 创建一个不输出日志的真实 logs.Logger 实例
-	silentLogger := logs.NewSilentLogger()
-
-	tests := []struct {
-		name                  string
-		requestBody           user.LoginRequest
-		mockRepoSetup         func(*MockUserRepository)
-		mockTokenServiceSetup func(*MockTokenService)
-		expectedResponse      map[string]interface{}
-	}{
-		{
-			name: "成功登录",
-			requestBody: user.LoginRequest{
-				Username: "loginuser",
-				Password: "correctpassword",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				mockUser := &models.User{
-					Model:    gorm.Model{ID: 1},
-					Username: "loginuser",
-					Password: "correctpassword", // 明文密码，BeforeCreate 会哈希它
-				}
-				// 调用 BeforeCreate 钩子来哈希密码
-				_ = mockUser.BeforeCreate(nil)
-				m.On("FindByUsername", "loginuser").Return(mockUser, nil).Once()
-			},
-			mockTokenServiceSetup: func(m *MockTokenService) {
-				m.On("GenerateToken", uint(1)).Return("mocked_token", nil).Once()
-			},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeSuccess),
-				"message": "登录成功",
-				"data": map[string]interface{}{
-					"username": "loginuser",
-					"id":       float64(1),
-					"token":    "mocked_token",
-				},
-			},
-		},
-		{
-			name: "请求参数绑定失败_缺少用户名",
-			requestBody: user.LoginRequest{
-				Username: "", // 缺少用户名
-				Password: "password",
-			},
-			mockRepoSetup:         func(m *MockUserRepository) {},
-			mockTokenServiceSetup: func(m *MockTokenService) {},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeBadRequest),
-				"message": "Key: 'LoginRequest.Username' Error:Field validation for 'Username' failed on the 'required' tag",
-				"data":    nil,
-			},
-		},
-		{
-			name: "请求参数绑定失败_缺少密码",
-			requestBody: user.LoginRequest{
-				Username: "testuser",
-				Password: "", // 缺少密码
-			},
-			mockRepoSetup:         func(m *MockUserRepository) {},
-			mockTokenServiceSetup: func(m *MockTokenService) {},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeBadRequest),
-				"message": "Key: 'LoginRequest.Password' Error:Field validation for 'Password' failed on the 'required' tag",
-				"data":    nil,
-			},
-		},
-		{
-			name: "用户不存在",
-			requestBody: user.LoginRequest{
-				Username: "nonexistent",
-				Password: "anypassword",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				m.On("FindByUsername", "nonexistent").Return(nil, gorm.ErrRecordNotFound).Once()
-			},
-			mockTokenServiceSetup: func(m *MockTokenService) {},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeUnauthorized),
-				"message": "用户名或密码不正确",
-				"data":    nil,
-			},
-		},
-		{
-			name: "查询用户失败_通用数据库错误",
-			requestBody: user.LoginRequest{
-				Username: "dberroruser",
-				Password: "password",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				m.On("FindByUsername", "dberroruser").Return(nil, errors.New("database connection error")).Once()
-			},
-			mockTokenServiceSetup: func(m *MockTokenService) {}, expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeInternalError),
-				"message": "登录失败",
-				"data":    nil,
-			},
-		},
-		{
-			name: "密码不正确",
-			requestBody: user.LoginRequest{
-				Username: "loginuser",
-				Password: "wrongpassword",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				mockUser := &models.User{
-					Model:    gorm.Model{ID: 1},
-					Username: "loginuser",
-					Password: "correctpassword", // 明文密码，BeforeCreate 会哈希它
-				}
-				// 调用 BeforeCreate 钩子来哈希密码
-				_ = mockUser.BeforeCreate(nil)
-				m.On("FindByUsername", "loginuser").Return(mockUser, nil).Once()
-			},
-			mockTokenServiceSetup: func(m *MockTokenService) {},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeUnauthorized),
-				"message": "用户名或密码不正确",
-				"data":    nil,
-			},
-		},
-		{
-			name: "生成Token失败",
-			requestBody: user.LoginRequest{
-				Username: "loginuser",
-				Password: "correctpassword",
-			},
-			mockRepoSetup: func(m *MockUserRepository) {
-				mockUser := &models.User{
-					Model:    gorm.Model{ID: 1},
-					Username: "loginuser",
-					Password: "correctpassword", // 明文密码，BeforeCreate 会哈希它
-				}
-				// 调用 BeforeCreate 钩子来哈希密码
-				_ = mockUser.BeforeCreate(nil)
-				m.On("FindByUsername", "loginuser").Return(mockUser, nil).Once()
-			},
-			mockTokenServiceSetup: func(m *MockTokenService) {
-				m.On("GenerateToken", uint(1)).Return("", errors.New("jwt error")).Once()
-			},
-			expectedResponse: map[string]interface{}{
-				"code":    float64(controller.CodeInternalError),
-				"message": "登录失败，无法生成认证信息",
-				"data":    nil,
-			},
-		},
-	}
-
-	for _, tt := range tests {
-		t.Run(tt.name, func(t *testing.T) {
-			// 初始化 Gin 上下文和记录器
-			w := httptest.NewRecorder()
-			ctx, _ := gin.CreateTestContext(w)
-			ctx.Request = httptest.NewRequest(http.MethodPost, "/login", nil) // URL 路径不重要，因为我们不测试路由
-
-			// 设置请求体
-			jsonBody, _ := json.Marshal(tt.requestBody)
-			ctx.Request.Body = io.NopCloser(bytes.NewBuffer(jsonBody))
-			ctx.Request.Header.Set("Content-Type", "application/json")
-
-			// 创建 Mock
-			mockRepo := new(MockUserRepository)
-			mockTokenService := new(MockTokenService)
-
-			// 设置 Mock 行为
-			tt.mockRepoSetup(mockRepo)
-			tt.mockTokenServiceSetup(mockTokenService)
-
-			// 创建控制器实例
-			userController := user.NewController(mockRepo, silentLogger, mockTokenService)
-
-			// 调用被测试的方法
-			userController.Login(ctx)
-
-			// 解析响应体
-			var responseBody map[string]interface{}
-			err := json.Unmarshal(w.Body.Bytes(), &responseBody)
-			assert.NoError(t, err)
-
-			// 断言响应体中的 code 字段
-			assert.Equal(t, tt.expectedResponse["code"], responseBody["code"])
-
-			// 断言响应内容 (除了 code 字段)
-			if tt.expectedResponse["code"] == float64(controller.CodeSuccess) {
-				// 确保 data 字段存在且是 map[string]interface{} 类型
-				data, ok := responseBody["data"].(map[string]interface{})
-				assert.True(t, ok, "响应体中的 data 字段应为 map[string]interface{}")
-
-				// 验证 id 和 token 存在
-				assert.NotNil(t, data["id"])
-				assert.NotNil(t, data["token"])
-
-				// 移除 ID 和 Token 字段以便进行通用断言
-				delete(responseBody["data"].(map[string]interface{}), "id")
-				delete(tt.expectedResponse["data"].(map[string]interface{}), "id")
-				delete(responseBody["data"].(map[string]interface{}), "token")
-				delete(tt.expectedResponse["data"].(map[string]interface{}), "token")
-			}
-			// 移除 code 字段以便进行通用断言
-			delete(responseBody, "code")
-			delete(tt.expectedResponse, "code")
-			assert.Equal(t, tt.expectedResponse, responseBody)
-
-			// 验证 Mock 期望是否都已满足
-			mockRepo.AssertExpectations(t)
-			mockTokenService.AssertExpectations(t)
-		})
-	}
-}

internal/app/dto/device_dto.go

@@ -4,56 +4,62 @@ import "git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
 
 // CreateDeviceRequest 定义了创建设备时需要传入的参数
 type CreateDeviceRequest struct {
-	Name             string                 `json:"name" binding:"required"`
-	DeviceTemplateID uint                   `json:"device_template_id" binding:"required"`
-	AreaControllerID uint                   `json:"area_controller_id" binding:"required"`
-	Location         string                 `json:"location,omitempty"`
-	Properties       map[string]interface{} `json:"properties,omitempty"`
+	Name             string                 `json:"name" validate:"required"`
+	DeviceTemplateID uint                   `json:"device_template_id" validate:"required"`
+	AreaControllerID uint                   `json:"area_controller_id" validate:"required"`
+	Location         string                 `json:"location,omitempty" validate:"omitempty"`
+	Properties       map[string]interface{} `json:"properties,omitempty" validate:"omitempty"`
 }
 
 // UpdateDeviceRequest 定义了更新设备时需要传入的参数
 type UpdateDeviceRequest struct {
-	Name             string                 `json:"name" binding:"required"`
-	DeviceTemplateID uint                   `json:"device_template_id" binding:"required"`
-	AreaControllerID uint                   `json:"area_controller_id" binding:"required"`
-	Location         string                 `json:"location,omitempty"`
-	Properties       map[string]interface{} `json:"properties,omitempty"`
+	Name             string                 `json:"name" validate:"required"`
+	DeviceTemplateID uint                   `json:"device_template_id" validate:"required"`
+	AreaControllerID uint                   `json:"area_controller_id" validate:"required"`
+	Location         string                 `json:"location,omitempty" validate:"omitempty"`
+	Properties       map[string]interface{} `json:"properties,omitempty" validate:"omitempty"`
+}
+
+// ManualControlDeviceRequest 定义了手动控制设备时需要传入的参数
+type ManualControlDeviceRequest struct {
+	// Action 不传表示这是一个传感器, 会触发一次采集
+	Action *string `json:"action"`
 }
 
 // CreateAreaControllerRequest 定义了创建区域主控时需要传入的参数
 type CreateAreaControllerRequest struct {
-	Name       string                 `json:"name" binding:"required"`
-	NetworkID  string                 `json:"network_id" binding:"required"`
-	Location   string                 `json:"location,omitempty"`
-	Properties map[string]interface{} `json:"properties,omitempty"`
+	Name       string                 `json:"name" validate:"required"`
+	NetworkID  string                 `json:"network_id" validate:"required"`
+	Location   string                 `json:"location,omitempty" validate:"omitempty"`
+	Properties map[string]interface{} `json:"properties,omitempty" validate:"omitempty"`
 }
 
 // UpdateAreaControllerRequest 定义了更新区域主控时需要传入的参数
 type UpdateAreaControllerRequest struct {
-	Name       string                 `json:"name" binding:"required"`
-	NetworkID  string                 `json:"network_id" binding:"required"`
-	Location   string                 `json:"location,omitempty"`
-	Properties map[string]interface{} `json:"properties,omitempty"`
+	Name       string                 `json:"name" validate:"required"`
+	NetworkID  string                 `json:"network_id" validate:"required"`
+	Location   string                 `json:"location,omitempty" validate:"omitempty"`
+	Properties map[string]interface{} `json:"properties,omitempty" validate:"omitempty"`
 }
 
 // CreateDeviceTemplateRequest 定义了创建设备模板时需要传入的参数
 type CreateDeviceTemplateRequest struct {
-	Name         string                   `json:"name" binding:"required"`
-	Manufacturer string                   `json:"manufacturer,omitempty"`
-	Description  string                   `json:"description,omitempty"`
-	Category     models.DeviceCategory    `json:"category" binding:"required"`
-	Commands     map[string]interface{}   `json:"commands" binding:"required"`
-	Values       []models.ValueDescriptor `json:"values,omitempty"`
+	Name         string                   `json:"name" validate:"required"`
+	Manufacturer string                   `json:"manufacturer,omitempty" validate:"omitempty"`
+	Description  string                   `json:"description,omitempty" validate:"omitempty"`
+	Category     models.DeviceCategory    `json:"category" validate:"required"`
+	Commands     map[string]interface{}   `json:"commands" validate:"required"`
+	Values       []models.ValueDescriptor `json:"values,omitempty" validate:"omitempty,dive"`
 }
 
 // UpdateDeviceTemplateRequest 定义了更新设备模板时需要传入的参数
 type UpdateDeviceTemplateRequest struct {
-	Name         string                   `json:"name" binding:"required"`
-	Manufacturer string                   `json:"manufacturer,omitempty"`
-	Description  string                   `json:"description,omitempty"`
-	Category     models.DeviceCategory    `json:"category" binding:"required"`
-	Commands     map[string]interface{}   `json:"commands" binding:"required"`
-	Values       []models.ValueDescriptor `json:"values,omitempty"`
+	Name         string                   `json:"name" validate:"required"`
+	Manufacturer string                   `json:"manufacturer,omitempty" validate:"omitempty"`
+	Description  string                   `json:"description,omitempty" validate:"omitempty"`
+	Category     models.DeviceCategory    `json:"category" validate:"required"`
+	Commands     map[string]interface{}   `json:"commands" validate:"required"`
+	Values       []models.ValueDescriptor `json:"values,omitempty" validate:"omitempty,dive"`
 }
 
 // DeviceResponse 定义了返回给客户端的单个设备信息的结构

internal/app/dto/monitor_converter.go

@@ -0,0 +1,489 @@
+package dto
+
+import (
+	"encoding/json"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+)
+
+// NewListSensorDataResponse 从模型数据创建列表响应 DTO
+func NewListSensorDataResponse(data []models.SensorData, total int64, page, pageSize int) *ListSensorDataResponse {
+	dtos := make([]SensorDataDTO, len(data))
+	for i, item := range data {
+		dtos[i] = SensorDataDTO{
+			Time:                 item.Time,
+			DeviceID:             item.DeviceID,
+			RegionalControllerID: item.RegionalControllerID,
+			SensorType:           item.SensorType,
+			Data:                 json.RawMessage(item.Data),
+		}
+	}
+
+	return &ListSensorDataResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListDeviceCommandLogResponse 从模型数据创建列表响应 DTO
+func NewListDeviceCommandLogResponse(data []models.DeviceCommandLog, total int64, page, pageSize int) *ListDeviceCommandLogResponse {
+	dtos := make([]DeviceCommandLogDTO, len(data))
+	for i, item := range data {
+		dtos[i] = DeviceCommandLogDTO{
+			MessageID:       item.MessageID,
+			DeviceID:        item.DeviceID,
+			SentAt:          item.SentAt,
+			AcknowledgedAt:  item.AcknowledgedAt,
+			ReceivedSuccess: item.ReceivedSuccess,
+		}
+	}
+
+	return &ListDeviceCommandLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListPlanExecutionLogResponse 从模型数据创建列表响应 DTO
+func NewListPlanExecutionLogResponse(planLogs []models.PlanExecutionLog, plans []models.Plan, total int64, page, pageSize int) *ListPlanExecutionLogResponse {
+	planId2Name := make(map[uint]string)
+	for _, plan := range plans {
+		planId2Name[plan.ID] = plan.Name
+	}
+
+	dtos := make([]PlanExecutionLogDTO, len(planLogs))
+	for i, item := range planLogs {
+		dtos[i] = PlanExecutionLogDTO{
+			ID:        item.ID,
+			CreatedAt: item.CreatedAt,
+			UpdatedAt: item.UpdatedAt,
+			PlanID:    item.PlanID,
+			PlanName:  planId2Name[item.PlanID],
+			Status:    item.Status,
+			StartedAt: item.StartedAt,
+			EndedAt:   item.EndedAt,
+			Error:     item.Error,
+		}
+	}
+
+	return &ListPlanExecutionLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListTaskExecutionLogResponse 从模型数据创建列表响应 DTO
+func NewListTaskExecutionLogResponse(data []models.TaskExecutionLog, total int64, page, pageSize int) *ListTaskExecutionLogResponse {
+	dtos := make([]TaskExecutionLogDTO, len(data))
+	for i, item := range data {
+		dtos[i] = TaskExecutionLogDTO{
+			ID:                 item.ID,
+			CreatedAt:          item.CreatedAt,
+			UpdatedAt:          item.UpdatedAt,
+			PlanExecutionLogID: item.PlanExecutionLogID,
+			TaskID:             item.TaskID,
+			Task: TaskDTO{
+				ID:          uint(item.Task.ID),
+				Name:        item.Task.Name,
+				Description: item.Task.Description,
+			},
+			Status:    item.Status,
+			Output:    item.Output,
+			StartedAt: item.StartedAt,
+			EndedAt:   item.EndedAt,
+		}
+	}
+
+	return &ListTaskExecutionLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListPendingCollectionResponse 从模型数据创建列表响应 DTO
+func NewListPendingCollectionResponse(data []models.PendingCollection, total int64, page, pageSize int) *ListPendingCollectionResponse {
+	dtos := make([]PendingCollectionDTO, len(data))
+	for i, item := range data {
+		dtos[i] = PendingCollectionDTO{
+			CorrelationID:   item.CorrelationID,
+			DeviceID:        item.DeviceID,
+			CommandMetadata: item.CommandMetadata,
+			Status:          item.Status,
+			FulfilledAt:     item.FulfilledAt,
+			CreatedAt:       item.CreatedAt,
+		}
+	}
+
+	return &ListPendingCollectionResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListUserActionLogResponse 从模型数据创建列表响应 DTO
+func NewListUserActionLogResponse(data []models.UserActionLog, total int64, page, pageSize int) *ListUserActionLogResponse {
+	dtos := make([]UserActionLogDTO, len(data))
+	for i, item := range data {
+		dtos[i] = UserActionLogDTO{
+			ID:             item.ID,
+			Time:           item.Time,
+			UserID:         item.UserID,
+			Username:       item.Username,
+			SourceIP:       item.SourceIP,
+			ActionType:     item.ActionType,
+			TargetResource: json.RawMessage(item.TargetResource),
+			Description:    item.Description,
+			Status:         item.Status,
+			HTTPPath:       item.HTTPPath,
+			HTTPMethod:     item.HTTPMethod,
+			ResultDetails:  item.ResultDetails,
+		}
+	}
+
+	return &ListUserActionLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListRawMaterialPurchaseResponse 从模型数据创建列表响应 DTO
+func NewListRawMaterialPurchaseResponse(data []models.RawMaterialPurchase, total int64, page, pageSize int) *ListRawMaterialPurchaseResponse {
+	dtos := make([]RawMaterialPurchaseDTO, len(data))
+	for i, item := range data {
+		dtos[i] = RawMaterialPurchaseDTO{
+			ID:            item.ID,
+			RawMaterialID: item.RawMaterialID,
+			RawMaterial: RawMaterialDTO{
+				ID:   item.RawMaterial.ID,
+				Name: item.RawMaterial.Name,
+			},
+			Supplier:     item.Supplier,
+			Amount:       item.Amount,
+			UnitPrice:    item.UnitPrice,
+			TotalPrice:   item.TotalPrice,
+			PurchaseDate: item.PurchaseDate,
+			CreatedAt:    item.CreatedAt,
+		}
+	}
+
+	return &ListRawMaterialPurchaseResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListRawMaterialStockLogResponse 从模型数据创建列表响应 DTO
+func NewListRawMaterialStockLogResponse(data []models.RawMaterialStockLog, total int64, page, pageSize int) *ListRawMaterialStockLogResponse {
+	dtos := make([]RawMaterialStockLogDTO, len(data))
+	for i, item := range data {
+		dtos[i] = RawMaterialStockLogDTO{
+			ID:            item.ID,
+			RawMaterialID: item.RawMaterialID,
+			ChangeAmount:  item.ChangeAmount,
+			SourceType:    item.SourceType,
+			SourceID:      item.SourceID,
+			HappenedAt:    item.HappenedAt,
+			Remarks:       item.Remarks,
+		}
+	}
+
+	return &ListRawMaterialStockLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListFeedUsageRecordResponse 从模型数据创建列表响应 DTO
+func NewListFeedUsageRecordResponse(data []models.FeedUsageRecord, total int64, page, pageSize int) *ListFeedUsageRecordResponse {
+	dtos := make([]FeedUsageRecordDTO, len(data))
+	for i, item := range data {
+		dtos[i] = FeedUsageRecordDTO{
+			ID:    item.ID,
+			PenID: item.PenID,
+			Pen: PenDTO{
+				ID:   item.Pen.ID,
+				Name: item.Pen.PenNumber,
+			},
+			FeedFormulaID: item.FeedFormulaID,
+			FeedFormula: FeedFormulaDTO{
+				ID:   item.FeedFormula.ID,
+				Name: item.FeedFormula.Name,
+			},
+			Amount:     item.Amount,
+			RecordedAt: item.RecordedAt,
+			OperatorID: item.OperatorID,
+			Remarks:    item.Remarks,
+		}
+	}
+
+	return &ListFeedUsageRecordResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListMedicationLogResponse 从模型数据创建列表响应 DTO
+func NewListMedicationLogResponse(data []models.MedicationLog, total int64, page, pageSize int) *ListMedicationLogResponse {
+	dtos := make([]MedicationLogDTO, len(data))
+	for i, item := range data {
+		dtos[i] = MedicationLogDTO{
+			ID:           item.ID,
+			PigBatchID:   item.PigBatchID,
+			MedicationID: item.MedicationID,
+			Medication: MedicationDTO{
+				ID:   item.Medication.ID,
+				Name: item.Medication.Name,
+			},
+			DosageUsed:  item.DosageUsed,
+			TargetCount: item.TargetCount,
+			Reason:      item.Reason,
+			Description: item.Description,
+			OperatorID:  item.OperatorID,
+			HappenedAt:  item.HappenedAt,
+		}
+	}
+
+	return &ListMedicationLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListPigBatchLogResponse 从模型数据创建列表响应 DTO
+func NewListPigBatchLogResponse(data []models.PigBatchLog, total int64, page, pageSize int) *ListPigBatchLogResponse {
+	dtos := make([]PigBatchLogDTO, len(data))
+	for i, item := range data {
+		dtos[i] = PigBatchLogDTO{
+			ID:          item.ID,
+			CreatedAt:   item.CreatedAt,
+			UpdatedAt:   item.UpdatedAt,
+			PigBatchID:  item.PigBatchID,
+			ChangeType:  item.ChangeType,
+			ChangeCount: item.ChangeCount,
+			Reason:      item.Reason,
+			BeforeCount: item.BeforeCount,
+			AfterCount:  item.AfterCount,
+			OperatorID:  item.OperatorID,
+			HappenedAt:  item.HappenedAt,
+		}
+	}
+
+	return &ListPigBatchLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListWeighingBatchResponse 从模型数据创建列表响应 DTO
+func NewListWeighingBatchResponse(data []models.WeighingBatch, total int64, page, pageSize int) *ListWeighingBatchResponse {
+	dtos := make([]WeighingBatchDTO, len(data))
+	for i, item := range data {
+		dtos[i] = WeighingBatchDTO{
+			ID:           item.ID,
+			CreatedAt:    item.CreatedAt,
+			UpdatedAt:    item.UpdatedAt,
+			WeighingTime: item.WeighingTime,
+			Description:  item.Description,
+			PigBatchID:   item.PigBatchID,
+		}
+	}
+
+	return &ListWeighingBatchResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListWeighingRecordResponse 从模型数据创建列表响应 DTO
+func NewListWeighingRecordResponse(data []models.WeighingRecord, total int64, page, pageSize int) *ListWeighingRecordResponse {
+	dtos := make([]WeighingRecordDTO, len(data))
+	for i, item := range data {
+		dtos[i] = WeighingRecordDTO{
+			ID:              item.ID,
+			CreatedAt:       item.CreatedAt,
+			UpdatedAt:       item.UpdatedAt,
+			Weight:          item.Weight,
+			WeighingBatchID: item.WeighingBatchID,
+			PenID:           item.PenID,
+			OperatorID:      item.OperatorID,
+			Remark:          item.Remark,
+			WeighingTime:    item.WeighingTime,
+		}
+	}
+
+	return &ListWeighingRecordResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListPigTransferLogResponse 从模型数据创建列表响应 DTO
+func NewListPigTransferLogResponse(data []models.PigTransferLog, total int64, page, pageSize int) *ListPigTransferLogResponse {
+	dtos := make([]PigTransferLogDTO, len(data))
+	for i, item := range data {
+		// 注意：PigTransferLog 的 ID, CreatedAt, UpdatedAt 字段是 gorm.Model 嵌入的
+		dtos[i] = PigTransferLogDTO{
+			ID:            item.ID,
+			CreatedAt:     item.CreatedAt,
+			UpdatedAt:     item.UpdatedAt,
+			TransferTime:  item.TransferTime,
+			PigBatchID:    item.PigBatchID,
+			PenID:         item.PenID,
+			Quantity:      item.Quantity,
+			Type:          item.Type,
+			CorrelationID: item.CorrelationID,
+			OperatorID:    item.OperatorID,
+			Remarks:       item.Remarks,
+		}
+	}
+
+	return &ListPigTransferLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListPigSickLogResponse 从模型数据创建列表响应 DTO
+func NewListPigSickLogResponse(data []models.PigSickLog, total int64, page, pageSize int) *ListPigSickLogResponse {
+	dtos := make([]PigSickLogDTO, len(data))
+	for i, item := range data {
+		dtos[i] = PigSickLogDTO{
+			ID:                item.ID,
+			CreatedAt:         item.CreatedAt,
+			UpdatedAt:         item.UpdatedAt,
+			PigBatchID:        item.PigBatchID,
+			PenID:             item.PenID,
+			ChangeCount:       item.ChangeCount,
+			Reason:            item.Reason,
+			BeforeCount:       item.BeforeCount,
+			AfterCount:        item.AfterCount,
+			Remarks:           item.Remarks,
+			TreatmentLocation: item.TreatmentLocation,
+			OperatorID:        item.OperatorID,
+			HappenedAt:        item.HappenedAt,
+		}
+	}
+
+	return &ListPigSickLogResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListPigPurchaseResponse 从模型数据创建列表响应 DTO
+func NewListPigPurchaseResponse(data []models.PigPurchase, total int64, page, pageSize int) *ListPigPurchaseResponse {
+	dtos := make([]PigPurchaseDTO, len(data))
+	for i, item := range data {
+		dtos[i] = PigPurchaseDTO{
+			ID:           item.ID,
+			CreatedAt:    item.CreatedAt,
+			UpdatedAt:    item.UpdatedAt,
+			PigBatchID:   item.PigBatchID,
+			PurchaseDate: item.PurchaseDate,
+			Supplier:     item.Supplier,
+			Quantity:     item.Quantity,
+			UnitPrice:    item.UnitPrice,
+			TotalPrice:   item.TotalPrice,
+			Remarks:      item.Remarks,
+			OperatorID:   item.OperatorID,
+		}
+	}
+
+	return &ListPigPurchaseResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}
+
+// NewListPigSaleResponse 从模型数据创建列表响应 DTO
+func NewListPigSaleResponse(data []models.PigSale, total int64, page, pageSize int) *ListPigSaleResponse {
+	dtos := make([]PigSaleDTO, len(data))
+	for i, item := range data {
+		dtos[i] = PigSaleDTO{
+			ID:         item.ID,
+			CreatedAt:  item.CreatedAt,
+			UpdatedAt:  item.UpdatedAt,
+			PigBatchID: item.PigBatchID,
+			SaleDate:   item.SaleDate,
+			Buyer:      item.Buyer,
+			Quantity:   item.Quantity,
+			UnitPrice:  item.UnitPrice,
+			TotalPrice: item.TotalPrice,
+			Remarks:    item.Remarks,
+			OperatorID: item.OperatorID,
+		}
+	}
+
+	return &ListPigSaleResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}

internal/app/dto/monitor_dto.go

@@ -0,0 +1,609 @@
+package dto
+
+import (
+	"encoding/json"
+	"time"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+)
+
+// --- General ---
+
+// PaginationDTO 定义了分页信息的标准结构
+type PaginationDTO struct {
+	Total    int64 `json:"total"`
+	Page     int   `json:"page"`
+	PageSize int   `json:"page_size"`
+}
+
+// --- SensorData ---
+
+// ListSensorDataRequest 定义了获取传感器数据列表的请求参数
+type ListSensorDataRequest struct {
+	Page       int        `json:"page" query:"page"`
+	PageSize   int        `json:"page_size" query:"page_size"`
+	DeviceID   *uint      `json:"device_id" query:"device_id"`
+	SensorType *string    `json:"sensor_type" query:"sensor_type"`
+	StartTime  *time.Time `json:"start_time" query:"start_time"`
+	EndTime    *time.Time `json:"end_time" query:"end_time"`
+	OrderBy    string     `json:"order_by" query:"order_by"`
+}
+
+// SensorDataDTO 是用于API响应的传感器数据结构
+type SensorDataDTO struct {
+	Time                 time.Time         `json:"time"`
+	DeviceID             uint              `json:"device_id"`
+	RegionalControllerID uint              `json:"regional_controller_id"`
+	SensorType           models.SensorType `json:"sensor_type"`
+	Data                 json.RawMessage   `json:"data"`
+}
+
+// ListSensorDataResponse 是获取传感器数据列表的响应结构
+type ListSensorDataResponse struct {
+	List       []SensorDataDTO `json:"list"`
+	Pagination PaginationDTO   `json:"pagination"`
+}
+
+// --- DeviceCommandLog ---
+
+// ListDeviceCommandLogRequest 定义了获取设备命令日志列表的请求参数
+type ListDeviceCommandLogRequest struct {
+	Page            int        `json:"page" query:"page"`
+	PageSize        int        `json:"page_size" query:"page_size"`
+	DeviceID        *uint      `json:"device_id" query:"device_id"`
+	ReceivedSuccess *bool      `json:"received_success" query:"received_success"`
+	StartTime       *time.Time `json:"start_time" query:"start_time"`
+	EndTime         *time.Time `json:"end_time" query:"end_time"`
+	OrderBy         string     `json:"order_by" query:"order_by"`
+}
+
+// DeviceCommandLogDTO 是用于API响应的设备命令日志结构
+type DeviceCommandLogDTO struct {
+	MessageID       string     `json:"message_id"`
+	DeviceID        uint       `json:"device_id"`
+	SentAt          time.Time  `json:"sent_at"`
+	AcknowledgedAt  *time.Time `json:"acknowledged_at"`
+	ReceivedSuccess bool       `json:"received_success"`
+}
+
+// ListDeviceCommandLogResponse 是获取设备命令日志列表的响应结构
+type ListDeviceCommandLogResponse struct {
+	List       []DeviceCommandLogDTO `json:"list"`
+	Pagination PaginationDTO         `json:"pagination"`
+}
+
+// --- PlanExecutionLog ---
+
+// ListPlanExecutionLogRequest 定义了获取计划执行日志列表的请求参数
+type ListPlanExecutionLogRequest struct {
+	Page      int        `json:"page" query:"page"`
+	PageSize  int        `json:"page_size" query:"page_size"`
+	PlanID    *uint      `json:"plan_id" query:"plan_id"`
+	Status    *string    `json:"status" query:"status"`
+	StartTime *time.Time `json:"start_time" query:"start_time"`
+	EndTime   *time.Time `json:"end_time" query:"end_time"`
+	OrderBy   string     `json:"order_by" query:"order_by"`
+}
+
+// PlanExecutionLogDTO 是用于API响应的计划执行日志结构
+type PlanExecutionLogDTO struct {
+	ID        uint                   `json:"id"`
+	CreatedAt time.Time              `json:"created_at"`
+	UpdatedAt time.Time              `json:"updated_at"`
+	PlanID    uint                   `json:"plan_id"`
+	PlanName  string                 `json:"plan_name"`
+	Status    models.ExecutionStatus `json:"status"`
+	StartedAt time.Time              `json:"started_at"`
+	EndedAt   time.Time              `json:"ended_at"`
+	Error     string                 `json:"error"`
+}
+
+// ListPlanExecutionLogResponse 是获取计划执行日志列表的响应结构
+type ListPlanExecutionLogResponse struct {
+	List       []PlanExecutionLogDTO `json:"list"`
+	Pagination PaginationDTO         `json:"pagination"`
+}
+
+// --- TaskExecutionLog ---
+
+// ListTaskExecutionLogRequest 定义了获取任务执行日志列表的请求参数
+type ListTaskExecutionLogRequest struct {
+	Page               int        `json:"page" query:"page"`
+	PageSize           int        `json:"page_size" query:"page_size"`
+	PlanExecutionLogID *uint      `json:"plan_execution_log_id" query:"plan_execution_log_id"`
+	TaskID             *int       `json:"task_id" query:"task_id"`
+	Status             *string    `json:"status" query:"status"`
+	StartTime          *time.Time `json:"start_time" query:"start_time"`
+	EndTime            *time.Time `json:"end_time" query:"end_time"`
+	OrderBy            string     `json:"order_by" query:"order_by"`
+}
+
+// TaskDTO 是用于API响应的简化版任务结构
+type TaskDTO struct {
+	ID          uint   `json:"id"`
+	Name        string `json:"name"`
+	Description string `json:"description"`
+}
+
+// TaskExecutionLogDTO 是用于API响应的任务执行日志结构
+type TaskExecutionLogDTO struct {
+	ID                 uint                   `json:"id"`
+	CreatedAt          time.Time              `json:"created_at"`
+	UpdatedAt          time.Time              `json:"updated_at"`
+	PlanExecutionLogID uint                   `json:"plan_execution_log_id"`
+	TaskID             int                    `json:"task_id"`
+	Task               TaskDTO                `json:"task"` // 嵌套的任务信息
+	Status             models.ExecutionStatus `json:"status"`
+	Output             string                 `json:"output"`
+	StartedAt          time.Time              `json:"started_at"`
+	EndedAt            time.Time              `json:"ended_at"`
+}
+
+// ListTaskExecutionLogResponse 是获取任务执行日志列表的响应结构
+type ListTaskExecutionLogResponse struct {
+	List       []TaskExecutionLogDTO `json:"list"`
+	Pagination PaginationDTO         `json:"pagination"`
+}
+
+// --- PendingCollection ---
+
+// ListPendingCollectionRequest 定义了获取待采集请求列表的请求参数
+type ListPendingCollectionRequest struct {
+	Page      int        `json:"page" query:"page"`
+	PageSize  int        `json:"page_size" query:"page_size"`
+	DeviceID  *uint      `json:"device_id" query:"device_id"`
+	Status    *string    `json:"status" query:"status"`
+	StartTime *time.Time `json:"start_time" query:"start_time"`
+	EndTime   *time.Time `json:"end_time" query:"end_time"`
+	OrderBy   string     `json:"order_by" query:"order_by"`
+}
+
+// PendingCollectionDTO 是用于API响应的待采集请求结构
+type PendingCollectionDTO struct {
+	CorrelationID   string                         `json:"correlation_id"`
+	DeviceID        uint                           `json:"device_id"`
+	CommandMetadata models.UintArray               `json:"command_metadata"`
+	Status          models.PendingCollectionStatus `json:"status"`
+	FulfilledAt     *time.Time                     `json:"fulfilled_at"`
+	CreatedAt       time.Time                      `json:"created_at"`
+}
+
+// ListPendingCollectionResponse 是获取待采集请求列表的响应结构
+type ListPendingCollectionResponse struct {
+	List       []PendingCollectionDTO `json:"list"`
+	Pagination PaginationDTO          `json:"pagination"`
+}
+
+// --- UserActionLog ---
+
+// ListUserActionLogRequest 定义了获取用户操作日志列表的请求参数
+type ListUserActionLogRequest struct {
+	Page       int        `json:"page" query:"page"`
+	PageSize   int        `json:"page_size" query:"page_size"`
+	UserID     *uint      `json:"user_id" query:"user_id"`
+	Username   *string    `json:"username" query:"username"`
+	ActionType *string    `json:"action_type" query:"action_type"`
+	Status     *string    `json:"status" query:"status"`
+	StartTime  *time.Time `json:"start_time" query:"start_time"`
+	EndTime    *time.Time `json:"end_time" query:"end_time"`
+	OrderBy    string     `json:"order_by" query:"order_by"`
+}
+
+// UserActionLogDTO 是用于API响应的用户操作日志结构
+type UserActionLogDTO struct {
+	ID             uint               `json:"id"`
+	Time           time.Time          `json:"time"`
+	UserID         uint               `json:"user_id"`
+	Username       string             `json:"username"`
+	SourceIP       string             `json:"source_ip"`
+	ActionType     string             `json:"action_type"`
+	TargetResource json.RawMessage    `json:"target_resource"`
+	Description    string             `json:"description"`
+	Status         models.AuditStatus `json:"status"`
+	HTTPPath       string             `json:"http_path"`
+	HTTPMethod     string             `json:"http_method"`
+	ResultDetails  string             `json:"result_details"`
+}
+
+// ListUserActionLogResponse 是获取用户操作日志列表的响应结构
+type ListUserActionLogResponse struct {
+	List       []UserActionLogDTO `json:"list"`
+	Pagination PaginationDTO      `json:"pagination"`
+}
+
+// --- RawMaterialPurchase ---
+
+// ListRawMaterialPurchaseRequest 定义了获取原料采购列表的请求参数
+type ListRawMaterialPurchaseRequest struct {
+	Page          int        `json:"page" query:"page"`
+	PageSize      int        `json:"page_size" query:"page_size"`
+	RawMaterialID *uint      `json:"raw_material_id" query:"raw_material_id"`
+	Supplier      *string    `json:"supplier" query:"supplier"`
+	StartTime     *time.Time `json:"start_time" query:"start_time"`
+	EndTime       *time.Time `json:"end_time" query:"end_time"`
+	OrderBy       string     `json:"order_by" query:"order_by"`
+}
+
+// RawMaterialDTO 是用于API响应的简化版原料结构
+type RawMaterialDTO struct {
+	ID   uint   `json:"id"`
+	Name string `json:"name"`
+}
+
+// RawMaterialPurchaseDTO 是用于API响应的原料采购结构
+type RawMaterialPurchaseDTO struct {
+	ID            uint           `json:"id"`
+	RawMaterialID uint           `json:"raw_material_id"`
+	RawMaterial   RawMaterialDTO `json:"raw_material"`
+	Supplier      string         `json:"supplier"`
+	Amount        float64        `json:"amount"`
+	UnitPrice     float64        `json:"unit_price"`
+	TotalPrice    float64        `json:"total_price"`
+	PurchaseDate  time.Time      `json:"purchase_date"`
+	CreatedAt     time.Time      `json:"created_at"`
+}
+
+// ListRawMaterialPurchaseResponse 是获取原料采购列表的响应结构
+type ListRawMaterialPurchaseResponse struct {
+	List       []RawMaterialPurchaseDTO `json:"list"`
+	Pagination PaginationDTO            `json:"pagination"`
+}
+
+// --- RawMaterialStockLog ---
+
+// ListRawMaterialStockLogRequest 定义了获取原料库存日志列表的请求参数
+type ListRawMaterialStockLogRequest struct {
+	Page          int        `json:"page" query:"page"`
+	PageSize      int        `json:"page_size" query:"page_size"`
+	RawMaterialID *uint      `json:"raw_material_id" query:"raw_material_id"`
+	SourceType    *string    `json:"source_type" query:"source_type"`
+	SourceID      *uint      `json:"source_id" query:"source_id"`
+	StartTime     *time.Time `json:"start_time" query:"start_time"`
+	EndTime       *time.Time `json:"end_time" query:"end_time"`
+	OrderBy       string     `json:"order_by" query:"order_by"`
+}
+
+// RawMaterialStockLogDTO 是用于API响应的原料库存日志结构
+type RawMaterialStockLogDTO struct {
+	ID            uint                      `json:"id"`
+	RawMaterialID uint                      `json:"raw_material_id"`
+	ChangeAmount  float64                   `json:"change_amount"`
+	SourceType    models.StockLogSourceType `json:"source_type"`
+	SourceID      uint                      `json:"source_id"`
+	HappenedAt    time.Time                 `json:"happened_at"`
+	Remarks       string                    `json:"remarks"`
+}
+
+// ListRawMaterialStockLogResponse 是获取原料库存日志列表的响应结构
+type ListRawMaterialStockLogResponse struct {
+	List       []RawMaterialStockLogDTO `json:"list"`
+	Pagination PaginationDTO            `json:"pagination"`
+}
+
+// --- FeedUsageRecord ---
+
+// ListFeedUsageRecordRequest 定义了获取饲料使用记录列表的请求参数
+type ListFeedUsageRecordRequest struct {
+	Page          int        `json:"page" query:"page"`
+	PageSize      int        `json:"page_size" query:"page_size"`
+	PenID         *uint      `json:"pen_id" query:"pen_id"`
+	FeedFormulaID *uint      `json:"feed_formula_id" query:"feed_formula_id"`
+	OperatorID    *uint      `json:"operator_id" query:"operator_id"`
+	StartTime     *time.Time `json:"start_time" query:"start_time"`
+	EndTime       *time.Time `json:"end_time" query:"end_time"`
+	OrderBy       string     `json:"order_by" query:"order_by"`
+}
+
+// PenDTO 是用于API响应的简化版猪栏结构
+type PenDTO struct {
+	ID   uint   `json:"id"`
+	Name string `json:"name"`
+}
+
+// FeedFormulaDTO 是用于API响应的简化版饲料配方结构
+type FeedFormulaDTO struct {
+	ID   uint   `json:"id"`
+	Name string `json:"name"`
+}
+
+// FeedUsageRecordDTO 是用于API响应的饲料使用记录结构
+type FeedUsageRecordDTO struct {
+	ID            uint           `json:"id"`
+	PenID         uint           `json:"pen_id"`
+	Pen           PenDTO         `json:"pen"`
+	FeedFormulaID uint           `json:"feed_formula_id"`
+	FeedFormula   FeedFormulaDTO `json:"feed_formula"`
+	Amount        float64        `json:"amount"`
+	RecordedAt    time.Time      `json:"recorded_at"`
+	OperatorID    uint           `json:"operator_id"`
+	Remarks       string         `json:"remarks"`
+}
+
+// ListFeedUsageRecordResponse 是获取饲料使用记录列表的响应结构
+type ListFeedUsageRecordResponse struct {
+	List       []FeedUsageRecordDTO `json:"list"`
+	Pagination PaginationDTO        `json:"pagination"`
+}
+
+// --- MedicationLog ---
+
+// ListMedicationLogRequest 定义了获取用药记录列表的请求参数
+type ListMedicationLogRequest struct {
+	Page         int        `json:"page" query:"page"`
+	PageSize     int        `json:"page_size" query:"page_size"`
+	PigBatchID   *uint      `json:"pig_batch_id" query:"pig_batch_id"`
+	MedicationID *uint      `json:"medication_id" query:"medication_id"`
+	Reason       *string    `json:"reason" query:"reason"`
+	OperatorID   *uint      `json:"operator_id" query:"operator_id"`
+	StartTime    *time.Time `json:"start_time" query:"start_time"`
+	EndTime      *time.Time `json:"end_time" query:"end_time"`
+	OrderBy      string     `json:"order_by" query:"order_by"`
+}
+
+// MedicationDTO 是用于API响应的简化版药品结构
+type MedicationDTO struct {
+	ID   uint   `json:"id"`
+	Name string `json:"name"`
+}
+
+// MedicationLogDTO 是用于API响应的用药记录结构
+type MedicationLogDTO struct {
+	ID           uint                        `json:"id"`
+	PigBatchID   uint                        `json:"pig_batch_id"`
+	MedicationID uint                        `json:"medication_id"`
+	Medication   MedicationDTO               `json:"medication"`
+	DosageUsed   float64                     `json:"dosage_used"`
+	TargetCount  int                         `json:"target_count"`
+	Reason       models.MedicationReasonType `json:"reason"`
+	Description  string                      `json:"description"`
+	OperatorID   uint                        `json:"operator_id"`
+	HappenedAt   time.Time                   `json:"happened_at"`
+}
+
+// ListMedicationLogResponse 是获取用药记录列表的响应结构
+type ListMedicationLogResponse struct {
+	List       []MedicationLogDTO `json:"list"`
+	Pagination PaginationDTO      `json:"pagination"`
+}
+
+// --- PigBatchLog ---
+
+// ListPigBatchLogRequest 定义了获取猪批次日志列表的请求参数
+type ListPigBatchLogRequest struct {
+	Page       int        `json:"page" query:"page"`
+	PageSize   int        `json:"page_size" query:"page_size"`
+	PigBatchID *uint      `json:"pig_batch_id" query:"pig_batch_id"`
+	ChangeType *string    `json:"change_type" query:"change_type"`
+	OperatorID *uint      `json:"operator_id" query:"operator_id"`
+	StartTime  *time.Time `json:"start_time" query:"start_time"`
+	EndTime    *time.Time `json:"end_time" query:"end_time"`
+	OrderBy    string     `json:"order_by" query:"order_by"`
+}
+
+// PigBatchLogDTO 是用于API响应的猪批次日志结构
+type PigBatchLogDTO struct {
+	ID          uint                 `json:"id"`
+	CreatedAt   time.Time            `json:"created_at"`
+	UpdatedAt   time.Time            `json:"updated_at"`
+	PigBatchID  uint                 `json:"pig_batch_id"`
+	ChangeType  models.LogChangeType `json:"change_type"`
+	ChangeCount int                  `json:"change_count"`
+	Reason      string               `json:"reason"`
+	BeforeCount int                  `json:"before_count"`
+	AfterCount  int                  `json:"after_count"`
+	OperatorID  uint                 `json:"operator_id"`
+	HappenedAt  time.Time            `json:"happened_at"`
+}
+
+// ListPigBatchLogResponse 是获取猪批次日志列表的响应结构
+type ListPigBatchLogResponse struct {
+	List       []PigBatchLogDTO `json:"list"`
+	Pagination PaginationDTO    `json:"pagination"`
+}
+
+// --- WeighingBatch ---
+
+// ListWeighingBatchRequest 定义了获取批次称重记录列表的请求参数
+type ListWeighingBatchRequest struct {
+	Page       int        `json:"page" query:"page"`
+	PageSize   int        `json:"page_size" query:"page_size"`
+	PigBatchID *uint      `json:"pig_batch_id" query:"pig_batch_id"`
+	StartTime  *time.Time `json:"start_time" query:"start_time"`
+	EndTime    *time.Time `json:"end_time" query:"end_time"`
+	OrderBy    string     `json:"order_by" query:"order_by"`
+}
+
+// WeighingBatchDTO 是用于API响应的批次称重记录结构
+type WeighingBatchDTO struct {
+	ID           uint      `json:"id"`
+	CreatedAt    time.Time `json:"created_at"`
+	UpdatedAt    time.Time `json:"updated_at"`
+	WeighingTime time.Time `json:"weighing_time"`
+	Description  string    `json:"description"`
+	PigBatchID   uint      `json:"pig_batch_id"`
+}
+
+// ListWeighingBatchResponse 是获取批次称重记录列表的响应结构
+type ListWeighingBatchResponse struct {
+	List       []WeighingBatchDTO `json:"list"`
+	Pagination PaginationDTO      `json:"pagination"`
+}
+
+// --- WeighingRecord ---
+
+// ListWeighingRecordRequest 定义了获取单次称重记录列表的请求参数
+type ListWeighingRecordRequest struct {
+	Page            int        `json:"page" query:"page"`
+	PageSize        int        `json:"page_size" query:"page_size"`
+	WeighingBatchID *uint      `json:"weighing_batch_id" query:"weighing_batch_id"`
+	PenID           *uint      `json:"pen_id" query:"pen_id"`
+	OperatorID      *uint      `json:"operator_id" query:"operator_id"`
+	StartTime       *time.Time `json:"start_time" query:"start_time"`
+	EndTime         *time.Time `json:"end_time" query:"end_time"`
+	OrderBy         string     `json:"order_by" query:"order_by"`
+}
+
+// WeighingRecordDTO 是用于API响应的单次称重记录结构
+type WeighingRecordDTO struct {
+	ID              uint      `json:"id"`
+	CreatedAt       time.Time `json:"created_at"`
+	UpdatedAt       time.Time `json:"updated_at"`
+	Weight          float64   `json:"weight"`
+	WeighingBatchID uint      `json:"weighing_batch_id"`
+	PenID           uint      `json:"pen_id"`
+	OperatorID      uint      `json:"operator_id"`
+	Remark          string    `json:"remark"`
+	WeighingTime    time.Time `json:"weighing_time"`
+}
+
+// ListWeighingRecordResponse 是获取单次称重记录列表的响应结构
+type ListWeighingRecordResponse struct {
+	List       []WeighingRecordDTO `json:"list"`
+	Pagination PaginationDTO       `json:"pagination"`
+}
+
+// --- PigTransferLog ---
+
+// ListPigTransferLogRequest 定义了获取猪只迁移日志列表的请求参数
+type ListPigTransferLogRequest struct {
+	Page          int        `json:"page" query:"page"`
+	PageSize      int        `json:"page_size" query:"page_size"`
+	PigBatchID    *uint      `json:"pig_batch_id" query:"pig_batch_id"`
+	PenID         *uint      `json:"pen_id" query:"pen_id"`
+	TransferType  *string    `json:"transfer_type" query:"transfer_type"`
+	OperatorID    *uint      `json:"operator_id" query:"operator_id"`
+	CorrelationID *string    `json:"correlation_id" query:"correlation_id"`
+	StartTime     *time.Time `json:"start_time" query:"start_time"`
+	EndTime       *time.Time `json:"end_time" query:"end_time"`
+	OrderBy       string     `json:"order_by" query:"order_by"`
+}
+
+// PigTransferLogDTO 是用于API响应的猪只迁移日志结构
+type PigTransferLogDTO struct {
+	ID            uint                   `json:"id"`
+	CreatedAt     time.Time              `json:"created_at"`
+	UpdatedAt     time.Time              `json:"updated_at"`
+	TransferTime  time.Time              `json:"transfer_time"`
+	PigBatchID    uint                   `json:"pig_batch_id"`
+	PenID         uint                   `json:"pen_id"`
+	Quantity      int                    `json:"quantity"`
+	Type          models.PigTransferType `json:"type"`
+	CorrelationID string                 `json:"correlation_id"`
+	OperatorID    uint                   `json:"operator_id"`
+	Remarks       string                 `json:"remarks"`
+}
+
+// ListPigTransferLogResponse 是获取猪只迁移日志列表的响应结构
+type ListPigTransferLogResponse struct {
+	List       []PigTransferLogDTO `json:"list"`
+	Pagination PaginationDTO       `json:"pagination"`
+}
+
+// --- PigSickLog ---
+
+// ListPigSickLogRequest 定义了获取病猪日志列表的请求参数
+type ListPigSickLogRequest struct {
+	Page              int        `json:"page" query:"page"`
+	PageSize          int        `json:"page_size" query:"page_size"`
+	PigBatchID        *uint      `json:"pig_batch_id" query:"pig_batch_id"`
+	PenID             *uint      `json:"pen_id" query:"pen_id"`
+	Reason            *string    `json:"reason" query:"reason"`
+	TreatmentLocation *string    `json:"treatment_location" query:"treatment_location"`
+	OperatorID        *uint      `json:"operator_id" query:"operator_id"`
+	StartTime         *time.Time `json:"start_time" query:"start_time"`
+	EndTime           *time.Time `json:"end_time" query:"end_time"`
+	OrderBy           string     `json:"order_by" query:"order_by"`
+}
+
+// PigSickLogDTO 是用于API响应的病猪日志结构
+type PigSickLogDTO struct {
+	ID                uint                                    `json:"id"`
+	CreatedAt         time.Time                               `json:"created_at"`
+	UpdatedAt         time.Time                               `json:"updated_at"`
+	PigBatchID        uint                                    `json:"pig_batch_id"`
+	PenID             uint                                    `json:"pen_id"`
+	ChangeCount       int                                     `json:"change_count"`
+	Reason            models.PigBatchSickPigReasonType        `json:"reason"`
+	BeforeCount       int                                     `json:"before_count"`
+	AfterCount        int                                     `json:"after_count"`
+	Remarks           string                                  `json:"remarks"`
+	TreatmentLocation models.PigBatchSickPigTreatmentLocation `json:"treatment_location"`
+	OperatorID        uint                                    `json:"operator_id"`
+	HappenedAt        time.Time                               `json:"happened_at"`
+}
+
+// ListPigSickLogResponse 是获取病猪日志列表的响应结构
+type ListPigSickLogResponse struct {
+	List       []PigSickLogDTO `json:"list"`
+	Pagination PaginationDTO   `json:"pagination"`
+}
+
+// --- PigPurchase ---
+
+// ListPigPurchaseRequest 定义了获取猪只采购记录列表的请求参数
+type ListPigPurchaseRequest struct {
+	Page       int        `json:"page" query:"page"`
+	PageSize   int        `json:"page_size" query:"page_size"`
+	PigBatchID *uint      `json:"pig_batch_id" query:"pig_batch_id"`
+	Supplier   *string    `json:"supplier" query:"supplier"`
+	OperatorID *uint      `json:"operator_id" query:"operator_id"`
+	StartTime  *time.Time `json:"start_time" query:"start_time"`
+	EndTime    *time.Time `json:"end_time" query:"end_time"`
+	OrderBy    string     `json:"order_by" query:"order_by"`
+}
+
+// PigPurchaseDTO 是用于API响应的猪只采购记录结构
+type PigPurchaseDTO struct {
+	ID           uint      `json:"id"`
+	CreatedAt    time.Time `json:"created_at"`
+	UpdatedAt    time.Time `json:"updated_at"`
+	PigBatchID   uint      `json:"pig_batch_id"`
+	PurchaseDate time.Time `json:"purchase_date"`
+	Supplier     string    `json:"supplier"`
+	Quantity     int       `json:"quantity"`
+	UnitPrice    float64   `json:"unit_price"`
+	TotalPrice   float64   `json:"total_price"`
+	Remarks      string    `json:"remarks"`
+	OperatorID   uint      `json:"operator_id"`
+}
+
+// ListPigPurchaseResponse 是获取猪只采购记录列表的响应结构
+type ListPigPurchaseResponse struct {
+	List       []PigPurchaseDTO `json:"list"`
+	Pagination PaginationDTO    `json:"pagination"`
+}
+
+// --- PigSale ---
+
+// ListPigSaleRequest 定义了获取猪只销售记录列表的请求参数
+type ListPigSaleRequest struct {
+	Page       int        `json:"page" query:"page"`
+	PageSize   int        `json:"page_size" query:"page_size"`
+	PigBatchID *uint      `json:"pig_batch_id" query:"pig_batch_id"`
+	Buyer      *string    `json:"buyer" query:"buyer"`
+	OperatorID *uint      `json:"operator_id" query:"operator_id"`
+	StartTime  *time.Time `json:"start_time" query:"start_time"`
+	EndTime    *time.Time `json:"end_time" query:"end_time"`
+	OrderBy    string     `json:"order_by" query:"order_by"`
+}
+
+// PigSaleDTO 是用于API响应的猪只销售记录结构
+type PigSaleDTO struct {
+	ID         uint      `json:"id"`
+	CreatedAt  time.Time `json:"created_at"`
+	UpdatedAt  time.Time `json:"updated_at"`
+	PigBatchID uint      `json:"pig_batch_id"`
+	SaleDate   time.Time `json:"sale_date"`
+	Buyer      string    `json:"buyer"`
+	Quantity   int       `json:"quantity"`
+	UnitPrice  float64   `json:"unit_price"`
+	TotalPrice float64   `json:"total_price"`
+	Remarks    string    `json:"remarks"`
+	OperatorID uint      `json:"operator_id"`
+}
+
+// ListPigSaleResponse 是获取猪只销售记录列表的响应结构
+type ListPigSaleResponse struct {
+	List       []PigSaleDTO  `json:"list"`
+	Pagination PaginationDTO `json:"pagination"`
+}

internal/app/dto/notification_converter.go

@@ -0,0 +1,36 @@
+package dto
+
+import (
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"go.uber.org/zap/zapcore"
+)
+
+// NewListNotificationResponse 从模型数据创建通知列表响应 DTO
+func NewListNotificationResponse(data []models.Notification, total int64, page, pageSize int) *ListNotificationResponse {
+	dtos := make([]NotificationDTO, len(data))
+	for i, item := range data {
+		dtos[i] = NotificationDTO{
+			ID:             item.ID,
+			CreatedAt:      item.CreatedAt,
+			UpdatedAt:      item.UpdatedAt,
+			NotifierType:   item.NotifierType,
+			UserID:         item.UserID,
+			Title:          item.Title,
+			Message:        item.Message,
+			Level:          zapcore.Level(item.Level),
+			AlarmTimestamp: item.AlarmTimestamp,
+			ToAddress:      item.ToAddress,
+			Status:         item.Status,
+			ErrorMessage:   item.ErrorMessage,
+		}
+	}
+
+	return &ListNotificationResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}

internal/app/dto/notification_dto.go

@@ -0,0 +1,50 @@
+package dto
+
+import (
+	"time"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/notify"
+	"go.uber.org/zap/zapcore"
+)
+
+// SendTestNotificationRequest 定义了发送测试通知请求的 JSON 结构
+type SendTestNotificationRequest struct {
+	// Type 指定要测试的通知渠道
+	Type notify.NotifierType `json:"type" validate:"required"`
+}
+
+// ListNotificationRequest 定义了获取通知列表的请求参数
+type ListNotificationRequest struct {
+	Page         int                        `json:"page" query:"page"`
+	PageSize     int                        `json:"page_size" query:"page_size"`
+	UserID       *uint                      `json:"user_id" query:"user_id"`
+	NotifierType *notify.NotifierType       `json:"notifier_type" query:"notifier_type"`
+	Status       *models.NotificationStatus `json:"status" query:"status"`
+	Level        *zapcore.Level             `json:"level" query:"level"`
+	StartTime    *time.Time                 `json:"start_time" query:"start_time"`
+	EndTime      *time.Time                 `json:"end_time" query:"end_time"`
+	OrderBy      string                     `json:"order_by" query:"order_by"`
+}
+
+// NotificationDTO 是用于API响应的通知结构
+type NotificationDTO struct {
+	ID             uint                      `json:"id"`
+	CreatedAt      time.Time                 `json:"created_at"`
+	UpdatedAt      time.Time                 `json:"updated_at"`
+	NotifierType   notify.NotifierType       `json:"notifier_type"`
+	UserID         uint                      `json:"user_id"`
+	Title          string                    `json:"title"`
+	Message        string                    `json:"message"`
+	Level          zapcore.Level             `json:"level"`
+	AlarmTimestamp time.Time                 `json:"alarm_timestamp"`
+	ToAddress      string                    `json:"to_address"`
+	Status         models.NotificationStatus `json:"status"`
+	ErrorMessage   string                    `json:"error_message"`
+}
+
+// ListNotificationResponse 是获取通知列表的响应结构
+type ListNotificationResponse struct {
+	List       []NotificationDTO `json:"list"`
+	Pagination PaginationDTO     `json:"pagination"`
+}

internal/app/dto/pig_batch_dto.go

@@ -8,11 +8,11 @@ import (
 
 // PigBatchCreateDTO 定义了创建猪批次的请求结构
 type PigBatchCreateDTO struct {
-	BatchNumber  string                    `json:"batch_number" binding:"required"`        // 批次编号，必填
-	OriginType   models.PigBatchOriginType `json:"origin_type" binding:"required"`         // 批次来源，必填
-	StartDate    time.Time                 `json:"start_date" binding:"required"`          // 批次开始日期，必填
-	InitialCount int                       `json:"initial_count" binding:"required,min=1"` // 初始数量，必填，最小为1
-	Status       models.PigBatchStatus     `json:"status" binding:"required"`              // 批次状态，必填
+	BatchNumber  string                    `json:"batch_number" validate:"required"`        // 批次编号，必填
+	OriginType   models.PigBatchOriginType `json:"origin_type" validate:"required"`         // 批次来源，必填
+	StartDate    time.Time                 `json:"start_date" validate:"required"`          // 批次开始日期，必填
+	InitialCount int                       `json:"initial_count" validate:"required,min=1"` // 初始数量，必填，最小为1
+	Status       models.PigBatchStatus     `json:"status" validate:"required"`              // 批次状态，必填
 }
 
 // PigBatchUpdateDTO 定义了更新猪批次的请求结构
@@ -27,24 +27,136 @@ type PigBatchUpdateDTO struct {
 
 // PigBatchQueryDTO 定义了查询猪批次的请求结构
 type PigBatchQueryDTO struct {
-	IsActive *bool `json:"is_active" form:"is_active"` // 是否活跃，可选，用于URL查询参数
+	IsActive *bool `json:"is_active" query:"is_active"` // 是否活跃，可选，用于URL查询参数
 }
 
 // PigBatchResponseDTO 定义了猪批次信息的响应结构
 type PigBatchResponseDTO struct {
-	ID           uint                      `json:"id"`            // 批次ID
-	BatchNumber  string                    `json:"batch_number"`  // 批次编号
-	OriginType   models.PigBatchOriginType `json:"origin_type"`   // 批次来源
-	StartDate    time.Time                 `json:"start_date"`    // 批次开始日期
-	EndDate      time.Time                 `json:"end_date"`      // 批次结束日期
-	InitialCount int                       `json:"initial_count"` // 初始数量
-	Status       models.PigBatchStatus     `json:"status"`        // 批次状态
-	IsActive     bool                      `json:"is_active"`     // 是否活跃
-	CreateTime   time.Time                 `json:"create_time"`   // 创建时间
-	UpdateTime   time.Time                 `json:"update_time"`   // 更新时间
+	ID                     uint                      `json:"id"`                         // 批次ID
+	BatchNumber            string                    `json:"batch_number"`               // 批次编号
+	OriginType             models.PigBatchOriginType `json:"origin_type"`                // 批次来源
+	StartDate              time.Time                 `json:"start_date"`                 // 批次开始日期
+	EndDate                time.Time                 `json:"end_date"`                   // 批次结束日期
+	InitialCount           int                       `json:"initial_count"`              // 初始数量
+	Status                 models.PigBatchStatus     `json:"status"`                     // 批次状态
+	IsActive               bool                      `json:"is_active"`                  // 是否活跃
+	CurrentTotalQuantity   int                       `json:"current_total_quantity"`     // 当前总数
+	CurrentTotalPigsInPens int                       `json:"current_total_pigs_in_pens"` // 当前存栏总数
+	CreateTime             time.Time                 `json:"create_time"`                // 创建时间
+	UpdateTime             time.Time                 `json:"update_time"`                // 更新时间
 }
 
-// PigBatchUpdatePensRequest 用于更新猪批次关联猪栏的请求体
-type PigBatchUpdatePensRequest struct {
-	PenIDs []uint `json:"penIDs" binding:"required,min=0" example:"[1,2,3]"`
+// AssignEmptyPensToBatchRequest 用于为猪批次分配空栏的请求体
+type AssignEmptyPensToBatchRequest struct {
+	PenIDs []uint `json:"pen_ids" validate:"required,min=1,dive" example:"1,2,3"` // 待分配的猪栏ID列表
+}
+
+// ReclassifyPenToNewBatchRequest 用于将猪栏划拨到新批次的请求体
+type ReclassifyPenToNewBatchRequest struct {
+	ToBatchID uint   `json:"to_batch_id" validate:"required"` // 目标猪批次ID
+	PenID     uint   `json:"pen_id" validate:"required"`      // 待划拨的猪栏ID
+	Remarks   string `json:"remarks"`                         // 备注
+}
+
+// RemoveEmptyPenFromBatchRequest 用于从猪批次移除空栏的请求体
+type RemoveEmptyPenFromBatchRequest struct {
+	PenID uint `json:"pen_id" validate:"required"` // 待移除的猪栏ID
+}
+
+// MovePigsIntoPenRequest 用于将猪只从“虚拟库存”移入指定猪栏的请求体
+type MovePigsIntoPenRequest struct {
+	ToPenID  uint   `json:"to_pen_id" validate:"required"`      // 目标猪栏ID
+	Quantity int    `json:"quantity" validate:"required,min=1"` // 移入猪只数量
+	Remarks  string `json:"remarks"`                            // 备注
+}
+
+// SellPigsRequest 用于处理卖猪的请求体
+type SellPigsRequest struct {
+	PenID      uint      `json:"pen_id" validate:"required"`            // 猪栏ID
+	Quantity   int       `json:"quantity" validate:"required,min=1"`    // 卖出猪只数量
+	UnitPrice  float64   `json:"unit_price" validate:"required,min=0"`  // 单价
+	TotalPrice float64   `json:"total_price" validate:"required,min=0"` // 总价
+	TraderName string    `json:"trader_name" validate:"required"`       // 交易方名称
+	TradeDate  time.Time `json:"trade_date" validate:"required"`        // 交易日期
+	Remarks    string    `json:"remarks"`                               // 备注
+}
+
+// BuyPigsRequest 用于处理买猪的请求体
+type BuyPigsRequest struct {
+	PenID      uint      `json:"pen_id" validate:"required"`            // 猪栏ID
+	Quantity   int       `json:"quantity" validate:"required,min=1"`    // 买入猪只数量
+	UnitPrice  float64   `json:"unit_price" validate:"required,min=0"`  // 单价
+	TotalPrice float64   `json:"total_price" validate:"required,min=0"` // 总价
+	TraderName string    `json:"trader_name" validate:"required"`       // 交易方名称
+	TradeDate  time.Time `json:"trade_date" validate:"required"`        // 交易日期
+	Remarks    string    `json:"remarks"`                               // 备注
+}
+
+// TransferPigsAcrossBatchesRequest 用于跨猪群调栏的请求体
+type TransferPigsAcrossBatchesRequest struct {
+	DestBatchID uint   `json:"dest_batch_id" validate:"required"`  // 目标猪批次ID
+	FromPenID   uint   `json:"from_pen_id" validate:"required"`    // 源猪栏ID
+	ToPenID     uint   `json:"to_pen_id" validate:"required"`      // 目标猪栏ID
+	Quantity    uint   `json:"quantity" validate:"required,min=1"` // 调栏猪只数量
+	Remarks     string `json:"remarks"`                            // 备注
+}
+
+// TransferPigsWithinBatchRequest 用于群内调栏的请求体
+type TransferPigsWithinBatchRequest struct {
+	FromPenID uint   `json:"from_pen_id" validate:"required"`    // 源猪栏ID
+	ToPenID   uint   `json:"to_pen_id" validate:"required"`      // 目标猪栏ID
+	Quantity  uint   `json:"quantity" validate:"required,min=1"` // 调栏猪只数量
+	Remarks   string `json:"remarks"`                            // 备注
+}
+
+// RecordSickPigsRequest 用于记录新增病猪事件的请求体
+type RecordSickPigsRequest struct {
+	PenID             uint                                    `json:"pen_id" validate:"required"`             // 猪栏ID
+	Quantity          int                                     `json:"quantity" validate:"required,min=1"`     // 病猪数量
+	TreatmentLocation models.PigBatchSickPigTreatmentLocation `json:"treatment_location" validate:"required"` // 治疗地点
+	HappenedAt        time.Time                               `json:"happened_at" validate:"required"`        // 发生时间
+	Remarks           string                                  `json:"remarks"`                                // 备注
+}
+
+// RecordSickPigRecoveryRequest 用于记录病猪康复事件的请求体
+type RecordSickPigRecoveryRequest struct {
+	PenID             uint                                    `json:"pen_id" validate:"required"`             // 猪栏ID
+	Quantity          int                                     `json:"quantity" validate:"required,min=1"`     // 康复猪数量
+	TreatmentLocation models.PigBatchSickPigTreatmentLocation `json:"treatment_location" validate:"required"` // 治疗地点
+	HappenedAt        time.Time                               `json:"happened_at" validate:"required"`        // 发生时间
+	Remarks           string                                  `json:"remarks"`                                // 备注
+}
+
+// RecordSickPigDeathRequest 用于记录病猪死亡事件的请求体
+type RecordSickPigDeathRequest struct {
+	PenID             uint                                    `json:"pen_id" validate:"required"`             // 猪栏ID
+	Quantity          int                                     `json:"quantity" validate:"required,min=1"`     // 死亡猪数量
+	TreatmentLocation models.PigBatchSickPigTreatmentLocation `json:"treatment_location" validate:"required"` // 治疗地点
+	HappenedAt        time.Time                               `json:"happened_at" validate:"required"`        // 发生时间
+	Remarks           string                                  `json:"remarks"`                                // 备注
+}
+
+// RecordSickPigCullRequest 用于记录病猪淘汰事件的请求体
+type RecordSickPigCullRequest struct {
+	PenID             uint                                    `json:"pen_id" validate:"required"`             // 猪栏ID
+	Quantity          int                                     `json:"quantity" validate:"required,min=1"`     // 淘汰猪数量
+	TreatmentLocation models.PigBatchSickPigTreatmentLocation `json:"treatment_location" validate:"required"` // 治疗地点
+	HappenedAt        time.Time                               `json:"happened_at" validate:"required"`        // 发生时间
+	Remarks           string                                  `json:"remarks"`                                // 备注
+}
+
+// RecordDeathRequest 用于记录正常猪只死亡事件的请求体
+type RecordDeathRequest struct {
+	PenID      uint      `json:"pen_id" validate:"required"`         // 猪栏ID
+	Quantity   int       `json:"quantity" validate:"required,min=1"` // 死亡猪数量
+	HappenedAt time.Time `json:"happened_at" validate:"required"`    // 发生时间
+	Remarks    string    `json:"remarks"`                            // 备注
+}
+
+// RecordCullRequest 用于记录正常猪只淘汰事件的请求体
+type RecordCullRequest struct {
+	PenID      uint      `json:"pen_id" validate:"required"`         // 猪栏ID
+	Quantity   int       `json:"quantity" validate:"required,min=1"` // 淘汰猪数量
+	HappenedAt time.Time `json:"happened_at" validate:"required"`    // 发生时间
+	Remarks    string    `json:"remarks"`                            // 备注
 }

internal/app/dto/pig_farm_dto.go

@@ -11,42 +11,43 @@ type PigHouseResponse struct {
 
 // PenResponse 定义了猪栏信息的响应结构
 type PenResponse struct {
-	ID         uint             `json:"id"`
-	PenNumber  string           `json:"pen_number"`
-	HouseID    uint             `json:"house_id"`
-	Capacity   int              `json:"capacity"`
-	Status     models.PenStatus `json:"status"`
-	PigBatchID uint             `json:"pig_batch_id"`
+	ID              uint             `json:"id"`
+	PenNumber       string           `json:"pen_number"`
+	HouseID         uint             `json:"house_id"`
+	Capacity        int              `json:"capacity"`
+	Status          models.PenStatus `json:"status"`
+	PigBatchID      *uint            `json:"pig_batch_id,omitempty"`
+	CurrentPigCount int              `json:"current_pig_count"`
 }
 
 // CreatePigHouseRequest 定义了创建猪舍的请求结构
 type CreatePigHouseRequest struct {
-	Name        string `json:"name" binding:"required"`
+	Name        string `json:"name" validate:"required"`
 	Description string `json:"description"`
 }
 
 // UpdatePigHouseRequest 定义了更新猪舍的请求结构
 type UpdatePigHouseRequest struct {
-	Name        string `json:"name" binding:"required"`
+	Name        string `json:"name" validate:"required"`
 	Description string `json:"description"`
 }
 
 // CreatePenRequest 定义了创建猪栏的请求结构
 type CreatePenRequest struct {
-	PenNumber string `json:"pen_number" binding:"required"`
-	HouseID   uint   `json:"house_id" binding:"required"`
-	Capacity  int    `json:"capacity" binding:"required"`
+	PenNumber string `json:"pen_number" validate:"required"`
+	HouseID   uint   `json:"house_id" validate:"required"`
+	Capacity  int    `json:"capacity" validate:"required"`
 }
 
 // UpdatePenRequest 定义了更新猪栏的请求结构
 type UpdatePenRequest struct {
-	PenNumber string           `json:"pen_number" binding:"required"`
-	HouseID   uint             `json:"house_id" binding:"required"`
-	Capacity  int              `json:"capacity" binding:"required"`
-	Status    models.PenStatus `json:"status" binding:"required,oneof=空闲 使用中 病猪栏 康复栏 清洗消毒 维修中"` // 添加oneof校验
+	PenNumber string           `json:"pen_number" validate:"required"`
+	HouseID   uint             `json:"house_id" validate:"required"`
+	Capacity  int              `json:"capacity" validate:"required"`
+	Status    models.PenStatus `json:"status" validate:"required,oneof=空闲 使用中 病猪栏 康复栏 清洗消毒 维修中"` // 添加oneof校验
 }
 
 // UpdatePenStatusRequest 定义了更新猪栏状态的请求结构
 type UpdatePenStatusRequest struct {
-	Status models.PenStatus `json:"status" binding:"required,oneof=空闲 使用中 病猪栏 康复栏 清洗消毒 维修中" example:"病猪栏"`
+	Status models.PenStatus `json:"status" validate:"required,oneof=空闲 使用中 病猪栏 康复栏 清洗消毒 维修中" example:"病猪栏"`
 }

internal/app/dto/plan_converter.go

@@ -17,6 +17,7 @@ func NewPlanToResponse(plan *models.Plan) (*PlanResponse, error) {
 		ID:             plan.ID,
 		Name:           plan.Name,
 		Description:    plan.Description,
+		PlanType:       plan.PlanType,
 		ExecutionType:  plan.ExecutionType,
 		Status:         plan.Status,
 		ExecuteNum:     plan.ExecuteNum,
@@ -52,7 +53,7 @@ func NewPlanToResponse(plan *models.Plan) (*PlanResponse, error) {
 	return response, nil
 }
 
-// NewPlanFromCreateRequest 将CreatePlanRequest转换为Plan模型，并进行业务规则验证
+// NewPlanFromCreateRequest 将CreatePlanRequest转换为Plan模型
 func NewPlanFromCreateRequest(req *CreatePlanRequest) (*models.Plan, error) {
 	if req == nil {
 		return nil, nil
@@ -64,7 +65,7 @@ func NewPlanFromCreateRequest(req *CreatePlanRequest) (*models.Plan, error) {
 		ExecutionType:  req.ExecutionType,
 		ExecuteNum:     req.ExecuteNum,
 		CronExpression: req.CronExpression,
-		// ContentType 在控制器中设置，此处不再处理
+		// ContentType 和 PlanType 在控制器中设置，此处不再处理
 	}
 
 	// 处理子计划 (通过ID引用)
@@ -74,7 +75,7 @@ func NewPlanFromCreateRequest(req *CreatePlanRequest) (*models.Plan, error) {
 		for i, childPlanID := range subPlanSlice {
 			plan.SubPlans[i] = models.SubPlan{
 				ChildPlanID:    childPlanID,
-				ExecutionOrder: i, // 默认执行顺序, ReorderSteps会再次确认
+				ExecutionOrder: i, // 默认执行顺序
 			}
 		}
 	}
@@ -92,19 +93,10 @@ func NewPlanFromCreateRequest(req *CreatePlanRequest) (*models.Plan, error) {
 		}
 	}
 
-	// 1. 首先，执行重复性验证
-	if err := plan.ValidateExecutionOrder(); err != nil {
-		// 如果检测到重复，立即返回错误
-		return nil, err
-	}
-
-	// 2. 然后，调用方法来修复顺序断层
-	plan.ReorderSteps()
-
 	return plan, nil
 }
 
-// NewPlanFromUpdateRequest 将UpdatePlanRequest转换为Plan模型，并进行业务规则验证
+// NewPlanFromUpdateRequest 将UpdatePlanRequest转换为Plan模型
 func NewPlanFromUpdateRequest(req *UpdatePlanRequest) (*models.Plan, error) {
 	if req == nil {
 		return nil, nil
@@ -116,7 +108,7 @@ func NewPlanFromUpdateRequest(req *UpdatePlanRequest) (*models.Plan, error) {
 		ExecutionType:  req.ExecutionType,
 		ExecuteNum:     req.ExecuteNum,
 		CronExpression: req.CronExpression,
-		// ContentType 在控制器中设置，此处不再处理
+		// ContentType 和 PlanType 在控制器中设置，此处不再处理
 	}
 
 	// 处理子计划 (通过ID引用)
@@ -126,7 +118,7 @@ func NewPlanFromUpdateRequest(req *UpdatePlanRequest) (*models.Plan, error) {
 		for i, childPlanID := range subPlanSlice {
 			plan.SubPlans[i] = models.SubPlan{
 				ChildPlanID:    childPlanID,
-				ExecutionOrder: i, // 默认执行顺序, ReorderSteps会再次确认
+				ExecutionOrder: i, // 默认执行顺序
 			}
 		}
 	}
@@ -144,15 +136,6 @@ func NewPlanFromUpdateRequest(req *UpdatePlanRequest) (*models.Plan, error) {
 		}
 	}
 
-	// 1. 首先，执行重复性验证
-	if err := plan.ValidateExecutionOrder(); err != nil {
-		// 如果检测到重复，立即返回错误
-		return nil, err
-	}
-
-	// 2. 然后，调用方法来修复顺序断层
-	plan.ReorderSteps()
-
 	return plan, nil
 }
 

internal/app/dto/plan_dto.go

@@ -1,16 +1,26 @@
 package dto
 
-import "git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+import (
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+)
+
+// ListPlansQuery 定义了获取计划列表时的查询参数
+type ListPlansQuery struct {
+	PlanType repository.PlanTypeFilter `json:"plan_type" query:"planType"`  // 计划类型
+	Page     int                       `json:"page" query:"page"`           // 页码
+	PageSize int                       `json:"page_size" query:"page_size"` // 每页大小
+}
 
 // CreatePlanRequest 定义创建计划请求的结构体
 type CreatePlanRequest struct {
-	Name           string                   `json:"name" binding:"required" example:"猪舍温度控制计划"`
+	Name           string                   `json:"name" validate:"required" example:"猪舍温度控制计划"`
 	Description    string                   `json:"description" example:"根据温度自动调节风扇和加热器"`
-	ExecutionType  models.PlanExecutionType `json:"execution_type" binding:"required" example:"自动"`
-	ExecuteNum     uint                     `json:"execute_num,omitempty" example:"10"`
-	CronExpression string                   `json:"cron_expression" example:"0 0 6 * * *"`
-	SubPlanIDs     []uint                   `json:"sub_plan_ids,omitempty"`
-	Tasks          []TaskRequest            `json:"tasks,omitempty"`
+	ExecutionType  models.PlanExecutionType `json:"execution_type" validate:"required" example:"自动"`
+	ExecuteNum     uint                     `json:"execute_num,omitempty" validate:"omitempty,min=0" example:"10"`
+	CronExpression string                   `json:"cron_expression" validate:"omitempty,cron" example:"0 0 6 * * *"`
+	SubPlanIDs     []uint                   `json:"sub_plan_ids,omitempty" validate:"omitempty,dive"`
+	Tasks          []TaskRequest            `json:"tasks,omitempty" validate:"omitempty,dive"`
 }
 
 // PlanResponse 定义计划详情响应的结构体
@@ -18,6 +28,7 @@ type PlanResponse struct {
 	ID             uint                     `json:"id" example:"1"`
 	Name           string                   `json:"name" example:"猪舍温度控制计划"`
 	Description    string                   `json:"description" example:"根据温度自动调节风扇和加热器"`
+	PlanType       models.PlanType          `json:"plan_type" example:"自定义任务"`
 	ExecutionType  models.PlanExecutionType `json:"execution_type" example:"自动"`
 	Status         models.PlanStatus        `json:"status" example:"已启用"`
 	ExecuteNum     uint                     `json:"execute_num" example:"10"`
@@ -31,18 +42,18 @@ type PlanResponse struct {
 // ListPlansResponse 定义获取计划列表响应的结构体
 type ListPlansResponse struct {
 	Plans []PlanResponse `json:"plans"`
-	Total int            `json:"total" example:"100"`
+	Total int64          `json:"total" example:"100"`
 }
 
 // UpdatePlanRequest 定义更新计划请求的结构体
 type UpdatePlanRequest struct {
 	Name           string                   `json:"name" example:"猪舍温度控制计划V2"`
 	Description    string                   `json:"description" example:"更新后的描述"`
-	ExecutionType  models.PlanExecutionType `json:"execution_type" binding:"required" example:"自动"`
-	ExecuteNum     uint                     `json:"execute_num,omitempty" example:"10"`
-	CronExpression string                   `json:"cron_expression" example:"0 0 6 * * *"`
-	SubPlanIDs     []uint                   `json:"sub_plan_ids,omitempty"`
-	Tasks          []TaskRequest            `json:"tasks,omitempty"`
+	ExecutionType  models.PlanExecutionType `json:"execution_type" validate:"required" example:"自动"`
+	ExecuteNum     uint                     `json:"execute_num,omitempty" validate:"omitempty,min=0" example:"10"`
+	CronExpression string                   `json:"cron_expression" validate:"omitempty,cron" example:"0 0 6 * * *"`
+	SubPlanIDs     []uint                   `json:"sub_plan_ids,omitempty" validate:"omitempty,dive"`
+	Tasks          []TaskRequest            `json:"tasks,omitempty" validate:"omitempty,dive"`
 }
 
 // SubPlanResponse 定义子计划响应结构体

internal/app/dto/user_dto.go

@@ -2,15 +2,15 @@ package dto
 
 // CreateUserRequest 定义创建用户请求的结构体
 type CreateUserRequest struct {
-	Username string `json:"username" binding:"required" example:"newuser"`
-	Password string `json:"password" binding:"required" example:"password123"`
+	Username string `json:"username" validate:"required" example:"newuser"`
+	Password string `json:"password" validate:"required" example:"password123"`
 }
 
 // LoginRequest 定义登录请求的结构体
 type LoginRequest struct {
 	// Identifier 可以是用户名、邮箱、手机号、微信号或飞书账号
-	Identifier string `json:"identifier" binding:"required" example:"testuser"`
-	Password   string `json:"password" binding:"required" example:"password123"`
+	Identifier string `json:"identifier" validate:"required" example:"testuser"`
+	Password   string `json:"password" validate:"required" example:"password123"`
 }
 
 // CreateUserResponse 定义创建用户成功响应的结构体

internal/app/middleware/audit.go

@@ -1,117 +1,59 @@
 package middleware
 
 import (
-	"bytes"
-	"encoding/json"
-	"io"
-	"strconv"
-
 	"git.huangwc.com/pig/pig-farm-controller/internal/domain/audit"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"github.com/gin-gonic/gin"
+	"github.com/labstack/echo/v4"
 )
 
-type auditResponse struct {
-	Code    int    `json:"code"`
-	Message string `json:"message"`
-}
+// AuditLogMiddleware 创建一个Echo中间件，用于在请求结束后记录用户操作审计日志。
+// 它依赖于控制器通过调用 SendSuccessWithAudit 或 SendErrorWithAudit 在上下文中设置的审计信息。
+func AuditLogMiddleware(auditService audit.Service) echo.MiddlewareFunc {
+	return func(next echo.HandlerFunc) echo.HandlerFunc {
+		return func(c echo.Context) error {
+			// 首先执行请求链中的后续处理程序（即业务控制器）
+			err := next(c)
 
-// AuditLogMiddleware 创建一个Gin中间件，用于在请求结束后记录用户操作审计日志
-func AuditLogMiddleware(auditService audit.Service) gin.HandlerFunc {
-	return func(c *gin.Context) {
-		// 使用自定义的 response body writer 来捕获响应体
-		blw := &bodyLogWriter{body: bytes.NewBufferString(""), ResponseWriter: c.Writer}
-		c.Writer = blw
+			// --- 在这里，请求已经处理完毕 ---
 
-		// 首先执行请求链中的后续处理程序（即业务控制器）
-		c.Next()
-
-		// --- 在这里，请求已经处理完毕 ---
-
-		// 从上下文中尝试获取由控制器设置的业务审计信息
-		actionType, exists := c.Get(models.ContextAuditActionType.String())
-		if !exists {
-			// 如果上下文中没有 actionType，说明此接口无需记录审计日志，直接返回
-			return
-		}
-
-		// 从 Gin Context 中获取用户对象
-		userCtx, userExists := c.Get(models.ContextUserKey.String())
-		var user *models.User
-		if userExists {
-			user, _ = userCtx.(*models.User)
-		}
-
-		// 构建 RequestContext
-		reqCtx := audit.RequestContext{
-			ClientIP:   c.ClientIP(),
-			HTTPPath:   c.Request.URL.Path,
-			HTTPMethod: c.Request.Method,
-		}
-
-		// 获取其他审计信息
-		description, _ := c.Get(models.ContextAuditDescription.String())
-		targetResource, _ := c.Get(models.ContextAuditTargetResource.String())
-
-		// 默认操作状态为成功
-		status := models.AuditStatusSuccess
-		resultDetails := ""
-
-		// 尝试从捕获的响应体中解析平台响应
-		var platformResponse auditResponse
-		if err := json.Unmarshal(blw.body.Bytes(), &platformResponse); err == nil {
-			// 如果解析成功，根据平台状态码判断操作是否失败
-			// 成功状态码范围是 2000-2999
-			if platformResponse.Code < 2000 || platformResponse.Code >= 3000 {
-				status = models.AuditStatusFailed
-				resultDetails = platformResponse.Message
+			// 从上下文中尝试获取由控制器设置的业务审计信息
+			actionType, exists := c.Get(models.ContextAuditActionType.String()).(string)
+			if !exists || actionType == "" {
+				// 如果上下文中没有 actionType，说明此接口无需记录审计日志，直接返回
+				return err
 			}
-		} else {
-			// 如果响应体不是预期的平台响应格式，或者解析失败，则记录原始HTTP状态码作为详情
-			// 并且如果HTTP状态码不是2xx，则标记为失败
-			if c.Writer.Status() < 200 || c.Writer.Status() >= 300 {
-				status = models.AuditStatusFailed
-			}
-			resultDetails = "HTTP Status: " + strconv.Itoa(c.Writer.Status()) + ", Body Parse Error: " + err.Error()
-		}
 
-		// 调用审计服务记录日志（异步）
-		auditService.LogAction(
-			user,
-			reqCtx,
-			actionType.(string),
-			description.(string),
-			targetResource,
-			status,
-			resultDetails,
-		)
+			// 从 Context 中获取用户对象
+			var user *models.User
+			if userCtx := c.Get(models.ContextUserKey.String()); userCtx != nil {
+				user, _ = userCtx.(*models.User)
+			}
+
+			// 构建 RequestContext
+			reqCtx := audit.RequestContext{
+				ClientIP:   c.RealIP(),
+				HTTPPath:   c.Request().URL.Path,
+				HTTPMethod: c.Request().Method,
+			}
+
+			// 直接从上下文中获取所有其他审计信息
+			description, _ := c.Get(models.ContextAuditDescription.String()).(string)
+			targetResource := c.Get(models.ContextAuditTargetResource.String())
+			status, _ := c.Get(models.ContextAuditStatus.String()).(models.AuditStatus)
+			resultDetails, _ := c.Get(models.ContextAuditResultDetails.String()).(string)
+
+			// 调用审计服务记录日志（异步）
+			auditService.LogAction(
+				user,
+				reqCtx,
+				actionType,
+				description,
+				targetResource,
+				status,
+				resultDetails,
+			)
+
+			return err
+		}
 	}
 }
-
-// bodyLogWriter 是一个自定义的 gin.ResponseWriter，用于捕获响应体
-// 这对于在操作失败时记录详细的错误信息非常有用
-type bodyLogWriter struct {
-	gin.ResponseWriter
-	body *bytes.Buffer
-}
-
-func (w bodyLogWriter) Write(b []byte) (int, error) {
-	w.body.Write(b)
-	return w.ResponseWriter.Write(b)
-}
-
-func (w bodyLogWriter) WriteString(s string) (int, error) {
-	w.body.WriteString(s)
-	return w.ResponseWriter.WriteString(s)
-}
-
-// ReadBody 用于安全地读取请求体，并防止其被重复读取
-func ReadBody(c *gin.Context) ([]byte, error) {
-	bodyBytes, err := io.ReadAll(c.Request.Body)
-	if err != nil {
-		return nil, err
-	}
-	// 将读取的内容放回 Body 中，以便后续的处理函数可以再次读取
-	c.Request.Body = io.NopCloser(bytes.NewBuffer(bodyBytes))
-	return bodyBytes, nil
-}

internal/app/middleware/auth.go

@@ -1,61 +1,60 @@
-// Package middleware 存放 gin 中间件
+// Package middleware 存放中间件
 package middleware
 
 import (
+	"errors"
 	"net/http"
 	"strings"
 
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
 	"git.huangwc.com/pig/pig-farm-controller/internal/domain/token"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
-	"github.com/gin-gonic/gin"
+	"github.com/labstack/echo/v4"
 	"gorm.io/gorm"
 )
 
-// AuthMiddleware 创建一个Gin中间件，用于JWT身份验证
+// AuthMiddleware 创建一个Echo中间件，用于JWT身份验证
 // 它依赖于 TokenService 来解析和验证 token，并使用 UserRepository 来获取完整的用户信息
-func AuthMiddleware(tokenService token.TokenService, userRepo repository.UserRepository) gin.HandlerFunc {
-	return func(c *gin.Context) {
-		// 从 Authorization header 获取 token
-		authHeader := c.GetHeader("Authorization")
-		if authHeader == "" {
-			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "请求未包含授权标头"})
-			return
-		}
-
-		// 授权标头的格式应为 "Bearer <token>"
-		parts := strings.Split(authHeader, " ")
-		if len(parts) != 2 || parts[0] != "Bearer" {
-			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "授权标头格式不正确"})
-			return
-		}
-
-		tokenString := parts[1]
-
-		// 解析和验证 token
-		claims, err := tokenService.ParseToken(tokenString)
-		if err != nil {
-			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "无效的Token"})
-			return
-		}
-
-		// 根据 token 中的用户ID，从数据库中获取完整的用户信息
-		user, err := userRepo.FindByID(claims.UserID)
-		if err != nil {
-			if err == gorm.ErrRecordNotFound {
-				// Token有效，但对应的用户已不存在
-				c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "授权用户不存在"})
-				return
+func AuthMiddleware(tokenService token.Service, userRepo repository.UserRepository) echo.MiddlewareFunc {
+	return func(next echo.HandlerFunc) echo.HandlerFunc {
+		return func(c echo.Context) error {
+			// 从 Authorization header 获取 token
+			authHeader := c.Request().Header.Get("Authorization")
+			if authHeader == "" {
+				return controller.SendErrorWithStatus(c, http.StatusUnauthorized, controller.CodeUnauthorized, "请求未包含授权标头")
 			}
-			// 其他数据库查询错误
-			c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "获取用户信息失败"})
-			return
+
+			// 授权标头的格式应为 "Bearer <token>"
+			parts := strings.Split(authHeader, " ")
+			if len(parts) != 2 || strings.ToLower(parts[0]) != "bearer" {
+				return controller.SendErrorWithStatus(c, http.StatusUnauthorized, controller.CodeUnauthorized, "授权标头格式不正确")
+			}
+
+			tokenString := parts[1]
+
+			// 解析和验证 token
+			claims, err := tokenService.ParseToken(tokenString)
+			if err != nil {
+				return controller.SendErrorWithStatus(c, http.StatusUnauthorized, controller.CodeUnauthorized, "无效的Token")
+			}
+
+			// 根据 token 中的用户ID，从数据库中获取完整的用户信息
+			user, err := userRepo.FindByID(claims.UserID)
+			if err != nil {
+				if errors.Is(err, gorm.ErrRecordNotFound) {
+					// Token有效，但对应的用户已不存在
+					return controller.SendErrorWithStatus(c, http.StatusUnauthorized, controller.CodeUnauthorized, "授权用户不存在")
+				}
+				// 其他数据库查询错误
+				return controller.SendErrorWithStatus(c, http.StatusInternalServerError, controller.CodeInternalError, "获取用户信息失败")
+			}
+
+			// 将完整的用户对象存储在 context 中，以便后续的处理函数使用
+			c.Set(models.ContextUserKey.String(), user)
+
+			// 继续处理请求链中的下一个处理程序
+			return next(c)
 		}
-
-		// 将完整的用户对象存储在 context 中，以便后续的处理函数使用
-		c.Set(models.ContextUserKey.String(), user)
-
-		// 继续处理请求链中的下一个处理程序
-		c.Next()
 	}
 }

internal/app/service/device_service.go

@@ -0,0 +1,389 @@
+package service
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/device"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+)
+
+var (
+	// ErrDeviceInUse 表示设备正在被任务使用，无法删除
+	ErrDeviceInUse = errors.New("设备正在被一个或多个任务使用，无法删除")
+
+	// ErrAreaControllerInUse 表示区域主控正在被设备使用，无法删除
+	ErrAreaControllerInUse = errors.New("区域主控正在被一个或多个设备使用，无法删除")
+
+	// ErrDeviceTemplateInUse 表示设备模板正在被设备使用，无法删除
+	ErrDeviceTemplateInUse = errors.New("设备模板正在被一个或多个设备使用，无法删除")
+)
+
+// DeviceService 定义了应用层的设备服务接口，用于协调设备相关的业务逻辑。
+// DeviceService 定义了应用层的设备服务接口，用于协调设备相关的业务逻辑。
+type DeviceService interface {
+	CreateDevice(req *dto.CreateDeviceRequest) (*dto.DeviceResponse, error)
+	GetDevice(id uint) (*dto.DeviceResponse, error)
+	ListDevices() ([]*dto.DeviceResponse, error)
+	UpdateDevice(id uint, req *dto.UpdateDeviceRequest) (*dto.DeviceResponse, error)
+	DeleteDevice(id uint) error
+	ManualControl(id uint, req *dto.ManualControlDeviceRequest) error
+
+	CreateAreaController(req *dto.CreateAreaControllerRequest) (*dto.AreaControllerResponse, error)
+	GetAreaController(id uint) (*dto.AreaControllerResponse, error)
+	ListAreaControllers() ([]*dto.AreaControllerResponse, error)
+	UpdateAreaController(id uint, req *dto.UpdateAreaControllerRequest) (*dto.AreaControllerResponse, error)
+	DeleteAreaController(id uint) error
+
+	CreateDeviceTemplate(req *dto.CreateDeviceTemplateRequest) (*dto.DeviceTemplateResponse, error)
+	GetDeviceTemplate(id uint) (*dto.DeviceTemplateResponse, error)
+	ListDeviceTemplates() ([]*dto.DeviceTemplateResponse, error)
+	UpdateDeviceTemplate(id uint, req *dto.UpdateDeviceTemplateRequest) (*dto.DeviceTemplateResponse, error)
+	DeleteDeviceTemplate(id uint) error
+}
+
+// deviceService 是 DeviceService 接口的具体实现。
+type deviceService struct {
+	deviceRepo         repository.DeviceRepository
+	areaControllerRepo repository.AreaControllerRepository
+	deviceTemplateRepo repository.DeviceTemplateRepository
+	deviceDomainSvc    device.Service // 依赖领域服务
+}
+
+// NewDeviceService 创建一个新的 DeviceService 实例。
+func NewDeviceService(
+	deviceRepo repository.DeviceRepository,
+	areaControllerRepo repository.AreaControllerRepository,
+	deviceTemplateRepo repository.DeviceTemplateRepository,
+	deviceDomainSvc device.Service,
+) DeviceService {
+	return &deviceService{
+		deviceRepo:         deviceRepo,
+		areaControllerRepo: areaControllerRepo,
+		deviceTemplateRepo: deviceTemplateRepo,
+		deviceDomainSvc:    deviceDomainSvc,
+	}
+}
+
+// --- Devices ---
+
+func (s *deviceService) CreateDevice(req *dto.CreateDeviceRequest) (*dto.DeviceResponse, error) {
+	propertiesJSON, err := json.Marshal(req.Properties)
+	if err != nil {
+		return nil, err // Consider wrapping this error for better context
+	}
+
+	device := &models.Device{
+		Name:             req.Name,
+		DeviceTemplateID: req.DeviceTemplateID,
+		AreaControllerID: req.AreaControllerID,
+		Location:         req.Location,
+		Properties:       propertiesJSON,
+	}
+
+	if err := device.SelfCheck(); err != nil {
+		return nil, err
+	}
+
+	if err := s.deviceRepo.Create(device); err != nil {
+		return nil, err
+	}
+
+	createdDevice, err := s.deviceRepo.FindByID(device.ID)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewDeviceResponse(createdDevice)
+}
+
+func (s *deviceService) GetDevice(id uint) (*dto.DeviceResponse, error) {
+	device, err := s.deviceRepo.FindByID(id)
+	if err != nil {
+		return nil, err
+	}
+	return dto.NewDeviceResponse(device)
+}
+
+func (s *deviceService) ListDevices() ([]*dto.DeviceResponse, error) {
+	devices, err := s.deviceRepo.ListAll()
+	if err != nil {
+		return nil, err
+	}
+	return dto.NewListDeviceResponse(devices)
+}
+
+func (s *deviceService) UpdateDevice(id uint, req *dto.UpdateDeviceRequest) (*dto.DeviceResponse, error) {
+	existingDevice, err := s.deviceRepo.FindByID(id)
+	if err != nil {
+		return nil, err
+	}
+
+	propertiesJSON, err := json.Marshal(req.Properties)
+	if err != nil {
+		return nil, err
+	}
+
+	existingDevice.Name = req.Name
+	existingDevice.DeviceTemplateID = req.DeviceTemplateID
+	existingDevice.AreaControllerID = req.AreaControllerID
+	existingDevice.Location = req.Location
+	existingDevice.Properties = propertiesJSON
+
+	if err := existingDevice.SelfCheck(); err != nil {
+		return nil, err
+	}
+
+	if err := s.deviceRepo.Update(existingDevice); err != nil {
+		return nil, err
+	}
+
+	updatedDevice, err := s.deviceRepo.FindByID(existingDevice.ID)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewDeviceResponse(updatedDevice)
+}
+
+func (s *deviceService) DeleteDevice(id uint) error {
+
+	// 检查设备是否存在
+	_, err := s.deviceRepo.FindByID(id)
+	if err != nil {
+		return err // 如果未找到，会返回 gorm.ErrRecordNotFound
+	}
+
+	// 在删除前检查设备是否被任务使用
+	inUse, err := s.deviceRepo.IsDeviceInUse(id)
+	if err != nil {
+		// 如果检查过程中发生数据库错误，则返回错误
+		return fmt.Errorf("检查设备使用情况失败: %w", err)
+	}
+	if inUse {
+		// 如果设备正在被使用，则返回特定的业务错误
+		return ErrDeviceInUse
+	}
+
+	// 只有在未被使用时，才执行删除操作
+	return s.deviceRepo.Delete(id)
+}
+
+func (s *deviceService) ManualControl(id uint, req *dto.ManualControlDeviceRequest) error {
+	dev, err := s.deviceRepo.FindByID(id)
+	if err != nil {
+		return err
+	}
+
+	if req.Action == nil {
+		return s.deviceDomainSvc.Collect(dev.AreaControllerID, []*models.Device{dev})
+	} else {
+		action := device.DeviceActionStart
+		switch *req.Action {
+		case "off":
+			action = device.DeviceActionStop
+		case "on":
+			action = device.DeviceActionStart
+		default:
+			return errors.New("invalid action")
+		}
+		return s.deviceDomainSvc.Switch(dev, action)
+	}
+}
+
+// --- Area Controllers ---
+
+func (s *deviceService) CreateAreaController(req *dto.CreateAreaControllerRequest) (*dto.AreaControllerResponse, error) {
+	propertiesJSON, err := json.Marshal(req.Properties)
+	if err != nil {
+		return nil, err
+	}
+
+	ac := &models.AreaController{
+		Name:       req.Name,
+		NetworkID:  req.NetworkID,
+		Location:   req.Location,
+		Properties: propertiesJSON,
+	}
+
+	if err := ac.SelfCheck(); err != nil {
+		return nil, err
+	}
+
+	if err := s.areaControllerRepo.Create(ac); err != nil {
+		return nil, err
+	}
+
+	return dto.NewAreaControllerResponse(ac)
+}
+
+func (s *deviceService) GetAreaController(id uint) (*dto.AreaControllerResponse, error) {
+	ac, err := s.areaControllerRepo.FindByID(id)
+	if err != nil {
+		return nil, err
+	}
+	return dto.NewAreaControllerResponse(ac)
+}
+
+func (s *deviceService) ListAreaControllers() ([]*dto.AreaControllerResponse, error) {
+	acs, err := s.areaControllerRepo.ListAll()
+	if err != nil {
+		return nil, err
+	}
+	return dto.NewListAreaControllerResponse(acs)
+}
+
+func (s *deviceService) UpdateAreaController(id uint, req *dto.UpdateAreaControllerRequest) (*dto.AreaControllerResponse, error) {
+	existingAC, err := s.areaControllerRepo.FindByID(id)
+	if err != nil {
+		return nil, err
+	}
+
+	propertiesJSON, err := json.Marshal(req.Properties)
+	if err != nil {
+		return nil, err
+	}
+
+	existingAC.Name = req.Name
+	existingAC.NetworkID = req.NetworkID
+	existingAC.Location = req.Location
+	existingAC.Properties = propertiesJSON
+
+	if err := existingAC.SelfCheck(); err != nil {
+		return nil, err
+	}
+
+	if err := s.areaControllerRepo.Update(existingAC); err != nil {
+		return nil, err
+	}
+
+	return dto.NewAreaControllerResponse(existingAC)
+}
+
+func (s *deviceService) DeleteAreaController(id uint) error {
+
+	// 1. 检查是否存在
+	_, err := s.areaControllerRepo.FindByID(id)
+	if err != nil {
+		return err // 如果未找到，gorm会返回 ErrRecordNotFound
+	}
+
+	// 2. 检查是否被使用（业务逻辑）
+	inUse, err := s.deviceRepo.IsAreaControllerInUse(id)
+	if err != nil {
+		return err // 返回数据库检查错误
+	}
+	if inUse {
+		return ErrAreaControllerInUse // 返回业务错误
+	}
+
+	// 3. 执行删除
+	return s.areaControllerRepo.Delete(id)
+}
+
+// --- Device Templates ---
+
+func (s *deviceService) CreateDeviceTemplate(req *dto.CreateDeviceTemplateRequest) (*dto.DeviceTemplateResponse, error) {
+	commandsJSON, err := json.Marshal(req.Commands)
+	if err != nil {
+		return nil, err
+	}
+
+	valuesJSON, err := json.Marshal(req.Values)
+	if err != nil {
+		return nil, err
+	}
+
+	deviceTemplate := &models.DeviceTemplate{
+		Name:         req.Name,
+		Manufacturer: req.Manufacturer,
+		Description:  req.Description,
+		Category:     req.Category,
+		Commands:     commandsJSON,
+		Values:       valuesJSON,
+	}
+
+	if err := deviceTemplate.SelfCheck(); err != nil {
+		return nil, err
+	}
+
+	if err := s.deviceTemplateRepo.Create(deviceTemplate); err != nil {
+		return nil, err
+	}
+
+	return dto.NewDeviceTemplateResponse(deviceTemplate)
+}
+
+func (s *deviceService) GetDeviceTemplate(id uint) (*dto.DeviceTemplateResponse, error) {
+	deviceTemplate, err := s.deviceTemplateRepo.FindByID(id)
+	if err != nil {
+		return nil, err
+	}
+	return dto.NewDeviceTemplateResponse(deviceTemplate)
+}
+
+func (s *deviceService) ListDeviceTemplates() ([]*dto.DeviceTemplateResponse, error) {
+	deviceTemplates, err := s.deviceTemplateRepo.ListAll()
+	if err != nil {
+		return nil, err
+	}
+	return dto.NewListDeviceTemplateResponse(deviceTemplates)
+}
+
+func (s *deviceService) UpdateDeviceTemplate(id uint, req *dto.UpdateDeviceTemplateRequest) (*dto.DeviceTemplateResponse, error) {
+	existingDeviceTemplate, err := s.deviceTemplateRepo.FindByID(id)
+	if err != nil {
+		return nil, err
+	}
+
+	commandsJSON, err := json.Marshal(req.Commands)
+	if err != nil {
+		return nil, err
+	}
+
+	valuesJSON, err := json.Marshal(req.Values)
+	if err != nil {
+		return nil, err
+	}
+
+	existingDeviceTemplate.Name = req.Name
+	existingDeviceTemplate.Manufacturer = req.Manufacturer
+	existingDeviceTemplate.Description = req.Description
+	existingDeviceTemplate.Category = req.Category
+	existingDeviceTemplate.Commands = commandsJSON
+	existingDeviceTemplate.Values = valuesJSON
+
+	if err := existingDeviceTemplate.SelfCheck(); err != nil {
+		return nil, err
+	}
+
+	if err := s.deviceTemplateRepo.Update(existingDeviceTemplate); err != nil {
+		return nil, err
+	}
+
+	return dto.NewDeviceTemplateResponse(existingDeviceTemplate)
+}
+
+func (s *deviceService) DeleteDeviceTemplate(id uint) error {
+
+	// 1. 检查是否存在
+	_, err := s.deviceTemplateRepo.FindByID(id)
+	if err != nil {
+		return err
+	}
+
+	// 2. 检查是否被使用（业务逻辑）
+	inUse, err := s.deviceTemplateRepo.IsInUse(id)
+	if err != nil {
+		return err
+	}
+	if inUse {
+		return ErrDeviceTemplateInUse // 返回业务错误
+	}
+
+	// 3. 执行删除
+	return s.deviceTemplateRepo.Delete(id)
+}

internal/app/service/monitor_service.go

@@ -0,0 +1,474 @@
+package service
+
+import (
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+)
+
+// MonitorService 定义了监控相关的业务逻辑服务接口
+type MonitorService interface {
+	ListSensorData(req *dto.ListSensorDataRequest) (*dto.ListSensorDataResponse, error)
+	ListDeviceCommandLogs(req *dto.ListDeviceCommandLogRequest) (*dto.ListDeviceCommandLogResponse, error)
+	ListPlanExecutionLogs(req *dto.ListPlanExecutionLogRequest) (*dto.ListPlanExecutionLogResponse, error)
+	ListTaskExecutionLogs(req *dto.ListTaskExecutionLogRequest) (*dto.ListTaskExecutionLogResponse, error)
+	ListPendingCollections(req *dto.ListPendingCollectionRequest) (*dto.ListPendingCollectionResponse, error)
+	ListUserActionLogs(req *dto.ListUserActionLogRequest) (*dto.ListUserActionLogResponse, error)
+	ListRawMaterialPurchases(req *dto.ListRawMaterialPurchaseRequest) (*dto.ListRawMaterialPurchaseResponse, error)
+	ListRawMaterialStockLogs(req *dto.ListRawMaterialStockLogRequest) (*dto.ListRawMaterialStockLogResponse, error)
+	ListFeedUsageRecords(req *dto.ListFeedUsageRecordRequest) (*dto.ListFeedUsageRecordResponse, error)
+	ListMedicationLogs(req *dto.ListMedicationLogRequest) (*dto.ListMedicationLogResponse, error)
+	ListPigBatchLogs(req *dto.ListPigBatchLogRequest) (*dto.ListPigBatchLogResponse, error)
+	ListWeighingBatches(req *dto.ListWeighingBatchRequest) (*dto.ListWeighingBatchResponse, error)
+	ListWeighingRecords(req *dto.ListWeighingRecordRequest) (*dto.ListWeighingRecordResponse, error)
+	ListPigTransferLogs(req *dto.ListPigTransferLogRequest) (*dto.ListPigTransferLogResponse, error)
+	ListPigSickLogs(req *dto.ListPigSickLogRequest) (*dto.ListPigSickLogResponse, error)
+	ListPigPurchases(req *dto.ListPigPurchaseRequest) (*dto.ListPigPurchaseResponse, error)
+	ListPigSales(req *dto.ListPigSaleRequest) (*dto.ListPigSaleResponse, error)
+	ListNotifications(req *dto.ListNotificationRequest) (*dto.ListNotificationResponse, error)
+}
+
+// monitorService 是 MonitorService 接口的具体实现
+type monitorService struct {
+	sensorDataRepo        repository.SensorDataRepository
+	deviceCommandLogRepo  repository.DeviceCommandLogRepository
+	executionLogRepo      repository.ExecutionLogRepository
+	planRepository        repository.PlanRepository
+	pendingCollectionRepo repository.PendingCollectionRepository
+	userActionLogRepo     repository.UserActionLogRepository
+	rawMaterialRepo       repository.RawMaterialRepository
+	medicationRepo        repository.MedicationLogRepository
+	pigBatchRepo          repository.PigBatchRepository
+	pigBatchLogRepo       repository.PigBatchLogRepository
+	pigTransferLogRepo    repository.PigTransferLogRepository
+	pigSickLogRepo        repository.PigSickLogRepository
+	pigTradeRepo          repository.PigTradeRepository
+	notificationRepo      repository.NotificationRepository
+}
+
+// NewMonitorService 创建一个新的 MonitorService 实例
+func NewMonitorService(
+	sensorDataRepo repository.SensorDataRepository,
+	deviceCommandLogRepo repository.DeviceCommandLogRepository,
+	executionLogRepo repository.ExecutionLogRepository,
+	planRepository repository.PlanRepository,
+	pendingCollectionRepo repository.PendingCollectionRepository,
+	userActionLogRepo repository.UserActionLogRepository,
+	rawMaterialRepo repository.RawMaterialRepository,
+	medicationRepo repository.MedicationLogRepository,
+	pigBatchRepo repository.PigBatchRepository,
+	pigBatchLogRepo repository.PigBatchLogRepository,
+	pigTransferLogRepo repository.PigTransferLogRepository,
+	pigSickLogRepo repository.PigSickLogRepository,
+	pigTradeRepo repository.PigTradeRepository,
+	notificationRepo repository.NotificationRepository,
+) MonitorService {
+	return &monitorService{
+		sensorDataRepo:        sensorDataRepo,
+		deviceCommandLogRepo:  deviceCommandLogRepo,
+		executionLogRepo:      executionLogRepo,
+		planRepository:        planRepository,
+		pendingCollectionRepo: pendingCollectionRepo,
+		userActionLogRepo:     userActionLogRepo,
+		rawMaterialRepo:       rawMaterialRepo,
+		medicationRepo:        medicationRepo,
+		pigBatchRepo:          pigBatchRepo,
+		pigBatchLogRepo:       pigBatchLogRepo,
+		pigTransferLogRepo:    pigTransferLogRepo,
+		pigSickLogRepo:        pigSickLogRepo,
+		pigTradeRepo:          pigTradeRepo,
+		notificationRepo:      notificationRepo,
+	}
+}
+
+// ListSensorData 负责处理查询传感器数据列表的业务逻辑
+func (s *monitorService) ListSensorData(req *dto.ListSensorDataRequest) (*dto.ListSensorDataResponse, error) {
+	opts := repository.SensorDataListOptions{
+		DeviceID:  req.DeviceID,
+		OrderBy:   req.OrderBy,
+		StartTime: req.StartTime,
+		EndTime:   req.EndTime,
+	}
+	if req.SensorType != nil {
+		sensorType := models.SensorType(*req.SensorType)
+		opts.SensorType = &sensorType
+	}
+
+	data, total, err := s.sensorDataRepo.List(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListSensorDataResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListDeviceCommandLogs 负责处理查询设备命令日志列表的业务逻辑
+func (s *monitorService) ListDeviceCommandLogs(req *dto.ListDeviceCommandLogRequest) (*dto.ListDeviceCommandLogResponse, error) {
+	opts := repository.DeviceCommandLogListOptions{
+		DeviceID:        req.DeviceID,
+		ReceivedSuccess: req.ReceivedSuccess,
+		OrderBy:         req.OrderBy,
+		StartTime:       req.StartTime,
+		EndTime:         req.EndTime,
+	}
+
+	data, total, err := s.deviceCommandLogRepo.List(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListDeviceCommandLogResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListPlanExecutionLogs 负责处理查询计划执行日志列表的业务逻辑
+func (s *monitorService) ListPlanExecutionLogs(req *dto.ListPlanExecutionLogRequest) (*dto.ListPlanExecutionLogResponse, error) {
+	opts := repository.PlanExecutionLogListOptions{
+		PlanID:    req.PlanID,
+		OrderBy:   req.OrderBy,
+		StartTime: req.StartTime,
+		EndTime:   req.EndTime,
+	}
+	if req.Status != nil {
+		status := models.ExecutionStatus(*req.Status)
+		opts.Status = &status
+	}
+
+	planLogs, total, err := s.executionLogRepo.ListPlanExecutionLogs(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	planIds := make([]uint, 0, len(planLogs))
+	for _, datum := range planLogs {
+		has := false
+		for _, id := range planIds {
+			if id == datum.PlanID {
+				has = true
+				break
+			}
+		}
+		if !has {
+			planIds = append(planIds, datum.PlanID)
+		}
+	}
+	plans, err := s.planRepository.GetPlansByIDs(planIds)
+	if err != nil {
+		return nil, err
+	}
+	return dto.NewListPlanExecutionLogResponse(planLogs, plans, total, req.Page, req.PageSize), nil
+}
+
+// ListTaskExecutionLogs 负责处理查询任务执行日志列表的业务逻辑
+func (s *monitorService) ListTaskExecutionLogs(req *dto.ListTaskExecutionLogRequest) (*dto.ListTaskExecutionLogResponse, error) {
+	opts := repository.TaskExecutionLogListOptions{
+		PlanExecutionLogID: req.PlanExecutionLogID,
+		TaskID:             req.TaskID,
+		OrderBy:            req.OrderBy,
+		StartTime:          req.StartTime,
+		EndTime:            req.EndTime,
+	}
+	if req.Status != nil {
+		status := models.ExecutionStatus(*req.Status)
+		opts.Status = &status
+	}
+
+	data, total, err := s.executionLogRepo.ListTaskExecutionLogs(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListTaskExecutionLogResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListPendingCollections 负责处理查询待采集请求列表的业务逻辑
+func (s *monitorService) ListPendingCollections(req *dto.ListPendingCollectionRequest) (*dto.ListPendingCollectionResponse, error) {
+	opts := repository.PendingCollectionListOptions{
+		DeviceID:  req.DeviceID,
+		OrderBy:   req.OrderBy,
+		StartTime: req.StartTime,
+		EndTime:   req.EndTime,
+	}
+	if req.Status != nil {
+		status := models.PendingCollectionStatus(*req.Status)
+		opts.Status = &status
+	}
+
+	data, total, err := s.pendingCollectionRepo.List(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListPendingCollectionResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListUserActionLogs 负责处理查询用户操作日志列表的业务逻辑
+func (s *monitorService) ListUserActionLogs(req *dto.ListUserActionLogRequest) (*dto.ListUserActionLogResponse, error) {
+	opts := repository.UserActionLogListOptions{
+		UserID:     req.UserID,
+		Username:   req.Username,
+		ActionType: req.ActionType,
+		OrderBy:    req.OrderBy,
+		StartTime:  req.StartTime,
+		EndTime:    req.EndTime,
+	}
+	if req.Status != nil {
+		status := models.AuditStatus(*req.Status)
+		opts.Status = &status
+	}
+
+	data, total, err := s.userActionLogRepo.List(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListUserActionLogResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListRawMaterialPurchases 负责处理查询原料采购记录列表的业务逻辑
+func (s *monitorService) ListRawMaterialPurchases(req *dto.ListRawMaterialPurchaseRequest) (*dto.ListRawMaterialPurchaseResponse, error) {
+	opts := repository.RawMaterialPurchaseListOptions{
+		RawMaterialID: req.RawMaterialID,
+		Supplier:      req.Supplier,
+		OrderBy:       req.OrderBy,
+		StartTime:     req.StartTime,
+		EndTime:       req.EndTime,
+	}
+
+	data, total, err := s.rawMaterialRepo.ListRawMaterialPurchases(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListRawMaterialPurchaseResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListRawMaterialStockLogs 负责处理查询原料库存日志列表的业务逻辑
+func (s *monitorService) ListRawMaterialStockLogs(req *dto.ListRawMaterialStockLogRequest) (*dto.ListRawMaterialStockLogResponse, error) {
+	opts := repository.RawMaterialStockLogListOptions{
+		RawMaterialID: req.RawMaterialID,
+		SourceID:      req.SourceID,
+		OrderBy:       req.OrderBy,
+		StartTime:     req.StartTime,
+		EndTime:       req.EndTime,
+	}
+	if req.SourceType != nil {
+		sourceType := models.StockLogSourceType(*req.SourceType)
+		opts.SourceType = &sourceType
+	}
+
+	data, total, err := s.rawMaterialRepo.ListRawMaterialStockLogs(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListRawMaterialStockLogResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListFeedUsageRecords 负责处理查询饲料使用记录列表的业务逻辑
+func (s *monitorService) ListFeedUsageRecords(req *dto.ListFeedUsageRecordRequest) (*dto.ListFeedUsageRecordResponse, error) {
+	opts := repository.FeedUsageRecordListOptions{
+		PenID:         req.PenID,
+		FeedFormulaID: req.FeedFormulaID,
+		OperatorID:    req.OperatorID,
+		OrderBy:       req.OrderBy,
+		StartTime:     req.StartTime,
+		EndTime:       req.EndTime,
+	}
+
+	data, total, err := s.rawMaterialRepo.ListFeedUsageRecords(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListFeedUsageRecordResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListMedicationLogs 负责处理查询用药记录列表的业务逻辑
+func (s *monitorService) ListMedicationLogs(req *dto.ListMedicationLogRequest) (*dto.ListMedicationLogResponse, error) {
+	opts := repository.MedicationLogListOptions{
+		PigBatchID:   req.PigBatchID,
+		MedicationID: req.MedicationID,
+		OperatorID:   req.OperatorID,
+		OrderBy:      req.OrderBy,
+		StartTime:    req.StartTime,
+		EndTime:      req.EndTime,
+	}
+	if req.Reason != nil {
+		reason := models.MedicationReasonType(*req.Reason)
+		opts.Reason = &reason
+	}
+
+	data, total, err := s.medicationRepo.ListMedicationLogs(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListMedicationLogResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListPigBatchLogs 负责处理查询猪批次日志列表的业务逻辑
+func (s *monitorService) ListPigBatchLogs(req *dto.ListPigBatchLogRequest) (*dto.ListPigBatchLogResponse, error) {
+	opts := repository.PigBatchLogListOptions{
+		PigBatchID: req.PigBatchID,
+		OperatorID: req.OperatorID,
+		OrderBy:    req.OrderBy,
+		StartTime:  req.StartTime,
+		EndTime:    req.EndTime,
+	}
+	if req.ChangeType != nil {
+		changeType := models.LogChangeType(*req.ChangeType)
+		opts.ChangeType = &changeType
+	}
+
+	data, total, err := s.pigBatchLogRepo.List(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListPigBatchLogResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListWeighingBatches 负责处理查询批次称重记录列表的业务逻辑
+func (s *monitorService) ListWeighingBatches(req *dto.ListWeighingBatchRequest) (*dto.ListWeighingBatchResponse, error) {
+	opts := repository.WeighingBatchListOptions{
+		PigBatchID: req.PigBatchID,
+		OrderBy:    req.OrderBy,
+		StartTime:  req.StartTime,
+		EndTime:    req.EndTime,
+	}
+
+	data, total, err := s.pigBatchRepo.ListWeighingBatches(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListWeighingBatchResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListWeighingRecords 负责处理查询单次称重记录列表的业务逻辑
+func (s *monitorService) ListWeighingRecords(req *dto.ListWeighingRecordRequest) (*dto.ListWeighingRecordResponse, error) {
+	opts := repository.WeighingRecordListOptions{
+		WeighingBatchID: req.WeighingBatchID,
+		PenID:           req.PenID,
+		OperatorID:      req.OperatorID,
+		OrderBy:         req.OrderBy,
+		StartTime:       req.StartTime,
+		EndTime:         req.EndTime,
+	}
+
+	data, total, err := s.pigBatchRepo.ListWeighingRecords(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListWeighingRecordResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListPigTransferLogs 负责处理查询猪只迁移日志列表的业务逻辑
+func (s *monitorService) ListPigTransferLogs(req *dto.ListPigTransferLogRequest) (*dto.ListPigTransferLogResponse, error) {
+	opts := repository.PigTransferLogListOptions{
+		PigBatchID:    req.PigBatchID,
+		PenID:         req.PenID,
+		OperatorID:    req.OperatorID,
+		CorrelationID: req.CorrelationID,
+		OrderBy:       req.OrderBy,
+		StartTime:     req.StartTime,
+		EndTime:       req.EndTime,
+	}
+	if req.TransferType != nil {
+		transferType := models.PigTransferType(*req.TransferType)
+		opts.TransferType = &transferType
+	}
+
+	data, total, err := s.pigTransferLogRepo.ListPigTransferLogs(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListPigTransferLogResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListPigSickLogs 负责处理查询病猪日志列表的业务逻辑
+func (s *monitorService) ListPigSickLogs(req *dto.ListPigSickLogRequest) (*dto.ListPigSickLogResponse, error) {
+	opts := repository.PigSickLogListOptions{
+		PigBatchID: req.PigBatchID,
+		PenID:      req.PenID,
+		OperatorID: req.OperatorID,
+		OrderBy:    req.OrderBy,
+		StartTime:  req.StartTime,
+		EndTime:    req.EndTime,
+	}
+	if req.Reason != nil {
+		reason := models.PigBatchSickPigReasonType(*req.Reason)
+		opts.Reason = &reason
+	}
+	if req.TreatmentLocation != nil {
+		treatmentLocation := models.PigBatchSickPigTreatmentLocation(*req.TreatmentLocation)
+		opts.TreatmentLocation = &treatmentLocation
+	}
+
+	data, total, err := s.pigSickLogRepo.ListPigSickLogs(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListPigSickLogResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListPigPurchases 负责处理查询猪只采购记录列表的业务逻辑
+func (s *monitorService) ListPigPurchases(req *dto.ListPigPurchaseRequest) (*dto.ListPigPurchaseResponse, error) {
+	opts := repository.PigPurchaseListOptions{
+		PigBatchID: req.PigBatchID,
+		Supplier:   req.Supplier,
+		OperatorID: req.OperatorID,
+		OrderBy:    req.OrderBy,
+		StartTime:  req.StartTime,
+		EndTime:    req.EndTime,
+	}
+
+	data, total, err := s.pigTradeRepo.ListPigPurchases(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListPigPurchaseResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListPigSales 负责处理查询猪只销售记录列表的业务逻辑
+func (s *monitorService) ListPigSales(req *dto.ListPigSaleRequest) (*dto.ListPigSaleResponse, error) {
+	opts := repository.PigSaleListOptions{
+		PigBatchID: req.PigBatchID,
+		Buyer:      req.Buyer,
+		OperatorID: req.OperatorID,
+		OrderBy:    req.OrderBy,
+		StartTime:  req.StartTime,
+		EndTime:    req.EndTime,
+	}
+
+	data, total, err := s.pigTradeRepo.ListPigSales(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListPigSaleResponse(data, total, req.Page, req.PageSize), nil
+}
+
+// ListNotifications 负责处理查询通知列表的业务逻辑
+func (s *monitorService) ListNotifications(req *dto.ListNotificationRequest) (*dto.ListNotificationResponse, error) {
+	opts := repository.NotificationListOptions{
+		UserID:       req.UserID,
+		NotifierType: req.NotifierType,
+		Level:        req.Level,
+		StartTime:    req.StartTime,
+		EndTime:      req.EndTime,
+		OrderBy:      req.OrderBy,
+		Status:       req.Status,
+	}
+
+	data, total, err := s.notificationRepo.List(opts, req.Page, req.PageSize)
+	if err != nil {
+		return nil, err
+	}
+
+	return dto.NewListNotificationResponse(data, total, req.Page, req.PageSize), nil
+}

internal/app/service/pig_batch_service.go

@@ -1,6 +1,8 @@
 package service
 
 import (
+	"time"
+
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
 	domain_pig "git.huangwc.com/pig/pig-farm-controller/internal/domain/pig"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
@@ -14,7 +16,30 @@ type PigBatchService interface {
 	UpdatePigBatch(id uint, dto *dto.PigBatchUpdateDTO) (*dto.PigBatchResponseDTO, error)
 	DeletePigBatch(id uint) error
 	ListPigBatches(isActive *bool) ([]*dto.PigBatchResponseDTO, error)
-	UpdatePigBatchPens(batchID uint, desiredPenIDs []uint) error
+
+	// Pig Pen Management
+	AssignEmptyPensToBatch(batchID uint, penIDs []uint, operatorID uint) error
+	ReclassifyPenToNewBatch(fromBatchID uint, toBatchID uint, penID uint, operatorID uint, remarks string) error
+	RemoveEmptyPenFromBatch(batchID uint, penID uint) error
+	MovePigsIntoPen(batchID uint, toPenID uint, quantity int, operatorID uint, remarks string) error
+
+	// Trade Sub-service
+	SellPigs(batchID uint, penID uint, quantity int, unitPrice float64, tatalPrice float64, traderName string, tradeDate time.Time, remarks string, operatorID uint) error
+	BuyPigs(batchID uint, penID uint, quantity int, unitPrice float64, tatalPrice float64, traderName string, tradeDate time.Time, remarks string, operatorID uint) error
+
+	// Transfer Sub-service
+	TransferPigsAcrossBatches(sourceBatchID uint, destBatchID uint, fromPenID uint, toPenID uint, quantity uint, operatorID uint, remarks string) error
+	TransferPigsWithinBatch(batchID uint, fromPenID uint, toPenID uint, quantity uint, operatorID uint, remarks string) error
+
+	// Sick Pig Management
+	RecordSickPigs(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error
+	RecordSickPigRecovery(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error
+	RecordSickPigDeath(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error
+	RecordSickPigCull(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error
+
+	// Normal Pig Management
+	RecordDeath(operatorID uint, batchID uint, penID uint, quantity int, happenedAt time.Time, remarks string) error
+	RecordCull(operatorID uint, batchID uint, penID uint, quantity int, happenedAt time.Time, remarks string) error
 }
 
 // pigBatchService 的实现现在依赖于领域服务接口。
@@ -32,21 +57,23 @@ func NewPigBatchService(domainService domain_pig.PigBatchService, logger *logs.L
 }
 
 // toPigBatchResponseDTO 负责将领域模型转换为应用层DTO，这个职责保留在应用层。
-func (s *pigBatchService) toPigBatchResponseDTO(batch *models.PigBatch) *dto.PigBatchResponseDTO {
+func (s *pigBatchService) toPigBatchResponseDTO(batch *models.PigBatch, currentTotalQuantity, currentTotalPigsInPens int) *dto.PigBatchResponseDTO {
 	if batch == nil {
 		return nil
 	}
 	return &dto.PigBatchResponseDTO{
-		ID:           batch.ID,
-		BatchNumber:  batch.BatchNumber,
-		OriginType:   batch.OriginType,
-		StartDate:    batch.StartDate,
-		EndDate:      batch.EndDate,
-		InitialCount: batch.InitialCount,
-		Status:       batch.Status,
-		IsActive:     batch.IsActive(),
-		CreateTime:   batch.CreatedAt,
-		UpdateTime:   batch.UpdatedAt,
+		ID:                     batch.ID,
+		BatchNumber:            batch.BatchNumber,
+		OriginType:             batch.OriginType,
+		StartDate:              batch.StartDate,
+		EndDate:                batch.EndDate,
+		InitialCount:           batch.InitialCount,
+		Status:                 batch.Status,
+		IsActive:               batch.IsActive(),
+		CurrentTotalQuantity:   currentTotalQuantity,
+		CurrentTotalPigsInPens: currentTotalPigsInPens,
+		CreateTime:             batch.CreatedAt,
+		UpdateTime:             batch.UpdatedAt,
 	}
 }
 
@@ -65,11 +92,11 @@ func (s *pigBatchService) CreatePigBatch(operatorID uint, dto *dto.PigBatchCreat
 	createdBatch, err := s.domainService.CreatePigBatch(operatorID, batch)
 	if err != nil {
 		s.logger.Errorf("应用层: 创建猪批次失败: %v", err)
-		return nil, mapDomainError(err)
+		return nil, MapDomainError(err)
 	}
 
 	// 3. 领域模型 -> DTO
-	return s.toPigBatchResponseDTO(createdBatch), nil
+	return s.toPigBatchResponseDTO(createdBatch, dto.InitialCount, 0), nil
 }
 
 // GetPigBatch 从领域服务获取数据并转换为DTO，同时处理错误转换。
@@ -77,10 +104,19 @@ func (s *pigBatchService) GetPigBatch(id uint) (*dto.PigBatchResponseDTO, error)
 	batch, err := s.domainService.GetPigBatch(id)
 	if err != nil {
 		s.logger.Warnf("应用层: 获取猪批次失败, ID: %d, 错误: %v", id, err)
-		return nil, mapDomainError(err)
+		return nil, MapDomainError(err)
 	}
-
-	return s.toPigBatchResponseDTO(batch), nil
+	currentTotalQuantity, err := s.domainService.GetCurrentPigQuantity(id)
+	if err != nil {
+		s.logger.Warnf("应用层: 获取猪批次总数失败, ID: %d, 错误: %v", id, err)
+		return nil, MapDomainError(err)
+	}
+	currentTotalPigsInPens, err := s.domainService.GetTotalPigsInPensForBatch(id)
+	if err != nil {
+		s.logger.Warnf("应用层: 获取猪批次存栏总数失败, ID: %d, 错误: %v", id, err)
+		return nil, MapDomainError(err)
+	}
+	return s.toPigBatchResponseDTO(batch, currentTotalQuantity, currentTotalPigsInPens), nil
 }
 
 // UpdatePigBatch 协调获取、更新和保存的流程，并处理错误转换。
@@ -89,7 +125,7 @@ func (s *pigBatchService) UpdatePigBatch(id uint, dto *dto.PigBatchUpdateDTO) (*
 	existingBatch, err := s.domainService.GetPigBatch(id)
 	if err != nil {
 		s.logger.Warnf("应用层: 更新猪批次失败，获取原批次信息错误, ID: %d, 错误: %v", id, err)
-		return nil, mapDomainError(err)
+		return nil, MapDomainError(err)
 	}
 
 	// 2. 将DTO中的变更应用到模型上
@@ -116,11 +152,23 @@ func (s *pigBatchService) UpdatePigBatch(id uint, dto *dto.PigBatchUpdateDTO) (*
 	updatedBatch, err := s.domainService.UpdatePigBatch(existingBatch)
 	if err != nil {
 		s.logger.Errorf("应用层: 更新猪批次失败, ID: %d, 错误: %v", id, err)
-		return nil, mapDomainError(err)
+		return nil, MapDomainError(err)
 	}
 
-	// 4. 转换并返回结果
-	return s.toPigBatchResponseDTO(updatedBatch), nil
+	// 4. 填充猪群信息
+	currentTotalQuantity, err := s.domainService.GetCurrentPigQuantity(id)
+	if err != nil {
+		s.logger.Warnf("应用层: 获取猪批次总数失败, ID: %d, 错误: %v", id, err)
+		return nil, MapDomainError(err)
+	}
+	currentTotalPigsInPens, err := s.domainService.GetTotalPigsInPensForBatch(id)
+	if err != nil {
+		s.logger.Warnf("应用层: 获取猪批次存栏总数失败, ID: %d, 错误: %v", id, err)
+		return nil, MapDomainError(err)
+	}
+
+	// 5. 转换并返回结果
+	return s.toPigBatchResponseDTO(updatedBatch, currentTotalQuantity, currentTotalPigsInPens), nil
 }
 
 // DeletePigBatch 将删除操作委托给领域服务，并转换领域错误为应用层错误。
@@ -128,7 +176,7 @@ func (s *pigBatchService) DeletePigBatch(id uint) error {
 	err := s.domainService.DeletePigBatch(id)
 	if err != nil {
 		s.logger.Errorf("应用层: 删除猪批次失败, ID: %d, 错误: %v", id, err)
-		return mapDomainError(err)
+		return MapDomainError(err)
 	}
 	return nil
 }
@@ -138,23 +186,163 @@ func (s *pigBatchService) ListPigBatches(isActive *bool) ([]*dto.PigBatchRespons
 	batches, err := s.domainService.ListPigBatches(isActive)
 	if err != nil {
 		s.logger.Errorf("应用层: 批量查询猪批次失败: %v", err)
-		return nil, mapDomainError(err)
+		return nil, MapDomainError(err)
 	}
 
 	var responseDTOs []*dto.PigBatchResponseDTO
 	for _, batch := range batches {
-		responseDTOs = append(responseDTOs, s.toPigBatchResponseDTO(batch))
+		currentTotalQuantity, err := s.domainService.GetCurrentPigQuantity(batch.ID)
+		if err != nil {
+			s.logger.Warnf("应用层: 获取猪批次总数失败, ID: %d, 错误: %v", batch.ID, err)
+			return nil, MapDomainError(err)
+		}
+		currentTotalPigsInPens, err := s.domainService.GetTotalPigsInPensForBatch(batch.ID)
+		if err != nil {
+			s.logger.Warnf("应用层: 获取猪批次存栏总数失败, ID: %d, 错误: %v", batch.ID, err)
+			return nil, MapDomainError(err)
+		}
+		responseDTOs = append(responseDTOs, s.toPigBatchResponseDTO(batch, currentTotalQuantity, currentTotalPigsInPens))
 	}
 
 	return responseDTOs, nil
 }
 
-// UpdatePigBatchPens 将关联猪栏的复杂操作委托给领域服务，并处理错误转换。
-func (s *pigBatchService) UpdatePigBatchPens(batchID uint, desiredPenIDs []uint) error {
-	err := s.domainService.UpdatePigBatchPens(batchID, desiredPenIDs)
+// AssignEmptyPensToBatch 委托给领域服务
+func (s *pigBatchService) AssignEmptyPensToBatch(batchID uint, penIDs []uint, operatorID uint) error {
+	err := s.domainService.AssignEmptyPensToBatch(batchID, penIDs, operatorID)
 	if err != nil {
-		s.logger.Errorf("应用层: 更新猪批次猪栏关联失败, 批次ID: %d, 错误: %v", batchID, err)
-		return mapDomainError(err)
+		s.logger.Errorf("应用层: 为猪批次分配空栏失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// ReclassifyPenToNewBatch 委托给领域服务
+func (s *pigBatchService) ReclassifyPenToNewBatch(fromBatchID uint, toBatchID uint, penID uint, operatorID uint, remarks string) error {
+	err := s.domainService.ReclassifyPenToNewBatch(fromBatchID, toBatchID, penID, operatorID, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 划拨猪栏到新批次失败, 源批次ID: %d, 错误: %v", fromBatchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// RemoveEmptyPenFromBatch 委托给领域服务
+func (s *pigBatchService) RemoveEmptyPenFromBatch(batchID uint, penID uint) error {
+	err := s.domainService.RemoveEmptyPenFromBatch(batchID, penID)
+	if err != nil {
+		s.logger.Errorf("应用层: 从猪批次移除空栏失败, 批次ID: %d, 猪栏ID: %d, 错误: %v", batchID, penID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// MovePigsIntoPen 委托给领域服务
+func (s *pigBatchService) MovePigsIntoPen(batchID uint, toPenID uint, quantity int, operatorID uint, remarks string) error {
+	err := s.domainService.MovePigsIntoPen(batchID, toPenID, quantity, operatorID, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 将猪只移入猪栏失败, 批次ID: %d, 目标猪栏ID: %d, 错误: %v", batchID, toPenID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// SellPigs 委托给领域服务
+func (s *pigBatchService) SellPigs(batchID uint, penID uint, quantity int, unitPrice float64, tatalPrice float64, traderName string, tradeDate time.Time, remarks string, operatorID uint) error {
+	err := s.domainService.SellPigs(batchID, penID, quantity, unitPrice, tatalPrice, traderName, tradeDate, remarks, operatorID)
+	if err != nil {
+		s.logger.Errorf("应用层: 卖猪失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// BuyPigs 委托给领域服务
+func (s *pigBatchService) BuyPigs(batchID uint, penID uint, quantity int, unitPrice float64, tatalPrice float64, traderName string, tradeDate time.Time, remarks string, operatorID uint) error {
+	err := s.domainService.BuyPigs(batchID, penID, quantity, unitPrice, tatalPrice, traderName, tradeDate, remarks, operatorID)
+	if err != nil {
+		s.logger.Errorf("应用层: 买猪失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// TransferPigsAcrossBatches 委托给领域服务
+func (s *pigBatchService) TransferPigsAcrossBatches(sourceBatchID uint, destBatchID uint, fromPenID uint, toPenID uint, quantity uint, operatorID uint, remarks string) error {
+	err := s.domainService.TransferPigsAcrossBatches(sourceBatchID, destBatchID, fromPenID, toPenID, quantity, operatorID, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 跨群调栏失败, 源批次ID: %d, 错误: %v", sourceBatchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// TransferPigsWithinBatch 委托给领域服务
+func (s *pigBatchService) TransferPigsWithinBatch(batchID uint, fromPenID uint, toPenID uint, quantity uint, operatorID uint, remarks string) error {
+	err := s.domainService.TransferPigsWithinBatch(batchID, fromPenID, toPenID, quantity, operatorID, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 群内调栏失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// RecordSickPigs 委托给领域服务
+func (s *pigBatchService) RecordSickPigs(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error {
+	err := s.domainService.RecordSickPigs(operatorID, batchID, penID, quantity, treatmentLocation, happenedAt, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 记录病猪事件失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// RecordSickPigRecovery 委托给领域服务
+func (s *pigBatchService) RecordSickPigRecovery(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error {
+	err := s.domainService.RecordSickPigRecovery(operatorID, batchID, penID, quantity, treatmentLocation, happenedAt, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 记录病猪康复事件失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// RecordSickPigDeath 委托给领域服务
+func (s *pigBatchService) RecordSickPigDeath(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error {
+	err := s.domainService.RecordSickPigDeath(operatorID, batchID, penID, quantity, treatmentLocation, happenedAt, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 记录病猪死亡事件失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// RecordSickPigCull 委托给领域服务
+func (s *pigBatchService) RecordSickPigCull(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error {
+	err := s.domainService.RecordSickPigCull(operatorID, batchID, penID, quantity, treatmentLocation, happenedAt, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 记录病猪淘汰事件失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// RecordDeath 委托给领域服务
+func (s *pigBatchService) RecordDeath(operatorID uint, batchID uint, penID uint, quantity int, happenedAt time.Time, remarks string) error {
+	err := s.domainService.RecordDeath(operatorID, batchID, penID, quantity, happenedAt, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 记录正常猪只死亡事件失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
+	}
+	return nil
+}
+
+// RecordCull 委托给领域服务
+func (s *pigBatchService) RecordCull(operatorID uint, batchID uint, penID uint, quantity int, happenedAt time.Time, remarks string) error {
+	err := s.domainService.RecordCull(operatorID, batchID, penID, quantity, happenedAt, remarks)
+	if err != nil {
+		s.logger.Errorf("应用层: 记录正常猪只淘汰事件失败, 批次ID: %d, 错误: %v", batchID, err)
+		return MapDomainError(err)
 	}
 	return nil
 }

internal/app/service/pig_farm_service.go

@@ -4,6 +4,8 @@ import (
 	"errors"
 	"fmt"
 
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	domain_pig "git.huangwc.com/pig/pig-farm-controller/internal/domain/pig"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
@@ -14,20 +16,20 @@ import (
 // PigFarmService 提供了猪场资产管理的业务逻辑
 type PigFarmService interface {
 	// PigHouse methods
-	CreatePigHouse(name, description string) (*models.PigHouse, error)
-	GetPigHouseByID(id uint) (*models.PigHouse, error)
-	ListPigHouses() ([]models.PigHouse, error)
-	UpdatePigHouse(id uint, name, description string) (*models.PigHouse, error)
+	CreatePigHouse(name, description string) (*dto.PigHouseResponse, error)
+	GetPigHouseByID(id uint) (*dto.PigHouseResponse, error)
+	ListPigHouses() ([]dto.PigHouseResponse, error)
+	UpdatePigHouse(id uint, name, description string) (*dto.PigHouseResponse, error)
 	DeletePigHouse(id uint) error
 
 	// Pen methods
-	CreatePen(penNumber string, houseID uint, capacity int) (*models.Pen, error)
-	GetPenByID(id uint) (*models.Pen, error)
-	ListPens() ([]models.Pen, error)
-	UpdatePen(id uint, penNumber string, houseID uint, capacity int, status models.PenStatus) (*models.Pen, error)
+	CreatePen(penNumber string, houseID uint, capacity int) (*dto.PenResponse, error)
+	GetPenByID(id uint) (*dto.PenResponse, error)
+	ListPens() ([]*dto.PenResponse, error)
+	UpdatePen(id uint, penNumber string, houseID uint, capacity int, status models.PenStatus) (*dto.PenResponse, error)
 	DeletePen(id uint) error
 	// UpdatePenStatus 更新猪栏状态
-	UpdatePenStatus(id uint, newStatus models.PenStatus) (*models.Pen, error)
+	UpdatePenStatus(id uint, newStatus models.PenStatus) (*dto.PenResponse, error)
 }
 
 type pigFarmService struct {
@@ -35,13 +37,15 @@ type pigFarmService struct {
 	farmRepository  repository.PigFarmRepository
 	penRepository   repository.PigPenRepository
 	batchRepository repository.PigBatchRepository
-	uow             repository.UnitOfWork // 工作单元，用于事务管理
+	pigBatchService domain_pig.PigBatchService // Add domain PigBatchService dependency
+	uow             repository.UnitOfWork      // 工作单元，用于事务管理
 }
 
 // NewPigFarmService 创建一个新的 PigFarmService 实例
 func NewPigFarmService(farmRepository repository.PigFarmRepository,
 	penRepository repository.PigPenRepository,
 	batchRepository repository.PigBatchRepository,
+	pigBatchService domain_pig.PigBatchService,
 	uow repository.UnitOfWork,
 	logger *logs.Logger) PigFarmService {
 	return &pigFarmService{
@@ -49,30 +53,58 @@ func NewPigFarmService(farmRepository repository.PigFarmRepository,
 		farmRepository:  farmRepository,
 		penRepository:   penRepository,
 		batchRepository: batchRepository,
+		pigBatchService: pigBatchService,
 		uow:             uow,
 	}
 }
 
 // --- PigHouse Implementation ---
 
-func (s *pigFarmService) CreatePigHouse(name, description string) (*models.PigHouse, error) {
+func (s *pigFarmService) CreatePigHouse(name, description string) (*dto.PigHouseResponse, error) {
 	house := &models.PigHouse{
 		Name:        name,
 		Description: description,
 	}
 	err := s.farmRepository.CreatePigHouse(house)
-	return house, err
+	if err != nil {
+		return nil, err
+	}
+	return &dto.PigHouseResponse{
+		ID:          house.ID,
+		Name:        house.Name,
+		Description: house.Description,
+	}, nil
 }
 
-func (s *pigFarmService) GetPigHouseByID(id uint) (*models.PigHouse, error) {
-	return s.farmRepository.GetPigHouseByID(id)
+func (s *pigFarmService) GetPigHouseByID(id uint) (*dto.PigHouseResponse, error) {
+	house, err := s.farmRepository.GetPigHouseByID(id)
+	if err != nil {
+		return nil, err
+	}
+	return &dto.PigHouseResponse{
+		ID:          house.ID,
+		Name:        house.Name,
+		Description: house.Description,
+	}, nil
 }
 
-func (s *pigFarmService) ListPigHouses() ([]models.PigHouse, error) {
-	return s.farmRepository.ListPigHouses()
+func (s *pigFarmService) ListPigHouses() ([]dto.PigHouseResponse, error) {
+	houses, err := s.farmRepository.ListPigHouses()
+	if err != nil {
+		return nil, err
+	}
+	var resp []dto.PigHouseResponse
+	for _, house := range houses {
+		resp = append(resp, dto.PigHouseResponse{
+			ID:          house.ID,
+			Name:        house.Name,
+			Description: house.Description,
+		})
+	}
+	return resp, nil
 }
 
-func (s *pigFarmService) UpdatePigHouse(id uint, name, description string) (*models.PigHouse, error) {
+func (s *pigFarmService) UpdatePigHouse(id uint, name, description string) (*dto.PigHouseResponse, error) {
 	house := &models.PigHouse{
 		Model:       gorm.Model{ID: id},
 		Name:        name,
@@ -86,7 +118,15 @@ func (s *pigFarmService) UpdatePigHouse(id uint, name, description string) (*mod
 		return nil, ErrHouseNotFound
 	}
 	// 返回更新后的完整信息
-	return s.farmRepository.GetPigHouseByID(id)
+	updatedHouse, err := s.farmRepository.GetPigHouseByID(id)
+	if err != nil {
+		return nil, err
+	}
+	return &dto.PigHouseResponse{
+		ID:          updatedHouse.ID,
+		Name:        updatedHouse.Name,
+		Description: updatedHouse.Description,
+	}, nil
 }
 
 func (s *pigFarmService) DeletePigHouse(id uint) error {
@@ -112,7 +152,7 @@ func (s *pigFarmService) DeletePigHouse(id uint) error {
 
 // --- Pen Implementation ---
 
-func (s *pigFarmService) CreatePen(penNumber string, houseID uint, capacity int) (*models.Pen, error) {
+func (s *pigFarmService) CreatePen(penNumber string, houseID uint, capacity int) (*dto.PenResponse, error) {
 	// 业务逻辑：验证所属猪舍是否存在
 	_, err := s.farmRepository.GetPigHouseByID(houseID)
 	if err != nil {
@@ -129,18 +169,79 @@ func (s *pigFarmService) CreatePen(penNumber string, houseID uint, capacity int)
 		Status:    models.PenStatusEmpty,
 	}
 	err = s.penRepository.CreatePen(pen)
-	return pen, err
+	if err != nil {
+		return nil, err
+	}
+	return &dto.PenResponse{
+		ID:        pen.ID,
+		PenNumber: pen.PenNumber,
+		HouseID:   pen.HouseID,
+		Capacity:  pen.Capacity,
+		Status:    pen.Status,
+	}, nil
 }
 
-func (s *pigFarmService) GetPenByID(id uint) (*models.Pen, error) {
-	return s.penRepository.GetPenByID(id)
+func (s *pigFarmService) GetPenByID(id uint) (*dto.PenResponse, error) {
+	pen, err := s.penRepository.GetPenByID(id)
+	if err != nil {
+		return nil, err
+	}
+
+	currentPigCount, err := s.pigBatchService.GetCurrentPigsInPen(id)
+	if err != nil {
+		s.logger.Errorf("获取猪栏 %d 存栏量失败: %v", id, err)
+		currentPigCount = 0 // 如果获取计数时出错，则默认为0
+	}
+
+	response := &dto.PenResponse{
+		ID:              pen.ID,
+		PenNumber:       pen.PenNumber,
+		HouseID:         pen.HouseID,
+		Capacity:        pen.Capacity,
+		Status:          pen.Status,
+		CurrentPigCount: currentPigCount,
+	}
+
+	if pen.PigBatchID != nil {
+		response.PigBatchID = pen.PigBatchID
+	}
+
+	return response, nil
 }
 
-func (s *pigFarmService) ListPens() ([]models.Pen, error) {
-	return s.penRepository.ListPens()
+func (s *pigFarmService) ListPens() ([]*dto.PenResponse, error) {
+	pens, err := s.penRepository.ListPens()
+	if err != nil {
+		return nil, err
+	}
+
+	var response []*dto.PenResponse
+	for _, pen := range pens {
+		currentPigCount, err := s.pigBatchService.GetCurrentPigsInPen(pen.ID)
+		if err != nil {
+			s.logger.Errorf("获取猪栏 %d 存栏量失败: %v", pen.ID, err)
+			currentPigCount = 0 // 如果获取计数时出错，则默认为0
+		}
+
+		penResponse := &dto.PenResponse{
+			ID:              pen.ID,
+			PenNumber:       pen.PenNumber,
+			HouseID:         pen.HouseID,
+			Capacity:        pen.Capacity,
+			Status:          pen.Status,
+			CurrentPigCount: currentPigCount,
+		}
+
+		if pen.PigBatchID != nil {
+			penResponse.PigBatchID = pen.PigBatchID
+		}
+		response = append(response, penResponse)
+	}
+
+	return response, nil
 }
 
-func (s *pigFarmService) UpdatePen(id uint, penNumber string, houseID uint, capacity int, status models.PenStatus) (*models.Pen, error) {
+func (s *pigFarmService) UpdatePen(id uint, penNumber string, houseID uint, capacity int, status models.PenStatus) (*dto.PenResponse, error) {
 	// 业务逻辑：验证所属猪舍是否存在
 	_, err := s.farmRepository.GetPigHouseByID(houseID)
 	if err != nil {
@@ -165,7 +266,18 @@ func (s *pigFarmService) UpdatePen(id uint, penNumber string, houseID uint, capa
 		return nil, ErrPenNotFound
 	}
 	// 返回更新后的完整信息
-	return s.penRepository.GetPenByID(id)
+	updatedPen, err := s.penRepository.GetPenByID(id)
+	if err != nil {
+		return nil, err
+	}
+	return &dto.PenResponse{
+		ID:         updatedPen.ID,
+		PenNumber:  updatedPen.PenNumber,
+		HouseID:    updatedPen.HouseID,
+		Capacity:   updatedPen.Capacity,
+		Status:     updatedPen.Status,
+		PigBatchID: updatedPen.PigBatchID,
+	}, nil
 }
 
 func (s *pigFarmService) DeletePen(id uint) error {
@@ -203,7 +315,7 @@ func (s *pigFarmService) DeletePen(id uint) error {
 }
 
 // UpdatePenStatus 更新猪栏状态
-func (s *pigFarmService) UpdatePenStatus(id uint, newStatus models.PenStatus) (*models.Pen, error) {
+func (s *pigFarmService) UpdatePenStatus(id uint, newStatus models.PenStatus) (*dto.PenResponse, error) {
 	var updatedPen *models.Pen
 	err := s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
 		pen, err := s.penRepository.GetPenByIDTx(tx, id)
@@ -253,5 +365,12 @@ func (s *pigFarmService) UpdatePenStatus(id uint, newStatus models.PenStatus) (*
 	if err != nil {
 		return nil, err
 	}
-	return updatedPen, nil
+	return &dto.PenResponse{
+		ID:         updatedPen.ID,
+		PenNumber:  updatedPen.PenNumber,
+		HouseID:    updatedPen.HouseID,
+		Capacity:   updatedPen.Capacity,
+		Status:     updatedPen.Status,
+		PigBatchID: updatedPen.PigBatchID,
+	}, nil
 }

internal/app/service/pig_service.go

@@ -19,10 +19,12 @@ var (
 	ErrPenOccupiedByOtherBatch          = errors.New("猪栏已被其他批次使用")
 	ErrPenStatusInvalidForAllocation    = errors.New("猪栏状态不允许分配")
 	ErrPenNotAssociatedWithBatch        = errors.New("猪栏未与该批次关联")
+	ErrPenNotEmpty                      = errors.New("猪栏内仍有猪只")
+	ErrInvalidOperation                 = errors.New("非法操作")
 )
 
-// mapDomainError 将领域层的错误转换为应用服务层的公共错误。
-func mapDomainError(err error) error {
+// MapDomainError 将领域层的错误转换为应用服务层的公共错误。
+func MapDomainError(err error) error {
 	if err == nil {
 		return nil
 	}
@@ -42,6 +44,10 @@ func mapDomainError(err error) error {
 		return ErrPenNotAssociatedWithBatch
 	case errors.Is(err, domain_pig.ErrPenNotFound):
 		return ErrPenNotFound
+	case errors.Is(err, domain_pig.ErrPenNotEmpty):
+		return ErrPenNotEmpty
+	case errors.Is(err, domain_pig.ErrInvalidOperation):
+		return ErrInvalidOperation
 	// 可以添加更多领域错误到应用层错误的映射
 	default:
 		return err // 对于未知的领域错误，直接返回

internal/app/service/plan_service.go

@@ -0,0 +1,205 @@
+package service
+
+import (
+	"errors"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/plan"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+)
+
+// PlanService 定义了计划相关的应用服务接口
+type PlanService interface {
+	// CreatePlan 创建一个新的计划
+	CreatePlan(req *dto.CreatePlanRequest) (*dto.PlanResponse, error)
+	// GetPlanByID 根据ID获取计划详情
+	GetPlanByID(id uint) (*dto.PlanResponse, error)
+	// ListPlans 获取计划列表，支持过滤和分页
+	ListPlans(query *dto.ListPlansQuery) (*dto.ListPlansResponse, error)
+	// UpdatePlan 更新计划
+	UpdatePlan(id uint, req *dto.UpdatePlanRequest) (*dto.PlanResponse, error)
+	// DeletePlan 删除计划（软删除）
+	DeletePlan(id uint) error
+	// StartPlan 启动计划
+	StartPlan(id uint) error
+	// StopPlan 停止计划
+	StopPlan(id uint) error
+}
+
+// planService 是 PlanService 接口的实现
+type planService struct {
+	logger            *logs.Logger
+	domainPlanService plan.Service // 替换为领域层的服务接口
+}
+
+// NewPlanService 创建一个新的 PlanService 实例
+func NewPlanService(
+	logger *logs.Logger,
+	domainPlanService plan.Service, // 接收领域层服务
+) PlanService {
+	return &planService{
+		logger:            logger,
+		domainPlanService: domainPlanService, // 注入领域层服务
+	}
+}
+
+// CreatePlan 创建一个新的计划
+func (s *planService) CreatePlan(req *dto.CreatePlanRequest) (*dto.PlanResponse, error) {
+	const actionType = "应用服务层：创建计划"
+
+	// 使用 DTO 转换函数将请求转换为领域实体
+	planToCreate, err := dto.NewPlanFromCreateRequest(req)
+	if err != nil {
+		s.logger.Errorf("%s: 计划数据校验失败: %v", actionType, err)
+		return nil, err
+	}
+
+	// 调用领域服务创建计划
+	createdPlan, err := s.domainPlanService.CreatePlan(planToCreate)
+	if err != nil {
+		s.logger.Errorf("%s: 领域服务创建计划失败: %v", actionType, err)
+		return nil, err // 直接返回领域层错误
+	}
+
+	// 将领域实体转换为响应 DTO
+	resp, err := dto.NewPlanToResponse(createdPlan)
+	if err != nil {
+		s.logger.Errorf("%s: 序列化响应失败: %v, Plan: %+v", actionType, err, createdPlan)
+		return nil, errors.New("计划创建成功，但响应生成失败")
+	}
+
+	s.logger.Infof("%s: 计划创建成功, ID: %d", actionType, createdPlan.ID)
+	return resp, nil
+}
+
+// GetPlanByID 根据ID获取计划详情
+func (s *planService) GetPlanByID(id uint) (*dto.PlanResponse, error) {
+	const actionType = "应用服务层：获取计划详情"
+
+	// 调用领域服务获取计划
+	plan, err := s.domainPlanService.GetPlanByID(id)
+	if err != nil {
+		s.logger.Errorf("%s: 领域服务获取计划详情失败: %v, ID: %d", actionType, err, id)
+		return nil, err // 直接返回领域层错误
+	}
+
+	// 将领域实体转换为响应 DTO
+	resp, err := dto.NewPlanToResponse(plan)
+	if err != nil {
+		s.logger.Errorf("%s: 序列化响应失败: %v, Plan: %+v", actionType, err, plan)
+		return nil, errors.New("获取计划详情失败: 内部数据格式错误")
+	}
+
+	s.logger.Infof("%s: 获取计划详情成功, ID: %d", actionType, id)
+	return resp, nil
+}
+
+// ListPlans 获取计划列表，支持过滤和分页
+func (s *planService) ListPlans(query *dto.ListPlansQuery) (*dto.ListPlansResponse, error) {
+	const actionType = "应用服务层：获取计划列表"
+
+	// 将 DTO 查询参数转换为领域层可接受的选项
+	opts := repository.ListPlansOptions{PlanType: query.PlanType}
+
+	// 调用领域服务获取计划列表
+	plans, total, err := s.domainPlanService.ListPlans(opts, query.Page, query.PageSize)
+	if err != nil {
+		s.logger.Errorf("%s: 领域服务获取计划列表失败: %v", actionType, err)
+		return nil, err // 直接返回领域层错误
+	}
+
+	// 将领域实体列表转换为响应 DTO 列表
+	planResponses := make([]dto.PlanResponse, 0, len(plans))
+	for _, p := range plans {
+		resp, err := dto.NewPlanToResponse(&p)
+		if err != nil {
+			s.logger.Errorf("%s: 序列化单个计划响应失败: %v, Plan: %+v", actionType, err, p)
+			// 这里选择跳过有问题的计划，并记录错误，而不是中断整个列表的返回
+			continue
+		}
+		planResponses = append(planResponses, *resp)
+	}
+
+	resp := &dto.ListPlansResponse{
+		Plans: planResponses,
+		Total: total,
+	}
+	s.logger.Infof("%s: 获取计划列表成功, 数量: %d", actionType, len(planResponses))
+	return resp, nil
+}
+
+// UpdatePlan 更新计划
+func (s *planService) UpdatePlan(id uint, req *dto.UpdatePlanRequest) (*dto.PlanResponse, error) {
+	const actionType = "应用服务层：更新计划"
+
+	// 使用 DTO 转换函数将请求转换为领域实体
+	planToUpdate, err := dto.NewPlanFromUpdateRequest(req)
+	if err != nil {
+		s.logger.Errorf("%s: 计划数据校验失败: %v", actionType, err)
+		return nil, err
+	}
+	planToUpdate.ID = id // 确保ID被设置
+
+	// 调用领域服务更新计划
+	updatedPlan, err := s.domainPlanService.UpdatePlan(planToUpdate)
+	if err != nil {
+		s.logger.Errorf("%s: 领域服务更新计划失败: %v, ID: %d", actionType, err, id)
+		return nil, err // 直接返回领域层错误
+	}
+
+	// 将领域实体转换为响应 DTO
+	resp, err := dto.NewPlanToResponse(updatedPlan)
+	if err != nil {
+		s.logger.Errorf("%s: 序列化响应失败: %v, Updated Plan: %+v", actionType, err, updatedPlan)
+		return nil, errors.New("计划更新成功，但响应生成失败")
+	}
+
+	s.logger.Infof("%s: 计划更新成功, ID: %d", actionType, updatedPlan.ID)
+	return resp, nil
+}
+
+// DeletePlan 删除计划（软删除）
+func (s *planService) DeletePlan(id uint) error {
+	const actionType = "应用服务层：删除计划"
+
+	// 调用领域服务删除计划
+	err := s.domainPlanService.DeletePlan(id)
+	if err != nil {
+		s.logger.Errorf("%s: 领域服务删除计划失败: %v, ID: %d", actionType, err, id)
+		return err // 直接返回领域层错误
+	}
+
+	s.logger.Infof("%s: 计划删除成功, ID: %d", actionType, id)
+	return nil
+}
+
+// StartPlan 启动计划
+func (s *planService) StartPlan(id uint) error {
+	const actionType = "应用服务层：启动计划"
+
+	// 调用领域服务启动计划
+	err := s.domainPlanService.StartPlan(id)
+	if err != nil {
+		s.logger.Errorf("%s: 领域服务启动计划失败: %v, ID: %d", actionType, err, id)
+		return err // 直接返回领域层错误
+	}
+
+	s.logger.Infof("%s: 计划已成功启动, ID: %d", actionType, id)
+	return nil
+}
+
+// StopPlan 停止计划
+func (s *planService) StopPlan(id uint) error {
+	const actionType = "应用服务层：停止计划"
+
+	// 调用领域服务停止计划
+	err := s.domainPlanService.StopPlan(id)
+	if err != nil {
+		s.logger.Errorf("%s: 领域服务停止计划失败: %v, ID: %d", actionType, err, id)
+		return err // 直接返回领域层错误
+	}
+
+	s.logger.Infof("%s: 计划已成功停止, ID: %d", actionType, id)
+	return nil
+}

internal/app/service/user_service.go

@@ -0,0 +1,110 @@
+package service
+
+import (
+	"errors"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
+	domain_notify "git.huangwc.com/pig/pig-farm-controller/internal/domain/notify"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/token"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+	"gorm.io/gorm"
+)
+
+// UserService 定义用户服务接口
+type UserService interface {
+	CreateUser(req *dto.CreateUserRequest) (*dto.CreateUserResponse, error)
+	Login(req *dto.LoginRequest) (*dto.LoginResponse, error)
+	SendTestNotification(userID uint, req *dto.SendTestNotificationRequest) error
+}
+
+// userService 实现了 UserService 接口
+type userService struct {
+	userRepo      repository.UserRepository
+	tokenService  token.Service
+	notifyService domain_notify.Service
+	logger        *logs.Logger
+}
+
+// NewUserService 创建并返回一个新的 UserService 实例
+func NewUserService(
+	userRepo repository.UserRepository,
+	tokenService token.Service,
+	notifyService domain_notify.Service,
+	logger *logs.Logger,
+) UserService {
+	return &userService{
+		userRepo:      userRepo,
+		tokenService:  tokenService,
+		notifyService: notifyService,
+		logger:        logger,
+	}
+}
+
+// CreateUser 创建新用户
+func (s *userService) CreateUser(req *dto.CreateUserRequest) (*dto.CreateUserResponse, error) {
+	user := &models.User{
+		Username: req.Username,
+		Password: req.Password, // 密码会在 BeforeSave 钩子中哈希
+	}
+
+	if err := s.userRepo.Create(user); err != nil {
+		s.logger.Errorf("创建用户: 创建用户失败: %v", err)
+
+		// 尝试查询用户，以判断是否是用户名重复导致的错误
+		_, findErr := s.userRepo.FindByUsername(req.Username)
+		if findErr == nil { // 如果能找到用户，说明是用户名重复
+			return nil, errors.New("用户名已存在")
+		}
+
+		// 其他创建失败的情况
+		return nil, errors.New("创建用户失败")
+	}
+
+	return &dto.CreateUserResponse{
+		Username: user.Username,
+		ID:       user.ID,
+	}, nil
+}
+
+// Login 用户登录
+func (s *userService) Login(req *dto.LoginRequest) (*dto.LoginResponse, error) {
+	// 使用新的方法，通过唯一标识符（用户名、邮箱等）查找用户
+	user, err := s.userRepo.FindUserForLogin(req.Identifier)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			return nil, errors.New("登录凭证不正确")
+		}
+		s.logger.Errorf("登录: 查询用户失败: %v", err)
+		return nil, errors.New("登录失败")
+	}
+
+	if !user.CheckPassword(req.Password) {
+		return nil, errors.New("登录凭证不正确")
+	}
+
+	// 登录成功，生成 JWT token
+	tokenString, err := s.tokenService.GenerateToken(user.ID)
+	if err != nil {
+		s.logger.Errorf("登录: 生成令牌失败: %v", err)
+		return nil, errors.New("登录失败，无法生成认证信息")
+	}
+
+	return &dto.LoginResponse{
+		Username: user.Username,
+		ID:       user.ID,
+		Token:    tokenString,
+	}, nil
+}
+
+// SendTestNotification 发送测试通知
+func (s *userService) SendTestNotification(userID uint, req *dto.SendTestNotificationRequest) error {
+	err := s.notifyService.SendTestMessage(userID, req.Type)
+	if err != nil {
+		s.logger.Errorf("发送测试通知: 服务层调用失败: %v", err)
+		return errors.New("发送测试消息失败: " + err.Error())
+	}
+	s.logger.Infof("发送测试通知: 成功为用户 %d 发送类型为 %s 的测试消息", userID, req.Type)
+	return nil
+}

internal/app/webhook/chirp_stack.go

@@ -4,13 +4,14 @@ import (
 	"encoding/base64"
 	"encoding/json"
 	"io"
+	"math"
 	"net/http"
 	"time"
 
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/device/proto"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/transport/proto"
 	gproto "google.golang.org/protobuf/proto"
 	"gorm.io/datatypes"
 )
@@ -207,16 +208,20 @@ func (c *ChirpStackListener) handleUpEvent(event *UpEvent) {
 		return
 	}
 
-	// 3.3 检查是否是采集响应
-	if instruction.Method != proto.MethodType_COLLECT {
-		c.logger.Infof("收到一个非采集响应的上行指令 (Method: %s)，无需处理。", instruction.Method.String())
+	// 3.3 使用 type switch 从 oneof payload 中提取 CollectResult
+	var collectResp *proto.CollectResult
+	switch p := instruction.GetPayload().(type) {
+	case *proto.Instruction_CollectResult:
+		collectResp = p.CollectResult
+	default:
+		// 如果上行的数据不是采集结果，记录日志并忽略
+		c.logger.Infof("收到一个非采集响应的上行指令 (Type: %T)，无需处理。", p)
 		return
 	}
 
-	// 3.4 解包内层 CollectResult
-	var collectResp proto.CollectResult
-	if err := instruction.Data.UnmarshalTo(&collectResp); err != nil {
-		c.logger.Errorf("解包数据信息失败: %v", err)
+	// 检查 collectResp 是否为 nil，虽然在 type switch 成功的情况下不太可能
+	if collectResp == nil {
+		c.logger.Errorf("从 Instruction 中提取的 CollectResult 为 nil")
 		return
 	}
 
@@ -252,6 +257,12 @@ func (c *ChirpStackListener) handleUpEvent(event *UpEvent) {
 	for i, deviceID := range deviceIDs {
 		rawSensorValue := values[i] // 这是设备上报的原始值
 
+		// 检查设备上报的值是否为 NaN (Not a Number)，如果是则跳过
+		if math.IsNaN(float64(rawSensorValue)) {
+			c.logger.Warnf("设备 (ID: %d) 上报了一个无效的 NaN 值，已跳过当前值的记录。", deviceID)
+			continue
+		}
+
 		// 5.1 获取设备及其模板
 		dev, err := c.deviceRepo.FindByID(deviceID)
 		if err != nil {

internal/app/webhook/placeholder_listener.go

@@ -0,0 +1,30 @@
+package webhook
+
+import (
+	"net/http"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+)
+
+// PlaceholderListener 是一个占位符, 用于在非 LoRaWAN 配置下满足 ListenHandler 接口
+type PlaceholderListener struct {
+	logger *logs.Logger
+}
+
+// NewPlaceholderListener 创建一个新的 PlaceholderListener 实例
+// 它只打印一条日志, 表明 ChirpStack webhook 未被激活
+func NewPlaceholderListener(logger *logs.Logger) ListenHandler {
+	logger.Info("当前配置非 LoRaWAN, ChirpStack webhook 监听器未激活。")
+	return &PlaceholderListener{
+		logger: logger,
+	}
+}
+
+// Handler 返回一个不执行任何操作的 http.HandlerFunc
+// 理论上, 在占位符生效的模式下, 这个 Handler 不应该被调用
+func (p *PlaceholderListener) Handler() http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		p.logger.Warn("PlaceholderListener 的 Handler 被调用, 这通常是意料之外的。")
+		w.WriteHeader(http.StatusNotImplemented)
+	}
+}

internal/core/application.go

@@ -5,161 +5,65 @@ import (
 	"os"
 	"os/signal"
 	"syscall"
-	"time"
 
 	"git.huangwc.com/pig/pig-farm-controller/internal/app/api"
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/webhook"
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/audit"
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/device"
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/pig"
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/task"
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/token"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/config"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/database"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/transport/lora"
 )
 
 // Application 是整个应用的核心，封装了所有组件和生命周期。
 type Application struct {
-	Config   *config.Config
-	Logger   *logs.Logger
-	Storage  database.Storage
-	Executor *task.Scheduler
-	API      *api.API // 添加 API 对象
+	Config *config.Config
+	Logger *logs.Logger
+	API    *api.API
 
-	// 新增的仓库和管理器字段，以便在 initializePendingTasks 中访问
-	planRepo                repository.PlanRepository
-	pendingTaskRepo         repository.PendingTaskRepository
-	executionLogRepo        repository.ExecutionLogRepository
-	pendingCollectionRepo   repository.PendingCollectionRepository
-	analysisPlanTaskManager *task.AnalysisPlanTaskManager
+	Infra  *Infrastructure
+	Domain *DomainServices
+	App    *AppServices
 }
 
 // NewApplication 创建并初始化一个新的 Application 实例。
 // 这是应用的“组合根”，所有依赖都在这里被创建和注入。
 func NewApplication(configPath string) (*Application, error) {
-	//  加载配置
+	// 1. 初始化基本组件: 配置和日志
 	cfg := config.NewConfig()
 	if err := cfg.Load(configPath); err != nil {
 		return nil, fmt.Errorf("无法加载配置: %w", err)
 	}
-
-	//  初始化日志记录器
 	logger := logs.NewLogger(cfg.Log)
 
-	//  初始化数据库存储
-	storage, err := initStorage(cfg.Database, logger)
+	// 2. 初始化所有分层服务
+	infra, err := initInfrastructure(cfg, logger)
 	if err != nil {
-		return nil, err // 错误已在 initStorage 中被包装
+		return nil, fmt.Errorf("初始化基础设施失败: %w", err)
 	}
+	domain := initDomainServices(cfg, infra, logger)
+	appServices := initAppServices(infra, domain, logger)
 
-	//  初始化 Token 服务
-	tokenService := token.NewTokenService([]byte(cfg.App.JWTSecret))
-
-	// --- 仓库对象初始化 ---
-	userRepo := repository.NewGormUserRepository(storage.GetDB())
-	deviceRepo := repository.NewGormDeviceRepository(storage.GetDB())
-	areaControllerRepo := repository.NewGormAreaControllerRepository(storage.GetDB())
-	deviceTemplateRepo := repository.NewGormDeviceTemplateRepository(storage.GetDB())
-	planRepo := repository.NewGormPlanRepository(storage.GetDB())
-	pendingTaskRepo := repository.NewGormPendingTaskRepository(storage.GetDB())
-	executionLogRepo := repository.NewGormExecutionLogRepository(storage.GetDB())
-	sensorDataRepo := repository.NewGormSensorDataRepository(storage.GetDB())
-	deviceCommandLogRepo := repository.NewGormDeviceCommandLogRepository(storage.GetDB())
-	pendingCollectionRepo := repository.NewGormPendingCollectionRepository(storage.GetDB())
-	userActionLogRepo := repository.NewGormUserActionLogRepository(storage.GetDB())
-	pigBatchRepo := repository.NewGormPigBatchRepository(storage.GetDB())
-	pigBatchLogRepo := repository.NewGormPigBatchLogRepository(storage.GetDB())
-	pigFarmRepo := repository.NewGormPigFarmRepository(storage.GetDB())
-	pigPenRepo := repository.NewGormPigPenRepository(storage.GetDB())
-	pigTransferLogRepo := repository.NewGormPigTransferLogRepository(storage.GetDB())
-	pigTradeRepo := repository.NewGormPigTradeRepository(storage.GetDB())
-	pigSickPigLogRepo := repository.NewGormPigSickLogRepository(storage.GetDB())
-	medicationLogRepo := repository.NewGormMedicationLogRepository(storage.GetDB())
-
-	// 初始化事务管理器
-	unitOfWork := repository.NewGormUnitOfWork(storage.GetDB(), logger)
-
-	// 初始化猪群管理领域
-	pigPenTransferManager := pig.NewPigPenTransferManager(pigPenRepo, pigTransferLogRepo, pigBatchRepo)
-	pigTradeManager := pig.NewPigTradeManager(pigTradeRepo)
-	pigSickManager := pig.NewSickPigManager(pigSickPigLogRepo, medicationLogRepo)
-	pigBatchDomain := pig.NewPigBatchService(pigBatchRepo, pigBatchLogRepo, unitOfWork,
-		pigPenTransferManager, pigTradeManager, pigSickManager)
-
-	// --- 业务逻辑处理器初始化 ---
-	pigFarmService := service.NewPigFarmService(pigFarmRepo, pigPenRepo, pigBatchRepo, unitOfWork, logger)
-	pigBatchService := service.NewPigBatchService(pigBatchDomain, logger)
-
-	// 初始化审计服务
-	auditService := audit.NewService(userActionLogRepo, logger)
-
-	// 初始化设备上行监听器
-	listenHandler := webhook.NewChirpStackListener(logger, sensorDataRepo, deviceRepo, areaControllerRepo, deviceCommandLogRepo, pendingCollectionRepo)
-
-	// 初始化计划触发器管理器
-	analysisPlanTaskManager := task.NewAnalysisPlanTaskManager(planRepo, pendingTaskRepo, executionLogRepo, logger)
-
-	// 初始化设备通信器 (纯粹的通信客户端)
-	comm := lora.NewChirpStackTransport(cfg.ChirpStack, logger)
-
-	// 初始化通用设备服务
-	generalDeviceService := device.NewGeneralDeviceService(
-		deviceRepo,
-		deviceCommandLogRepo,
-		pendingCollectionRepo,
-		logger,
-		comm,
-	)
-
-	//  初始化任务执行器
-	executor := task.NewScheduler(
-		pendingTaskRepo,
-		executionLogRepo,
-		deviceRepo,
-		sensorDataRepo,
-		planRepo,
-		analysisPlanTaskManager,
-		logger,
-		generalDeviceService,
-		time.Duration(cfg.Task.Interval)*time.Second,
-		cfg.Task.NumWorkers,
-	)
-
-	//  初始化 API 服务器
+	// 3. 初始化 API 入口点
 	apiServer := api.NewAPI(
 		cfg.Server,
 		logger,
-		userRepo,
-		deviceRepo,
-		areaControllerRepo,
-		deviceTemplateRepo,
-		planRepo,
-		pigFarmService,
-		pigBatchService,
-		userActionLogRepo,
-		tokenService,
-		auditService,
-		listenHandler,
-		analysisPlanTaskManager,
+		infra.repos.userRepo,
+		appServices.pigFarmService,
+		appServices.pigBatchService,
+		appServices.monitorService,
+		appServices.deviceService,
+		appServices.planService,
+		appServices.userService,
+		infra.tokenService,
+		appServices.auditService,
+		infra.lora.listenHandler,
 	)
 
-	//  组装 Application 对象
+	// 4. 组装 Application 对象
 	app := &Application{
-		Config:                  cfg,
-		Logger:                  logger,
-		Storage:                 storage,
-		Executor:                executor,
-		API:                     apiServer,
-		planRepo:                planRepo,
-		pendingTaskRepo:         pendingTaskRepo,
-		executionLogRepo:        executionLogRepo,
-		pendingCollectionRepo:   pendingCollectionRepo,
-		analysisPlanTaskManager: analysisPlanTaskManager,
+		Config: cfg,
+		Logger: logger,
+		API:    apiServer,
+		Infra:  infra,
+		Domain: domain,
+		App:    appServices,
 	}
 
 	return app, nil
@@ -169,30 +73,23 @@ func NewApplication(configPath string) (*Application, error) {
 func (app *Application) Start() error {
 	app.Logger.Info("应用启动中...")
 
-	// --- 清理待采集任务 ---
-	if err := app.initializePendingCollections(); err != nil {
-		// 这是一个非致命错误，记录它，但应用应继续启动
-		app.Logger.Error(err)
+	// 1. 启动底层监听器
+	if err := app.Infra.lora.loraListener.Listen(); err != nil {
+		return fmt.Errorf("启动 LoRa Mesh 监听器失败: %w", err)
 	}
 
-	// --- 初始化待执行任务列表 ---
-	if err := app.initializePendingTasks(
-		app.planRepo,                // 传入 planRepo
-		app.pendingTaskRepo,         // 传入 pendingTaskRepo
-		app.executionLogRepo,        // 传入 executionLogRepo
-		app.analysisPlanTaskManager, // 传入 analysisPlanTaskManager
-		app.Logger,                  // 传入 logger
-	); err != nil {
-		return fmt.Errorf("初始化待执行任务列表失败: %w", err)
+	// 2. 初始化应用状态 (清理、刷新任务等)
+	if err := app.initializeState(); err != nil {
+		return fmt.Errorf("初始化应用状态失败: %w", err)
 	}
 
-	// 启动任务执行器
-	app.Executor.Start()
+	// 3. 启动后台工作协程
+	app.Domain.planService.Start()
 
-	// 启动 API 服务器
+	// 4. 启动 API 服务器
 	app.API.Start()
 
-	// 等待关闭信号
+	// 5. 等待关闭信号
 	quit := make(chan os.Signal, 1)
 	signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
 	<-quit
@@ -209,148 +106,21 @@ func (app *Application) Stop() error {
 	app.API.Stop()
 
 	// 关闭任务执行器
-	app.Executor.Stop()
+	app.Domain.planService.Stop()
 
 	// 断开数据库连接
-	if err := app.Storage.Disconnect(); err != nil {
+	if err := app.Infra.storage.Disconnect(); err != nil {
 		app.Logger.Errorw("数据库连接断开失败", "error", err)
 	}
 
+	// 关闭 LoRa Mesh 监听器
+	if err := app.Infra.lora.loraListener.Stop(); err != nil {
+		app.Logger.Errorw("LoRa Mesh 监听器关闭失败", "error", err)
+	}
+
 	// 刷新日志缓冲区
 	_ = app.Logger.Sync()
 
 	app.Logger.Info("应用已成功关闭")
 	return nil
 }
-
-// initializePendingCollections 在应用启动时处理所有未完成的采集请求。
-// 我们的策略是：任何在程序重启前仍处于“待处理”状态的请求，都应被视为已失败。
-// 这保证了系统在每次启动时都处于一个干净、确定的状态。
-func (app *Application) initializePendingCollections() error {
-	app.Logger.Info("开始清理所有未完成的采集请求...")
-
-	// 直接将所有 'pending' 状态的请求更新为 'timed_out'。
-	count, err := app.pendingCollectionRepo.MarkAllPendingAsTimedOut()
-	if err != nil {
-		return fmt.Errorf("清理未完成的采集请求失败: %v", err)
-	} else if count > 0 {
-		app.Logger.Infof("成功将 %d 个未完成的采集请求标记为超时。", count)
-	} else {
-		app.Logger.Info("没有需要清理的采集请求。")
-	}
-
-	return nil
-}
-
-// initializePendingTasks 在应用启动时清理并刷新待执行任务列表。
-func (app *Application) initializePendingTasks(
-	planRepo repository.PlanRepository,
-	pendingTaskRepo repository.PendingTaskRepository,
-	executionLogRepo repository.ExecutionLogRepository,
-	analysisPlanTaskManager *task.AnalysisPlanTaskManager,
-	logger *logs.Logger,
-) error {
-	logger.Info("开始初始化待执行任务列表...")
-
-	// 阶段一：修正因崩溃导致状态不一致的固定次数计划
-	logger.Info("阶段一：开始修正因崩溃导致状态不一致的固定次数计划...")
-	plansToCorrect, err := planRepo.FindPlansWithPendingTasks()
-	if err != nil {
-		return fmt.Errorf("查找需要修正的计划失败: %w", err)
-	}
-
-	for _, plan := range plansToCorrect {
-		logger.Infof("发现需要修正的计划 #%d (名称: %s)。", plan.ID, plan.Name)
-
-		// 更新计划的执行计数
-		plan.ExecuteCount++
-		logger.Infof("计划 #%d 执行计数已从 %d 更新为 %d。", plan.ID, plan.ExecuteCount-1, plan.ExecuteCount)
-
-		if plan.ExecutionType == models.PlanExecutionTypeManual ||
-			(plan.ExecutionType == models.PlanExecutionTypeAutomatic && plan.ExecuteCount >= plan.ExecuteNum) {
-			// 更新计划状态为已停止
-			plan.Status = models.PlanStatusStopped
-			logger.Infof("计划 #%d 状态已更新为 '执行完毕'。", plan.ID)
-
-		}
-		// 保存更新后的计划
-		if err := planRepo.UpdatePlan(plan); err != nil {
-			logger.Errorf("修正计划 #%d 状态失败: %v", plan.ID, err)
-			// 这是一个非阻塞性错误，继续处理其他计划
-		}
-	}
-	logger.Info("阶段一：固定次数计划修正完成。")
-
-	// 阶段二：清理所有待执行任务和相关日志
-	logger.Info("阶段二：开始清理所有待执行任务和相关日志...")
-
-	// --- 新增逻辑：处理因崩溃导致状态不一致的计划主表状态 ---
-	// 1. 查找所有未完成的计划执行日志 (状态为 Started 或 Waiting)
-	incompletePlanLogs, err := executionLogRepo.FindIncompletePlanExecutionLogs()
-	if err != nil {
-		return fmt.Errorf("查找未完成的计划执行日志失败: %w", err)
-	}
-
-	// 2. 收集所有受影响的唯一 PlanID
-	affectedPlanIDs := make(map[uint]struct{})
-	for _, log := range incompletePlanLogs {
-		affectedPlanIDs[log.PlanID] = struct{}{}
-	}
-
-	// 3. 对于每个受影响的 PlanID，重置其 execute_count 并将其状态设置为 Failed
-	for planID := range affectedPlanIDs {
-		logger.Warnf("检测到计划 #%d 在应用崩溃前处于未完成状态，将重置其计数并标记为失败。", planID)
-		// 使用 UpdatePlanStateAfterExecution 来更新主表状态，避免影响关联数据
-		if err := planRepo.UpdatePlanStateAfterExecution(planID, 0, models.PlanStatusFailed); err != nil {
-			logger.Errorf("重置计划 #%d 计数并标记为失败时出错: %v", planID, err)
-			// 这是一个非阻塞性错误，继续处理其他计划
-		}
-	}
-	logger.Info("阶段二：计划主表状态修正完成。")
-
-	// 直接调用新的方法来更新计划执行日志状态为失败
-	if err := executionLogRepo.FailAllIncompletePlanExecutionLogs(); err != nil {
-		logger.Errorf("更新所有未完成计划执行日志状态为失败失败: %v", err)
-		// 这是一个非阻塞性错误，继续执行
-	}
-
-	// 直接调用新的方法来更新任务执行日志状态为取消
-	if err := executionLogRepo.CancelAllIncompleteTaskExecutionLogs(); err != nil {
-		logger.Errorf("更新所有未完成任务执行日志状态为取消失败: %v", err)
-		// 这是一个非阻塞性错误，继续执行
-	}
-
-	// 清空待执行列表
-	if err := pendingTaskRepo.ClearAllPendingTasks(); err != nil {
-		return fmt.Errorf("清空待执行任务列表失败: %w", err)
-	}
-	logger.Info("阶段二：待执行任务和相关日志清理完成。")
-
-	// 阶段三：初始刷新
-	logger.Info("阶段三：开始刷新待执行列表...")
-	if err := analysisPlanTaskManager.Refresh(); err != nil {
-		return fmt.Errorf("刷新待执行任务列表失败: %w", err)
-	}
-	logger.Info("阶段三：待执行任务列表初始化完成。")
-
-	logger.Info("待执行任务列表初始化完成。")
-	return nil
-}
-
-// initStorage 封装了数据库的初始化、连接和迁移逻辑。
-func initStorage(cfg config.DatabaseConfig, logger *logs.Logger) (database.Storage, error) {
-	// 创建存储实例
-	storage := database.NewStorage(cfg, logger)
-	if err := storage.Connect(); err != nil {
-		// 错误已在 Connect 内部被记录，这里只需包装并返回
-		return nil, fmt.Errorf("数据库连接失败: %w", err)
-	}
-
-	// 执行数据库迁移
-	if err := storage.Migrate(models.GetAllModels()...); err != nil {
-		return nil, fmt.Errorf("数据库迁移失败: %w", err)
-	}
-
-	logger.Info("数据库初始化完成。")
-	return storage, nil
-}

internal/core/component_initializers.go

@@ -0,0 +1,385 @@
+package core
+
+import (
+	"fmt"
+	"time"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
+	"git.huangwc.com/pig/pig-farm-controller/internal/app/webhook"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/audit"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/device"
+	domain_notify "git.huangwc.com/pig/pig-farm-controller/internal/domain/notify"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/pig"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/plan"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/task"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/token"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/config"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/database"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/notify"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/transport"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/transport/lora"
+	"gorm.io/gorm"
+)
+
+// Infrastructure 聚合了所有基础设施层的组件。
+type Infrastructure struct {
+	storage       database.Storage
+	repos         *Repositories
+	lora          *LoraComponents
+	notifyService domain_notify.Service
+	tokenService  token.Service
+}
+
+// initInfrastructure 初始化所有基础设施层组件。
+func initInfrastructure(cfg *config.Config, logger *logs.Logger) (*Infrastructure, error) {
+	storage, err := initStorage(cfg.Database, logger)
+	if err != nil {
+		return nil, err
+	}
+
+	repos := initRepositories(storage.GetDB(), logger)
+
+	lora, err := initLora(cfg, logger, repos)
+	if err != nil {
+		return nil, err
+	}
+
+	notifyService, err := initNotifyService(cfg.Notify, logger, repos.userRepo, repos.notificationRepo)
+	if err != nil {
+		return nil, fmt.Errorf("初始化通知服务失败: %w", err)
+	}
+
+	tokenService := token.NewTokenService([]byte(cfg.App.JWTSecret))
+
+	return &Infrastructure{
+		storage:       storage,
+		repos:         repos,
+		lora:          lora,
+		notifyService: notifyService,
+		tokenService:  tokenService,
+	}, nil
+}
+
+// Repositories 聚合了所有的仓库实例。
+type Repositories struct {
+	userRepo              repository.UserRepository
+	deviceRepo            repository.DeviceRepository
+	areaControllerRepo    repository.AreaControllerRepository
+	deviceTemplateRepo    repository.DeviceTemplateRepository
+	planRepo              repository.PlanRepository
+	pendingTaskRepo       repository.PendingTaskRepository
+	executionLogRepo      repository.ExecutionLogRepository
+	sensorDataRepo        repository.SensorDataRepository
+	deviceCommandLogRepo  repository.DeviceCommandLogRepository
+	pendingCollectionRepo repository.PendingCollectionRepository
+	userActionLogRepo     repository.UserActionLogRepository
+	pigBatchRepo          repository.PigBatchRepository
+	pigBatchLogRepo       repository.PigBatchLogRepository
+	pigFarmRepo           repository.PigFarmRepository
+	pigPenRepo            repository.PigPenRepository
+	pigTransferLogRepo    repository.PigTransferLogRepository
+	pigTradeRepo          repository.PigTradeRepository
+	pigSickPigLogRepo     repository.PigSickLogRepository
+	medicationLogRepo     repository.MedicationLogRepository
+	rawMaterialRepo       repository.RawMaterialRepository
+	notificationRepo      repository.NotificationRepository
+	unitOfWork            repository.UnitOfWork
+}
+
+// initRepositories 初始化所有的仓库。
+func initRepositories(db *gorm.DB, logger *logs.Logger) *Repositories {
+	return &Repositories{
+		userRepo:              repository.NewGormUserRepository(db),
+		deviceRepo:            repository.NewGormDeviceRepository(db),
+		areaControllerRepo:    repository.NewGormAreaControllerRepository(db),
+		deviceTemplateRepo:    repository.NewGormDeviceTemplateRepository(db),
+		planRepo:              repository.NewGormPlanRepository(db),
+		pendingTaskRepo:       repository.NewGormPendingTaskRepository(db),
+		executionLogRepo:      repository.NewGormExecutionLogRepository(db),
+		sensorDataRepo:        repository.NewGormSensorDataRepository(db),
+		deviceCommandLogRepo:  repository.NewGormDeviceCommandLogRepository(db),
+		pendingCollectionRepo: repository.NewGormPendingCollectionRepository(db),
+		userActionLogRepo:     repository.NewGormUserActionLogRepository(db),
+		pigBatchRepo:          repository.NewGormPigBatchRepository(db),
+		pigBatchLogRepo:       repository.NewGormPigBatchLogRepository(db),
+		pigFarmRepo:           repository.NewGormPigFarmRepository(db),
+		pigPenRepo:            repository.NewGormPigPenRepository(db),
+		pigTransferLogRepo:    repository.NewGormPigTransferLogRepository(db),
+		pigTradeRepo:          repository.NewGormPigTradeRepository(db),
+		pigSickPigLogRepo:     repository.NewGormPigSickLogRepository(db),
+		medicationLogRepo:     repository.NewGormMedicationLogRepository(db),
+		rawMaterialRepo:       repository.NewGormRawMaterialRepository(db),
+		notificationRepo:      repository.NewGormNotificationRepository(db),
+		unitOfWork:            repository.NewGormUnitOfWork(db, logger),
+	}
+}
+
+// DomainServices 聚合了所有的领域服务实例。
+type DomainServices struct {
+	pigPenTransferManager   pig.PigPenTransferManager
+	pigTradeManager         pig.PigTradeManager
+	pigSickManager          pig.SickPigManager
+	pigBatchDomain          pig.PigBatchService
+	generalDeviceService    device.Service
+	taskFactory             plan.TaskFactory
+	planExecutionManager    plan.ExecutionManager
+	analysisPlanTaskManager plan.AnalysisPlanTaskManager
+	planService             plan.Service
+}
+
+// initDomainServices 初始化所有的领域服务。
+func initDomainServices(cfg *config.Config, infra *Infrastructure, logger *logs.Logger) *DomainServices {
+	// 猪群管理相关
+	pigPenTransferManager := pig.NewPigPenTransferManager(infra.repos.pigPenRepo, infra.repos.pigTransferLogRepo, infra.repos.pigBatchRepo)
+	pigTradeManager := pig.NewPigTradeManager(infra.repos.pigTradeRepo)
+	pigSickManager := pig.NewSickPigManager(infra.repos.pigSickPigLogRepo, infra.repos.medicationLogRepo)
+	pigBatchDomain := pig.NewPigBatchService(infra.repos.pigBatchRepo, infra.repos.pigBatchLogRepo, infra.repos.unitOfWork,
+		pigPenTransferManager, pigTradeManager, pigSickManager)
+
+	// 通用设备服务
+	generalDeviceService := device.NewGeneralDeviceService(
+		infra.repos.deviceRepo,
+		infra.repos.deviceCommandLogRepo,
+		infra.repos.pendingCollectionRepo,
+		logger,
+		infra.lora.comm,
+	)
+
+	// 任务工厂
+	taskFactory := task.NewTaskFactory(logger, infra.repos.sensorDataRepo, infra.repos.deviceRepo, generalDeviceService)
+
+	// 计划任务管理器
+	analysisPlanTaskManager := plan.NewAnalysisPlanTaskManager(infra.repos.planRepo, infra.repos.pendingTaskRepo, infra.repos.executionLogRepo, logger)
+
+	// 任务执行器
+	planExecutionManager := plan.NewPlanExecutionManager(
+		infra.repos.pendingTaskRepo,
+		infra.repos.executionLogRepo,
+		infra.repos.deviceRepo,
+		infra.repos.sensorDataRepo,
+		infra.repos.planRepo,
+		analysisPlanTaskManager,
+		taskFactory,
+		logger,
+		generalDeviceService,
+		time.Duration(cfg.Task.Interval)*time.Second,
+		cfg.Task.NumWorkers,
+	)
+
+	// 计划管理器
+	planService := plan.NewPlanService(
+		planExecutionManager,
+		analysisPlanTaskManager,
+		infra.repos.planRepo,
+		infra.repos.deviceRepo,
+		infra.repos.unitOfWork,
+		taskFactory,
+		logger)
+
+	return &DomainServices{
+		pigPenTransferManager:   pigPenTransferManager,
+		pigTradeManager:         pigTradeManager,
+		pigSickManager:          pigSickManager,
+		pigBatchDomain:          pigBatchDomain,
+		generalDeviceService:    generalDeviceService,
+		analysisPlanTaskManager: analysisPlanTaskManager,
+		taskFactory:             taskFactory,
+		planExecutionManager:    planExecutionManager,
+		planService:             planService,
+	}
+}
+
+// AppServices 聚合了所有的应用服务实例。
+type AppServices struct {
+	pigFarmService  service.PigFarmService
+	pigBatchService service.PigBatchService
+	monitorService  service.MonitorService
+	deviceService   service.DeviceService
+	planService     service.PlanService
+	userService     service.UserService
+	auditService    audit.Service
+}
+
+// initAppServices 初始化所有的应用服务。
+func initAppServices(infra *Infrastructure, domainServices *DomainServices, logger *logs.Logger) *AppServices {
+	pigFarmService := service.NewPigFarmService(infra.repos.pigFarmRepo, infra.repos.pigPenRepo, infra.repos.pigBatchRepo, domainServices.pigBatchDomain, infra.repos.unitOfWork, logger)
+	pigBatchService := service.NewPigBatchService(domainServices.pigBatchDomain, logger)
+	monitorService := service.NewMonitorService(
+		infra.repos.sensorDataRepo,
+		infra.repos.deviceCommandLogRepo,
+		infra.repos.executionLogRepo,
+		infra.repos.planRepo,
+		infra.repos.pendingCollectionRepo,
+		infra.repos.userActionLogRepo,
+		infra.repos.rawMaterialRepo,
+		infra.repos.medicationLogRepo,
+		infra.repos.pigBatchRepo,
+		infra.repos.pigBatchLogRepo,
+		infra.repos.pigTransferLogRepo,
+		infra.repos.pigSickPigLogRepo,
+		infra.repos.pigTradeRepo,
+		infra.repos.notificationRepo,
+	)
+	deviceService := service.NewDeviceService(
+		infra.repos.deviceRepo,
+		infra.repos.areaControllerRepo,
+		infra.repos.deviceTemplateRepo,
+		domainServices.generalDeviceService,
+	)
+	auditService := audit.NewService(infra.repos.userActionLogRepo, logger)
+	planService := service.NewPlanService(logger, domainServices.planService)
+	userService := service.NewUserService(infra.repos.userRepo, infra.tokenService, infra.notifyService, logger)
+
+	return &AppServices{
+		pigFarmService:  pigFarmService,
+		pigBatchService: pigBatchService,
+		monitorService:  monitorService,
+		deviceService:   deviceService,
+		auditService:    auditService,
+		planService:     planService,
+		userService:     userService,
+	}
+}
+
+// LoraComponents 聚合了所有 LoRa 相关组件。
+type LoraComponents struct {
+	listenHandler webhook.ListenHandler
+	comm          transport.Communicator
+	loraListener  transport.Listener
+}
+
+// initLora 根据配置初始化 LoRa 相关组件。
+func initLora(
+	cfg *config.Config,
+	logger *logs.Logger,
+	repos *Repositories,
+) (*LoraComponents, error) {
+	var listenHandler webhook.ListenHandler
+	var comm transport.Communicator
+	var loraListener transport.Listener
+
+	if cfg.Lora.Mode == config.LoraMode_LoRaWAN {
+		logger.Info("当前运行模式: lora_wan。初始化 ChirpStack 监听器和传输层。")
+		listenHandler = webhook.NewChirpStackListener(logger, repos.sensorDataRepo, repos.deviceRepo, repos.areaControllerRepo, repos.deviceCommandLogRepo, repos.pendingCollectionRepo)
+		comm = lora.NewChirpStackTransport(cfg.ChirpStack, logger)
+		loraListener = lora.NewPlaceholderTransport(logger)
+	} else {
+		logger.Info("当前运行模式: lora_mesh。初始化 LoRa Mesh 传输层和占位符监听器。")
+		listenHandler = webhook.NewPlaceholderListener(logger)
+		tp, err := lora.NewLoRaMeshUartPassthroughTransport(cfg.LoraMesh, logger, repos.areaControllerRepo, repos.pendingCollectionRepo, repos.deviceRepo, repos.sensorDataRepo)
+		if err != nil {
+			return nil, fmt.Errorf("无法初始化 LoRa Mesh 模块: %w", err)
+		}
+		loraListener = tp
+		comm = tp
+	}
+
+	return &LoraComponents{
+		listenHandler: listenHandler,
+		comm:          comm,
+		loraListener:  loraListener,
+	}, nil
+}
+
+// initNotifyService 根据配置初始化并返回一个通知领域服务。
+// 它确保至少有一个 LogNotifier 总是可用，并根据配置启用其他通知器。
+func initNotifyService(
+	cfg config.NotifyConfig,
+	log *logs.Logger,
+	userRepo repository.UserRepository,
+	notificationRepo repository.NotificationRepository,
+) (domain_notify.Service, error) {
+	var availableNotifiers []notify.Notifier
+
+	// 1. 总是创建 LogNotifier 作为所有告警的最终记录渠道
+	logNotifier := notify.NewLogNotifier(log)
+	availableNotifiers = append(availableNotifiers, logNotifier)
+	log.Info("Log通知器已启用 (作为所有告警的最终记录渠道)")
+
+	// 2. 根据配置，按需创建并收集所有启用的其他 Notifier 实例
+	if cfg.SMTP.Enabled {
+		smtpNotifier := notify.NewSMTPNotifier(
+			cfg.SMTP.Host,
+			cfg.SMTP.Port,
+			cfg.SMTP.Username,
+			cfg.SMTP.Password,
+			cfg.SMTP.Sender,
+		)
+		availableNotifiers = append(availableNotifiers, smtpNotifier)
+		log.Info("SMTP通知器已启用")
+	}
+
+	if cfg.WeChat.Enabled {
+		wechatNotifier := notify.NewWechatNotifier(
+			cfg.WeChat.CorpID,
+			cfg.WeChat.AgentID,
+			cfg.WeChat.Secret,
+		)
+		availableNotifiers = append(availableNotifiers, wechatNotifier)
+		log.Info("企业微信通知器已启用")
+	}
+
+	if cfg.Lark.Enabled {
+		larkNotifier := notify.NewLarkNotifier(
+			cfg.Lark.AppID,
+			cfg.Lark.AppSecret,
+		)
+		availableNotifiers = append(availableNotifiers, larkNotifier)
+		log.Info("飞书通知器已启用")
+	}
+
+	// 3. 动态确定首选通知器
+	var primaryNotifier notify.Notifier
+	primaryNotifierType := notify.NotifierType(cfg.Primary)
+
+	// 检查用户指定的主渠道是否已启用
+	for _, n := range availableNotifiers {
+		if n.Type() == primaryNotifierType {
+			primaryNotifier = n
+			break
+		}
+	}
+
+	// 如果用户指定的主渠道未启用或未指定，则自动选择第一个可用的 (这将是 LogNotifier，如果其他都未启用)
+	if primaryNotifier == nil {
+		primaryNotifier = availableNotifiers[0] // 确保总能找到一个，因为 LogNotifier 总是存在的
+		log.Warnf("配置的首选渠道 '%s' 未启用或未指定，已自动降级使用 '%s' 作为首选渠道。", cfg.Primary, primaryNotifier.Type())
+	}
+
+	// 4. 使用创建的 Notifier 列表和 notificationRepo 来组装领域服务
+	notifyService, err := domain_notify.NewFailoverService(
+		log,
+		userRepo,
+		availableNotifiers,
+		primaryNotifier.Type(),
+		cfg.FailureThreshold,
+		notificationRepo,
+	)
+	if err != nil {
+		return nil, fmt.Errorf("创建故障转移通知服务失败: %w", err)
+	}
+
+	log.Infof("通知服务初始化成功，首选渠道: %s, 故障阈值: %d", primaryNotifier.Type(), cfg.FailureThreshold)
+	return notifyService, nil
+}
+
+// initStorage 封装了数据库的初始化、连接和迁移逻辑。
+func initStorage(cfg config.DatabaseConfig, logger *logs.Logger) (database.Storage, error) {
+	// 创建存储实例
+	storage := database.NewStorage(cfg, logger)
+	if err := storage.Connect(); err != nil {
+		// 错误已在 Connect 内部被记录，这里只需包装并返回
+		return nil, fmt.Errorf("数据库连接失败: %w", err)
+	}
+
+	// 执行数据库迁移
+	if err := storage.Migrate(models.GetAllModels()...); err != nil {
+		return nil, fmt.Errorf("数据库迁移失败: %w", err)
+	}
+
+	logger.Info("数据库初始化完成。")
+	return storage, nil
+}

internal/core/data_initializer.go

@@ -0,0 +1,245 @@
+package core
+
+import (
+	"fmt"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+)
+
+const (
+	// PlanNameTimedFullDataCollection 是定时全量数据采集计划的名称
+	PlanNameTimedFullDataCollection = "定时全量数据采集"
+)
+
+// initializeState 在应用启动时准备其初始数据状态。
+// 这包括清理任何因上次异常关闭而留下的悬空任务或请求。
+func (app *Application) initializeState() error {
+	// 初始化预定义系统计划 (致命错误)
+	if err := app.initializeSystemPlans(); err != nil {
+		return fmt.Errorf("初始化预定义系统计划失败: %w", err)
+	}
+
+	// 清理待采集任务 (非致命错误)
+	if err := app.initializePendingCollections(); err != nil {
+		app.Logger.Errorw("清理待采集任务时发生非致命错误", "error", err)
+	}
+
+	// 初始化待执行任务列表 (致命错误)
+	if err := app.initializePendingTasks(); err != nil {
+		return fmt.Errorf("初始化待执行任务列表失败: %w", err)
+	}
+
+	return nil
+}
+
+// initializeSystemPlans 确保预定义的系统计划在数据库中存在并保持最新。
+func (app *Application) initializeSystemPlans() error {
+	app.Logger.Info("开始检查并更新预定义的系统计划...")
+
+	// 动态构建预定义计划列表
+	predefinedSystemPlans := app.getPredefinedSystemPlans()
+
+	// 1. 获取所有已存在的系统计划
+	existingPlans, _, err := app.Infra.repos.planRepo.ListPlans(repository.ListPlansOptions{
+		PlanType: repository.PlanTypeFilterSystem,
+	}, 1, 99999) // 使用一个较大的 pageSize 来获取所有系统计划
+	if err != nil {
+		return fmt.Errorf("获取现有系统计划失败: %w", err)
+	}
+
+	// 2. 为了方便查找, 将现有计划名放入一个 map
+	existingPlanMap := make(map[string]*models.Plan)
+	for i := range existingPlans {
+		existingPlanMap[existingPlans[i].Name] = &existingPlans[i]
+	}
+
+	// 3. 遍历预定义的计划列表
+	for i := range predefinedSystemPlans {
+		predefinedPlan := &predefinedSystemPlans[i] // 获取可修改的指针
+
+		if foundExistingPlan, ok := existingPlanMap[predefinedPlan.Name]; ok {
+			// 如果计划存在，则进行无差别更新
+			app.Logger.Infof("预定义计划 '%s' 已存在，正在进行无差别更新...", predefinedPlan.Name)
+
+			// 将数据库中已存在的计划的ID和运行时状态字段赋值给预定义计划
+			predefinedPlan.ID = foundExistingPlan.ID
+			predefinedPlan.ExecuteCount = foundExistingPlan.ExecuteCount
+
+			if err := app.Infra.repos.planRepo.UpdatePlan(predefinedPlan); err != nil {
+				return fmt.Errorf("更新预定义计划 '%s' 失败: %w", predefinedPlan.Name, err)
+			} else {
+				app.Logger.Infof("成功更新预定义计划 '%s'。", predefinedPlan.Name)
+			}
+		} else {
+			// 如果计划不存在, 则创建
+			app.Logger.Infof("预定义计划 '%s' 不存在，正在创建...", predefinedPlan.Name)
+			if err := app.Infra.repos.planRepo.CreatePlan(predefinedPlan); err != nil {
+				return fmt.Errorf("创建预定义计划 '%s' 失败: %w", predefinedPlan.Name, err)
+			} else {
+				app.Logger.Infof("成功创建预定义计划 '%s'。", predefinedPlan.Name)
+			}
+		}
+	}
+
+	app.Logger.Info("预定义系统计划检查完成。")
+	return nil
+}
+
+// getPredefinedSystemPlans 返回一个基于当前配置的预定义系统计划列表。
+func (app *Application) getPredefinedSystemPlans() []models.Plan {
+
+	// 根据配置创建定时全量采集计划
+	interval := app.Config.Collection.Interval
+	if interval <= 0 {
+		interval = 1 // 确保间隔至少为1分钟
+	}
+	cronExpression := fmt.Sprintf("*/%d * * * *", interval)
+	timedCollectionPlan := models.Plan{
+		Name:           PlanNameTimedFullDataCollection,
+		Description:    fmt.Sprintf("这是一个系统预定义的计划, 每 %d 分钟自动触发一次全量数据采集。", app.Config.Collection.Interval),
+		PlanType:       models.PlanTypeSystem,
+		ExecutionType:  models.PlanExecutionTypeAutomatic,
+		CronExpression: cronExpression,
+		Status:         models.PlanStatusEnabled,
+		ContentType:    models.PlanContentTypeTasks,
+		Tasks: []models.Task{
+			{
+				Name:           "全量采集",
+				Description:    "触发一次全量数据采集",
+				ExecutionOrder: 1,
+				Type:           models.TaskTypeFullCollection,
+			},
+		},
+	}
+
+	return []models.Plan{timedCollectionPlan}
+}
+
+// initializePendingCollections 在应用启动时处理所有未完成的采集请求。
+// 我们的策略是：任何在程序重启前仍处于“待处理”状态的请求，都应被视为已失败。
+// 这保证了系统在每次启动时都处于一个干净、确定的状态。
+func (app *Application) initializePendingCollections() error {
+	app.Logger.Info("开始清理所有未完成的采集请求...")
+
+	// 直接将所有 'pending' 状态的请求更新为 'timed_out'。
+	count, err := app.Infra.repos.pendingCollectionRepo.MarkAllPendingAsTimedOut()
+	if err != nil {
+		return fmt.Errorf("清理未完成的采集请求失败: %v", err)
+	} else if count > 0 {
+		app.Logger.Infof("成功将 %d 个未完成的采集请求标记为超时。", count)
+	} else {
+		app.Logger.Info("没有需要清理的采集请求。")
+	}
+
+	return nil
+}
+
+// initializePendingTasks 在应用启动时清理并刷新待执行任务列表。
+func (app *Application) initializePendingTasks() error {
+	logger := app.Logger
+	planRepo := app.Infra.repos.planRepo
+	pendingTaskRepo := app.Infra.repos.pendingTaskRepo
+	executionLogRepo := app.Infra.repos.executionLogRepo
+	planService := app.Domain.planService
+
+	logger.Info("开始初始化待执行任务列表...")
+
+	// 阶段一：修正因崩溃导致状态不一致的固定次数计划
+	logger.Info("阶段一：开始修正因崩溃导致状态不一致的固定次数计划...")
+	plansToCorrect, err := planRepo.FindPlansWithPendingTasks()
+	if err != nil {
+		return fmt.Errorf("查找需要修正的计划失败: %w", err)
+	}
+
+	for _, plan := range plansToCorrect {
+		logger.Infof("发现需要修正的计划 #%d (名称: %s)。", plan.ID, plan.Name)
+
+		// 更新计划的执行计数
+		plan.ExecuteCount++
+		logger.Infof("计划 #%d 执行计数已从 %d 更新为 %d。", plan.ID, plan.ExecuteCount-1, plan.ExecuteCount)
+
+		if plan.ExecutionType == models.PlanExecutionTypeManual ||
+			(plan.ExecutionType == models.PlanExecutionTypeAutomatic && plan.ExecuteCount >= plan.ExecuteNum) {
+			// 更新计划状态为已停止
+			plan.Status = models.PlanStatusStopped
+			logger.Infof("计划 #%d 状态已更新为 '执行完毕'。", plan.ID)
+
+		}
+		// 保存更新后的计划
+		if err := planRepo.UpdatePlan(plan); err != nil {
+			logger.Errorf("修正计划 #%d 状态失败: %v", plan.ID, err)
+			// 这是一个非阻塞性错误，继续处理其他计划
+		}
+	}
+	logger.Info("阶段一：固定次数计划修正完成。")
+
+	// 阶段二：清理所有待执行任务和相关日志
+	logger.Info("阶段二：开始清理所有待执行任务和相关日志...")
+
+	// --- 新增逻辑：处理因崩溃导致状态不一致的计划主表状态 ---
+	// 1. 查找所有未完成的计划执行日志 (状态为 Started 或 Waiting)
+	incompletePlanLogs, err := executionLogRepo.FindIncompletePlanExecutionLogs()
+	if err != nil {
+		return fmt.Errorf("查找未完成的计划执行日志失败: %w", err)
+	}
+
+	// 2. 收集所有受影响的唯一 PlanID
+	affectedPlanIDs := make(map[uint]struct{})
+	for _, log := range incompletePlanLogs {
+		affectedPlanIDs[log.PlanID] = struct{}{}
+	}
+
+	// 3. 对于每个受影响的 PlanID，重置其 execute_count 并将其状态设置为 Failed, 系统计划不受此影响
+	for planID := range affectedPlanIDs {
+		// 首先，获取计划的详细信息以判断其类型
+		plan, err := planRepo.GetBasicPlanByID(planID)
+		if err != nil {
+			logger.Errorf("在尝试修正计划状态时，获取计划 #%d 的基本信息失败: %v", planID, err)
+			continue // 获取失败，跳过此计划
+		}
+
+		// 如果是系统计划，则不应标记为失败，仅记录日志
+		if plan.PlanType == models.PlanTypeSystem {
+			logger.Warnf("检测到系统计划 #%d 在应用崩溃前处于未完成状态，但根据策略，将保持其原有状态不标记为失败。", planID)
+			continue // 跳过，不处理
+		}
+
+		// 对于非系统计划，执行原有的失败标记逻辑
+		logger.Warnf("检测到计划 #%d 在应用崩溃前处于未完成状态，将重置其计数并标记为失败。", planID)
+		// 使用 UpdatePlanStateAfterExecution 来更新主表状态，避免影响关联数据
+		if err := planRepo.UpdatePlanStateAfterExecution(planID, 0, models.PlanStatusFailed); err != nil {
+			logger.Errorf("重置计划 #%d 计数并标记为失败时出错: %v", planID, err)
+			// 这是一个非阻塞性错误，继续处理其他计划
+		}
+	}
+	logger.Info("阶段二：计划主表状态修正完成。")
+
+	// 直接调用新的方法来更新计划执行日志状态为失败
+	if err := executionLogRepo.FailAllIncompletePlanExecutionLogs(); err != nil {
+		logger.Errorf("更新所有未完成计划执行日志状态为失败失败: %v", err)
+		// 这是一个非阻塞性错误，继续执行
+	}
+
+	// 直接调用新的方法来更新任务执行日志状态为取消
+	if err := executionLogRepo.CancelAllIncompleteTaskExecutionLogs(); err != nil {
+		logger.Errorf("更新所有未完成任务执行日志状态为取消失败: %v", err)
+		// 这是一个非阻塞性错误，继续执行
+	}
+
+	// 清空待执行列表
+	if err := pendingTaskRepo.ClearAllPendingTasks(); err != nil {
+		return fmt.Errorf("清空待执行任务列表失败: %w", err)
+	}
+	logger.Info("阶段二：待执行任务和相关日志清理完成。")
+
+	// 阶段三：初始刷新
+	logger.Info("阶段三：开始刷新待执行列表...")
+	if err := planService.RefreshPlanTriggers(); err != nil {
+		return fmt.Errorf("刷新待执行任务列表失败: %w", err)
+	}
+	logger.Info("阶段三：待执行任务列表初始化完成。")
+
+	logger.Info("待执行任务列表初始化完成。")
+	return nil
+}

internal/domain/device/general_device_service.go

@@ -5,16 +5,15 @@ import (
 	"fmt"
 	"time"
 
-	"git.huangwc.com/pig/pig-farm-controller/internal/domain/device/proto"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/transport"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/transport/proto"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/utils/command_generater"
 
 	"github.com/google/uuid"
 	gproto "google.golang.org/protobuf/proto"
-	"google.golang.org/protobuf/types/known/anypb"
 )
 
 type GeneralDeviceService struct {
@@ -90,14 +89,10 @@ func (g *GeneralDeviceService) Switch(device *models.Device, action DeviceAction
 		CommandBytes: modbusCommandBytes,
 	}
 
-	data, err := anypb.New(raw485Cmd)
-	if err != nil {
-		return fmt.Errorf("创建 Raw485Command Any Protobuf 失败: %w", err)
-	}
-
 	instruction := &proto.Instruction{
-		Method: proto.MethodType_INSTRUCTION, // 使用通用指令类型
-		Data:   data,
+		Payload: &proto.Instruction_Raw_485Command{
+			Raw_485Command: raw485Cmd,
+		},
 	}
 
 	message, err := gproto.Marshal(instruction)
@@ -118,6 +113,13 @@ func (g *GeneralDeviceService) Switch(device *models.Device, action DeviceAction
 		DeviceID:  areaController.ID,
 		SentAt:    time.Now(),
 	}
+	if sendResult.AcknowledgedAt != nil {
+		logRecord.AcknowledgedAt = sendResult.AcknowledgedAt
+	}
+	if sendResult.ReceivedSuccess != nil {
+		logRecord.ReceivedSuccess = *sendResult.ReceivedSuccess
+	}
+
 	if err := g.deviceCommandLogRepo.Create(logRecord); err != nil {
 		// 记录日志失败是一个需要关注的问题，但可能不应该中断主流程。
 		// 我们记录一个错误日志，然后成功返回。
@@ -184,6 +186,7 @@ func (g *GeneralDeviceService) Collect(regionalControllerID uint, devicesToColle
 			g.logger.Warnf("跳过设备 %d，因生成Modbus RTU读取指令失败: %v", dev.ID, err)
 			continue
 		}
+		g.logger.Debugf("生成485指令: %v", modbusCommandBytes)
 
 		// 构建 Raw485Command，包含总线号
 		raw485Cmd := &proto.Raw485Command{
@@ -224,21 +227,17 @@ func (g *GeneralDeviceService) Collect(regionalControllerID uint, devicesToColle
 		CorrelationId: correlationID,
 		Tasks:         collectTasks,
 	}
-	anyData, err := anypb.New(batchCmd)
-	if err != nil {
-		g.logger.Errorf("创建 Any Protobuf 失败 (CorrelationID: %s): %v", correlationID, err)
-		return err
-	}
 	instruction := &proto.Instruction{
-		Method: proto.MethodType_COLLECT, // 使用 COLLECT 指令类型
-		Data:   anyData,
+		Payload: &proto.Instruction_BatchCollectCommand{
+			BatchCollectCommand: batchCmd,
+		},
 	}
 	payload, err := gproto.Marshal(instruction)
 	if err != nil {
 		g.logger.Errorf("序列化采集指令失败 (CorrelationID: %s): %v", correlationID, err)
 		return err
 	}
-
+	g.logger.Infof("构造空中载荷成功: networkID: %v, payload: %v", networkID, instruction)
 	if _, err := g.comm.Send(networkID, payload); err != nil {
 		g.logger.DPanicf("待采集请求 (CorrelationID: %s) 已创建，但发送到设备失败: %v。数据可能不一致！", correlationID, err)
 		return err

internal/domain/device/proto/device.proto

@@ -1,51 +0,0 @@
-syntax = "proto3";
-
-package device;
-
-import "google/protobuf/any.proto";
-
-option go_package = "internal/domain/device/proto";
-
-// --- 通用指令结构 ---
-
-// 指令类型
-enum MethodType {
-  INSTRUCTION = 0; // 下发指令
-  COLLECT = 1; // 批量采集
-}
-
-// 平台生成的原始485指令，单片机直接发送到总线
-message Raw485Command {
-  int32 bus_number = 1;    // 总线号，用于指示单片机将指令发送到哪个总线
-  bytes command_bytes = 2; // 原始485指令的字节数组
-}
-
-// 指令 (所有空中数据都会被包装在这里面)
-// data字段现在可以包含 Raw485Command，表示平台生成的原始485指令。
-message Instruction {
-  MethodType method = 1;
-  google.protobuf.Any data = 2; // 可以是 Switch, Raw485Command 等
-}
-
-// --- 批量采集相关结构 ---
-
-// BatchCollectCommand
-// 用于在平台内部构建一个完整的、包含所有元数据的批量采集任务。
-// 这个消息本身不会被发送到设备。
-message BatchCollectCommand {
-  string correlation_id = 1;        // 用于关联请求和响应的唯一ID
-  repeated CollectTask tasks = 2;   // 采集任务列表
-}
-
-// CollectTask
-// 定义了单个采集任务的“意图”。现在直接包含平台生成的原始485指令，并带上总线号。
-message CollectTask {
-  Raw485Command command = 2; // 平台生成的原始485指令
-}
-
-// CollectResult
-// 这是设备响应的、极致精简的数据包。
-message CollectResult {
-  string correlation_id = 1;   // 从下行指令中原样返回的关联ID
-  repeated float values = 2;   // 按预定顺序排列的采集值
-}

internal/domain/notify/notify.go

@@ -0,0 +1,292 @@
+package notify
+
+import (
+	"fmt"
+	"strings"
+	"sync"
+	"time"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/notify"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+	"go.uber.org/zap"
+)
+
+// Service 定义了通知领域的核心业务逻辑接口
+type Service interface {
+	// SendBatchAlarm 向一批用户发送告警通知。它会并发地为每个用户执行带故障转移的发送逻辑。
+	SendBatchAlarm(userIDs []uint, content notify.AlarmContent) error
+
+	// BroadcastAlarm 向所有用户发送告警通知。它会并发地为每个用户执行带故障转移的发送逻辑。
+	BroadcastAlarm(content notify.AlarmContent) error
+
+	// SendTestMessage 向指定用户发送一条测试消息，用于手动验证特定通知渠道的配置。
+	SendTestMessage(userID uint, notifierType notify.NotifierType) error
+}
+
+// failoverService 是 Service 接口的实现，提供了故障转移功能
+type failoverService struct {
+	log              *logs.Logger
+	userRepo         repository.UserRepository
+	notifiers        map[notify.NotifierType]notify.Notifier
+	primaryNotifier  notify.Notifier
+	failureThreshold int
+	failureCounters  *sync.Map // 使用 sync.Map 来安全地并发读写失败计数, key: userID (uint), value: counter (int)
+	notificationRepo repository.NotificationRepository
+}
+
+// NewFailoverService 创建一个新的故障转移通知服务
+func NewFailoverService(
+	log *logs.Logger,
+	userRepo repository.UserRepository,
+	notifiers []notify.Notifier,
+	primaryNotifierType notify.NotifierType,
+	failureThreshold int,
+	notificationRepo repository.NotificationRepository,
+) (Service, error) {
+	notifierMap := make(map[notify.NotifierType]notify.Notifier)
+	for _, n := range notifiers {
+		notifierMap[n.Type()] = n
+	}
+
+	primaryNotifier, ok := notifierMap[primaryNotifierType]
+	if !ok {
+		return nil, fmt.Errorf("首选通知器类型 '%s' 在提供的通知器列表中不存在", primaryNotifierType)
+	}
+
+	return &failoverService{
+		log:              log,
+		userRepo:         userRepo,
+		notifiers:        notifierMap,
+		primaryNotifier:  primaryNotifier,
+		failureThreshold: failureThreshold,
+		failureCounters:  &sync.Map{},
+		notificationRepo: notificationRepo,
+	}, nil
+}
+
+// SendBatchAlarm 实现了向多个用户并发发送告警的功能
+func (s *failoverService) SendBatchAlarm(userIDs []uint, content notify.AlarmContent) error {
+	var wg sync.WaitGroup
+	var mu sync.Mutex
+	var allErrors []string
+
+	s.log.Infow("开始批量发送告警...", "userCount", len(userIDs))
+
+	for _, userID := range userIDs {
+		wg.Add(1)
+		go func(id uint) {
+			defer wg.Done()
+			if err := s.sendAlarmToUser(id, content); err != nil {
+				mu.Lock()
+				allErrors = append(allErrors, fmt.Sprintf("发送失败 (用户ID: %d): %v", id, err))
+				mu.Unlock()
+			}
+		}(userID)
+	}
+
+	wg.Wait()
+
+	if len(allErrors) > 0 {
+		finalError := fmt.Errorf("批量告警发送完成，但有 %d 个用户发送失败:\n%s", len(allErrors), strings.Join(allErrors, "\n"))
+		s.log.Error(finalError.Error())
+		return finalError
+	}
+
+	s.log.Info("批量发送告警成功完成，所有用户均已通知。")
+	return nil
+}
+
+// BroadcastAlarm 实现了向所有用户发送告警的功能
+func (s *failoverService) BroadcastAlarm(content notify.AlarmContent) error {
+	users, err := s.userRepo.FindAll()
+	if err != nil {
+		s.log.Errorw("广播告警失败：查找所有用户时出错", "error", err)
+		return fmt.Errorf("广播告警失败：查找所有用户时出错: %w", err)
+	}
+
+	var userIDs []uint
+	for _, user := range users {
+		userIDs = append(userIDs, user.ID)
+	}
+
+	s.log.Infow("开始广播告警给所有用户", "totalUsers", len(userIDs))
+	// 复用 SendBatchAlarm 的逻辑进行并发发送和错误处理
+	return s.SendBatchAlarm(userIDs, content)
+}
+
+// sendAlarmToUser 是为单个用户发送告警的内部方法，包含了完整的故障转移逻辑
+func (s *failoverService) sendAlarmToUser(userID uint, content notify.AlarmContent) error {
+	user, err := s.userRepo.FindByID(userID)
+	if err != nil {
+		s.log.Errorw("发送告警失败：查找用户时出错", "userID", userID, "error", err)
+		return fmt.Errorf("查找用户失败: %w", err)
+	}
+
+	counter, _ := s.failureCounters.LoadOrStore(userID, 0)
+	failureCount := counter.(int)
+
+	if failureCount < s.failureThreshold {
+		primaryType := s.primaryNotifier.Type()
+		addr := getAddressForNotifier(primaryType, user.Contact)
+		if addr == "" {
+			// 记录跳过通知
+			s.recordNotificationAttempt(userID, primaryType, content, "", models.NotificationStatusSkipped, fmt.Errorf("用户未配置首选通知方式 '%s' 的地址", primaryType))
+			return fmt.Errorf("用户未配置首选通知方式 '%s' 的地址", primaryType)
+		}
+
+		err = s.primaryNotifier.Send(content, addr)
+		if err == nil {
+			// 记录成功通知
+			s.recordNotificationAttempt(userID, primaryType, content, addr, models.NotificationStatusSuccess, nil)
+			if failureCount > 0 {
+				s.log.Infow("首选渠道发送恢复正常", "userID", userID, "notifierType", primaryType)
+				s.failureCounters.Store(userID, 0)
+			}
+			return nil
+		}
+
+		// 记录失败通知
+		s.recordNotificationAttempt(userID, primaryType, content, addr, models.NotificationStatusFailed, err)
+		newFailureCount := failureCount + 1
+		s.failureCounters.Store(userID, newFailureCount)
+		s.log.Warnw("首选渠道发送失败", "userID", userID, "notifierType", primaryType, "error", err, "failureCount", newFailureCount)
+		failureCount = newFailureCount
+	}
+
+	if failureCount >= s.failureThreshold {
+		s.log.Warnw("故障转移阈值已达到，开始广播通知", "userID", userID, "threshold", s.failureThreshold)
+		var lastErr error
+		for _, notifier := range s.notifiers {
+			addr := getAddressForNotifier(notifier.Type(), user.Contact)
+			if addr == "" {
+				// 记录跳过通知
+				s.recordNotificationAttempt(userID, notifier.Type(), content, "", models.NotificationStatusSkipped, fmt.Errorf("用户未配置通知方式 '%s' 的地址", notifier.Type()))
+				continue
+			}
+			if err := notifier.Send(content, addr); err == nil {
+				// 记录成功通知
+				s.recordNotificationAttempt(userID, notifier.Type(), content, addr, models.NotificationStatusSuccess, nil)
+				s.log.Infow("广播通知成功", "userID", userID, "notifierType", notifier.Type())
+				s.failureCounters.Store(userID, 0)
+				return nil
+			}
+			// 记录失败通知
+			s.recordNotificationAttempt(userID, notifier.Type(), content, addr, models.NotificationStatusFailed, err)
+			lastErr = err
+			s.log.Warnw("广播通知：渠道发送失败", "userID", userID, "notifierType", notifier.Type(), "error", err)
+		}
+		return fmt.Errorf("所有渠道均发送失败，最后一个错误: %w", lastErr)
+	}
+
+	return nil
+}
+
+// SendTestMessage 实现了手动发送测试消息的功能
+func (s *failoverService) SendTestMessage(userID uint, notifierType notify.NotifierType) error {
+	user, err := s.userRepo.FindByID(userID)
+	if err != nil {
+		s.log.Errorw("发送测试消息失败：查找用户时出错", "userID", userID, "error", err)
+		return fmt.Errorf("查找用户失败: %w", err)
+	}
+
+	notifier, ok := s.notifiers[notifierType]
+	if !ok {
+		s.log.Errorw("发送测试消息失败：通知器类型不存在", "userID", userID, "notifierType", notifierType)
+		return fmt.Errorf("指定的通知器类型 '%s' 不存在", notifierType)
+	}
+
+	addr := getAddressForNotifier(notifierType, user.Contact)
+	if addr == "" {
+		s.log.Warnw("发送测试消息失败：缺少地址", "userID", userID, "notifierType", notifierType)
+		// 记录跳过通知
+		s.recordNotificationAttempt(userID, notifierType, notify.AlarmContent{
+			Title:     "通知服务测试",
+			Message:   fmt.Sprintf("这是一条来自【%s】渠道的测试消息。如果您收到此消息，说明您的配置正确。", notifierType),
+			Level:     zap.InfoLevel,
+			Timestamp: time.Now(),
+		}, "", models.NotificationStatusFailed, fmt.Errorf("用户未配置通知方式 '%s' 的地址", notifierType))
+		return fmt.Errorf("用户未配置通知方式 '%s' 的地址", notifierType)
+	}
+
+	testContent := notify.AlarmContent{
+		Title:     "通知服务测试",
+		Message:   fmt.Sprintf("这是一条来自【%s】渠道的测试消息。如果您收到此消息，说明您的配置正确。", notifierType),
+		Level:     zap.InfoLevel,
+		Timestamp: time.Now(),
+	}
+
+	s.log.Infow("正在发送测试消息...", "userID", userID, "notifierType", notifierType, "address", addr)
+	err = notifier.Send(testContent, addr)
+	if err != nil {
+		s.log.Errorw("发送测试消息失败", "userID", userID, "notifierType", notifierType, "error", err)
+		// 记录失败通知
+		s.recordNotificationAttempt(userID, notifierType, testContent, addr, models.NotificationStatusFailed, err)
+		return err
+	}
+
+	s.log.Infow("发送测试消息成功", "userID", userID, "notifierType", notifierType)
+	// 记录成功通知
+	s.recordNotificationAttempt(userID, notifierType, testContent, addr, models.NotificationStatusSuccess, nil)
+	return nil
+}
+
+// getAddressForNotifier 是一个辅助函数，根据通知器类型从 ContactInfo 中获取对应的地址
+func getAddressForNotifier(notifierType notify.NotifierType, contact models.ContactInfo) string {
+	switch notifierType {
+	case notify.NotifierTypeSMTP:
+		return contact.Email
+	case notify.NotifierTypeWeChat:
+		return contact.WeChat
+	case notify.NotifierTypeLark:
+		return contact.Feishu
+	case notify.NotifierTypeLog:
+		return "log" // LogNotifier不需要具体的地址，但为了函数签名一致性，返回一个无意义的非空字符串以绕过配置存在检查
+	default:
+		return ""
+	}
+}
+
+// recordNotificationAttempt 记录一次通知发送尝试的结果
+// userID: 接收通知的用户ID
+// notifierType: 使用的通知器类型
+// content: 通知内容
+// toAddress: 实际发送到的地址
+// status: 发送尝试的状态 (成功、失败、跳过)
+// err: 如果发送失败，记录的错误信息
+func (s *failoverService) recordNotificationAttempt(
+	userID uint,
+	notifierType notify.NotifierType,
+	content notify.AlarmContent,
+	toAddress string,
+	status models.NotificationStatus,
+	err error,
+) {
+	errorMessage := ""
+	if err != nil {
+		errorMessage = err.Error()
+	}
+
+	notification := &models.Notification{
+		NotifierType:   notifierType,
+		UserID:         userID,
+		Title:          content.Title,
+		Message:        content.Message,
+		Level:          models.LogLevel(content.Level),
+		AlarmTimestamp: content.Timestamp,
+		ToAddress:      toAddress,
+		Status:         status,
+		ErrorMessage:   errorMessage,
+	}
+
+	if saveErr := s.notificationRepo.Create(notification); saveErr != nil {
+		s.log.Errorw("无法保存通知发送记录到数据库",
+			"userID", userID,
+			"notifierType", notifierType,
+			"status", status,
+			"originalError", errorMessage,
+			"saveError", saveErr,
+		)
+	}
+}

internal/domain/pig/pig_batch.go

@@ -1,101 +0,0 @@
-package pig
-
-import (
-	"errors"
-	"time"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
-)
-
-// --- 业务错误定义 ---
-
-var (
-	// ErrPigBatchNotFound 表示当尝试访问一个不存在的猪批次时发生的错误。
-	ErrPigBatchNotFound = errors.New("指定的猪批次不存在")
-	// ErrPigBatchActive 表示当尝试对一个活跃的猪批次执行不允许的操作（如删除）时发生的错误。
-	ErrPigBatchActive = errors.New("活跃的猪批次不能被删除")
-	// ErrPigBatchNotActive 表示当猪批次不处于活跃状态，但执行了需要其活跃的操作时发生的错误。
-	ErrPigBatchNotActive = errors.New("猪批次不处于活跃状态，无法修改关联猪栏")
-	// ErrPenOccupiedByOtherBatch 表示当尝试将一个已经被其他批次占用的猪栏分配给新批次时发生的错误。
-	ErrPenOccupiedByOtherBatch = errors.New("猪栏已被其他批次使用")
-	// ErrPenStatusInvalidForAllocation 表示猪栏的当前状态（例如，'维修中'）不允许被分配。
-	ErrPenStatusInvalidForAllocation = errors.New("猪栏状态不允许分配")
-	// ErrPenNotFound 表示猪栏不存在
-	ErrPenNotFound = errors.New("指定的猪栏不存在")
-	// ErrPenNotAssociatedWithBatch 表示猪栏未与该批次关联
-	ErrPenNotAssociatedWithBatch = errors.New("猪栏未与该批次关联")
-	// ErrInvalidOperation 非法操作
-	ErrInvalidOperation = errors.New("非法操作")
-)
-
-// --- 领域服务接口 ---
-
-// PigBatchService 定义了猪批次管理的核心业务逻辑接口。
-// 它抽象了所有与猪批次相关的操作，使得应用层可以依赖于此接口，而不是具体的实现。
-type PigBatchService interface {
-	// CreatePigBatch 创建猪批次，并记录初始日志。
-	CreatePigBatch(operatorID uint, batch *models.PigBatch) (*models.PigBatch, error)
-	// GetPigBatch 获取单个猪批次。
-	GetPigBatch(id uint) (*models.PigBatch, error)
-	// UpdatePigBatch 更新猪批次信息。
-	UpdatePigBatch(batch *models.PigBatch) (*models.PigBatch, error)
-	// DeletePigBatch 删除猪批次，包含业务规则校验。
-	DeletePigBatch(id uint) error
-	// ListPigBatches 批量查询猪批次。
-	ListPigBatches(isActive *bool) ([]*models.PigBatch, error)
-	// UpdatePigBatchPens 更新猪批次关联的猪栏。
-	UpdatePigBatchPens(batchID uint, desiredPenIDs []uint) error
-	// AssignEmptyPensToBatch 为猪群分配空栏
-	AssignEmptyPensToBatch(batchID uint, penIDs []uint, operatorID uint) error
-	// MovePigsIntoPen 将猪只从“虚拟库存”移入指定猪栏
-	MovePigsIntoPen(batchID uint, toPenID uint, quantity int, operatorID uint, remarks string) error
-	// ReclassifyPenToNewBatch 连猪带栏，整体划拨到另一个猪群
-	ReclassifyPenToNewBatch(fromBatchID uint, toBatchID uint, penID uint, operatorID uint, remarks string) error
-
-	// GetCurrentPigQuantity 获取指定猪批次的当前猪只数量。
-	GetCurrentPigQuantity(batchID uint) (int, error)
-
-	UpdatePigBatchQuantity(operatorID uint, batchID uint, changeType models.LogChangeType, changeAmount int, changeReason string, happenedAt time.Time) error
-
-	// ---交易子服务---
-	// SellPigs 处理卖猪的业务逻辑。
-	SellPigs(batchID uint, penID uint, quantity int, unitPrice float64, tatalPrice float64, traderName string, tradeDate time.Time, remarks string, operatorID uint) error
-	// BuyPigs 处理买猪的业务逻辑。
-	BuyPigs(batchID uint, penID uint, quantity int, unitPrice float64, tatalPrice float64, traderName string, tradeDate time.Time, remarks string, operatorID uint) error
-
-	// ---调栏子服务 ---
-	TransferPigsAcrossBatches(sourceBatchID uint, destBatchID uint, fromPenID uint, toPenID uint, quantity uint, operatorID uint, remarks string) error
-	TransferPigsWithinBatch(batchID uint, fromPenID uint, toPenID uint, quantity uint, operatorID uint, remarks string) error
-}
-
-// pigBatchService 是 PigBatchService 接口的具体实现。
-// 它作为猪群领域的主服务，封装了所有业务逻辑。
-type pigBatchService struct {
-	pigBatchRepo    repository.PigBatchRepository    // 猪批次仓库
-	pigBatchLogRepo repository.PigBatchLogRepository // 猪批次日志仓库
-	uow             repository.UnitOfWork            // 工作单元，用于管理事务
-	transferSvc     PigPenTransferManager            // 调栏子服务
-	tradeSvc        PigTradeManager                  // 交易子服务
-	sickSvc         SickPigManager                   // 病猪子服务
-}
-
-// NewPigBatchService 是 pigBatchService 的构造函数。
-// 它通过依赖注入的方式，创建并返回一个 PigBatchService 接口的实例。
-func NewPigBatchService(
-	pigBatchRepo repository.PigBatchRepository,
-	pigBatchLogRepo repository.PigBatchLogRepository,
-	uow repository.UnitOfWork,
-	transferSvc PigPenTransferManager,
-	tradeSvc PigTradeManager,
-	sickSvc SickPigManager,
-) PigBatchService {
-	return &pigBatchService{
-		pigBatchRepo:    pigBatchRepo,
-		pigBatchLogRepo: pigBatchLogRepo,
-		uow:             uow,
-		transferSvc:     transferSvc,
-		tradeSvc:        tradeSvc,
-		sickSvc:         sickSvc,
-	}
-}

internal/domain/pig/pig_batch_service.go

@@ -2,295 +2,122 @@ package pig
 
 import (
 	"errors"
-	"fmt"
 	"time"
 
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"gorm.io/gorm"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
 )
 
-// --- 领域服务实现 ---
+// --- 业务错误定义 ---
 
-// CreatePigBatch 实现了创建猪批次的逻辑，并同时创建初始批次日志。
-func (s *pigBatchService) CreatePigBatch(operatorID uint, batch *models.PigBatch) (*models.PigBatch, error) {
-	// 业务规则可以在这里添加，例如检查批次号是否唯一等
+var (
+	// ErrPigBatchNotFound 表示当尝试访问一个不存在的猪批次时发生的错误。
+	ErrPigBatchNotFound = errors.New("指定的猪批次不存在")
+	// ErrPigBatchActive 表示当尝试对一个活跃的猪批次执行不允许的操作（如删除）时发生的错误。
+	ErrPigBatchActive = errors.New("活跃的猪批次不能被删除")
+	// ErrPigBatchNotActive 表示当猪批次不处于活跃状态，但执行了需要其活跃的操作时发生的错误。
+	ErrPigBatchNotActive = errors.New("猪批次不处于活跃状态，无法修改关联猪栏")
+	// ErrPenOccupiedByOtherBatch 表示当尝试将一个已经被其他批次占用的猪栏分配给新批次时发生的错误。
+	ErrPenOccupiedByOtherBatch = errors.New("猪栏已被其他批次使用")
+	// ErrPenStatusInvalidForAllocation 表示猪栏的当前状态（例如，'维修中'）不允许被分配。
+	ErrPenStatusInvalidForAllocation = errors.New("猪栏状态不允许分配")
+	// ErrPenNotFound 表示猪栏不存在
+	ErrPenNotFound = errors.New("指定的猪栏不存在")
+	// ErrPenNotAssociatedWithBatch 表示猪栏未与该批次关联
+	ErrPenNotAssociatedWithBatch = errors.New("猪栏未与该批次关联")
+	// ErrPenNotEmpty 表示猪栏内仍有猪只，不允许执行当前操作。
+	ErrPenNotEmpty = errors.New("猪栏内仍有猪只，无法执行此操作")
+	// ErrInvalidOperation 非法操作
+	ErrInvalidOperation = errors.New("非法操作")
+)
 
-	var createdBatch *models.PigBatch
-	err := s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
-		// 1. 创建猪批次
-		// 注意: 此处依赖一个假设存在的 pigBatchRepo.CreatePigBatchTx 方法
-		var err error
-		createdBatch, err = s.pigBatchRepo.CreatePigBatchTx(tx, batch)
-		if err != nil {
-			return fmt.Errorf("创建猪批次失败: %w", err)
-		}
+// --- 领域服务接口 ---
 
-		// 2. 创建初始批次日志
-		initialLog := &models.PigBatchLog{
-			PigBatchID:  createdBatch.ID,
-			HappenedAt:  time.Now(),
-			ChangeType:  models.ChangeTypeCorrection, // 初始创建可视为一种校正
-			ChangeCount: createdBatch.InitialCount,
-			Reason:      fmt.Sprintf("创建了新的猪批次 %s，初始数量 %d", createdBatch.BatchNumber, createdBatch.InitialCount),
-			BeforeCount: 0, // 初始创建前数量为0
-			AfterCount:  createdBatch.InitialCount,
-			OperatorID:  operatorID,
-		}
+// PigBatchService 定义了猪批次管理的核心业务逻辑接口。
+// 它抽象了所有与猪批次相关的操作，使得应用层可以依赖于此接口，而不是具体的实现。
+type PigBatchService interface {
+	// CreatePigBatch 创建猪批次，并记录初始日志。
+	CreatePigBatch(operatorID uint, batch *models.PigBatch) (*models.PigBatch, error)
+	// GetPigBatch 获取单个猪批次。
+	GetPigBatch(id uint) (*models.PigBatch, error)
+	// UpdatePigBatch 更新猪批次信息。
+	UpdatePigBatch(batch *models.PigBatch) (*models.PigBatch, error)
+	// DeletePigBatch 删除猪批次，包含业务规则校验。
+	DeletePigBatch(id uint) error
+	// ListPigBatches 批量查询猪批次。
+	ListPigBatches(isActive *bool) ([]*models.PigBatch, error)
+	// AssignEmptyPensToBatch 为猪群分配空栏
+	AssignEmptyPensToBatch(batchID uint, penIDs []uint, operatorID uint) error
+	// MovePigsIntoPen 将猪只从“虚拟库存”移入指定猪栏
+	MovePigsIntoPen(batchID uint, toPenID uint, quantity int, operatorID uint, remarks string) error
+	// ReclassifyPenToNewBatch 连猪带栏，整体划拨到另一个猪群
+	ReclassifyPenToNewBatch(fromBatchID uint, toBatchID uint, penID uint, operatorID uint, remarks string) error
+	// RemoveEmptyPenFromBatch 将一个猪栏移除出猪群，此方法需要在猪栏为空的情况下执行。
+	RemoveEmptyPenFromBatch(batchID uint, penID uint) error
 
-		// 3. 记录批次日志
-		if err := s.pigBatchLogRepo.CreateTx(tx, initialLog); err != nil {
-			return fmt.Errorf("记录初始批次日志失败: %w", err)
-		}
+	// GetCurrentPigQuantity 获取指定猪批次的当前猪只数量。
+	GetCurrentPigQuantity(batchID uint) (int, error)
+	// GetCurrentPigsInPen 获取指定猪栏的当前存栏量。
+	GetCurrentPigsInPen(penID uint) (int, error)
+	// GetTotalPigsInPensForBatch 获取指定猪群下所有猪栏的当前总存栏数
+	GetTotalPigsInPensForBatch(batchID uint) (int, error)
 
-		return nil
-	})
+	UpdatePigBatchQuantity(operatorID uint, batchID uint, changeType models.LogChangeType, changeAmount int, changeReason string, happenedAt time.Time) error
 
-	if err != nil {
-		return nil, err
-	}
+	// ---交易子服务---
+	// SellPigs 处理卖猪的业务逻辑。
+	SellPigs(batchID uint, penID uint, quantity int, unitPrice float64, tatalPrice float64, traderName string, tradeDate time.Time, remarks string, operatorID uint) error
+	// BuyPigs 处理买猪的业务逻辑。
+	BuyPigs(batchID uint, penID uint, quantity int, unitPrice float64, tatalPrice float64, traderName string, tradeDate time.Time, remarks string, operatorID uint) error
 
-	return createdBatch, nil
+	// ---调栏子服务 ---
+	TransferPigsAcrossBatches(sourceBatchID uint, destBatchID uint, fromPenID uint, toPenID uint, quantity uint, operatorID uint, remarks string) error
+	TransferPigsWithinBatch(batchID uint, fromPenID uint, toPenID uint, quantity uint, operatorID uint, remarks string) error
+
+	// --- 病猪管理相关方法 ---
+	// RecordSickPigs 记录新增病猪事件。
+	RecordSickPigs(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error
+	// RecordSickPigRecovery 记录病猪康复事件。
+	RecordSickPigRecovery(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error
+	// RecordSickPigDeath 记录病猪死亡事件。
+	RecordSickPigDeath(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error
+	// RecordSickPigCull 记录病猪淘汰事件。
+	RecordSickPigCull(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error
+
+	// --- 正常猪只管理相关方法 ---
+	// RecordDeath 记录正常猪只死亡事件。
+	RecordDeath(operatorID uint, batchID uint, penID uint, quantity int, happenedAt time.Time, remarks string) error
+	// RecordCull 记录正常猪只淘汰事件。
+	RecordCull(operatorID uint, batchID uint, penID uint, quantity int, happenedAt time.Time, remarks string) error
 }
 
-// GetPigBatch 实现了获取单个猪批次的逻辑。
-func (s *pigBatchService) GetPigBatch(id uint) (*models.PigBatch, error) {
-	batch, err := s.pigBatchRepo.GetPigBatchByID(id)
-	if err != nil {
-		if errors.Is(err, gorm.ErrRecordNotFound) {
-			return nil, ErrPigBatchNotFound
-		}
-		return nil, err
-	}
-	return batch, nil
+// pigBatchService 是 PigBatchService 接口的具体实现。
+// 它作为猪群领域的主服务，封装了所有业务逻辑。
+type pigBatchService struct {
+	pigBatchRepo    repository.PigBatchRepository    // 猪批次仓库
+	pigBatchLogRepo repository.PigBatchLogRepository // 猪批次日志仓库
+	uow             repository.UnitOfWork            // 工作单元，用于管理事务
+	transferSvc     PigPenTransferManager            // 调栏子服务
+	tradeSvc        PigTradeManager                  // 交易子服务
+	sickSvc         SickPigManager                   // 病猪子服务
 }
 
-// UpdatePigBatch 实现了更新猪批次的逻辑。
-func (s *pigBatchService) UpdatePigBatch(batch *models.PigBatch) (*models.PigBatch, error) {
-	// 可以在这里添加更新前的业务校验
-	updatedBatch, rowsAffected, err := s.pigBatchRepo.UpdatePigBatch(batch)
-	if err != nil {
-		return nil, err
+// NewPigBatchService 是 pigBatchService 的构造函数。
+// 它通过依赖注入的方式，创建并返回一个 PigBatchService 接口的实例。
+func NewPigBatchService(
+	pigBatchRepo repository.PigBatchRepository,
+	pigBatchLogRepo repository.PigBatchLogRepository,
+	uow repository.UnitOfWork,
+	transferSvc PigPenTransferManager,
+	tradeSvc PigTradeManager,
+	sickSvc SickPigManager,
+) PigBatchService {
+	return &pigBatchService{
+		pigBatchRepo:    pigBatchRepo,
+		pigBatchLogRepo: pigBatchLogRepo,
+		uow:             uow,
+		transferSvc:     transferSvc,
+		tradeSvc:        tradeSvc,
+		sickSvc:         sickSvc,
 	}
-	if rowsAffected == 0 {
-		return nil, ErrPigBatchNotFound // 如果没有行被更新，可能意味着记录不存在
-	}
-	return updatedBatch, nil
-}
-
-// DeletePigBatch 实现了删除猪批次的逻辑，并包含业务规则校验。
-func (s *pigBatchService) DeletePigBatch(id uint) error {
-	return s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
-		// 1. 获取猪批次信息
-		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, id) // 使用事务内方法
-		if err != nil {
-			if errors.Is(err, gorm.ErrRecordNotFound) {
-				return ErrPigBatchNotFound
-			}
-			return err
-		}
-
-		// 2. 核心业务规则：检查猪批次是否为活跃状态
-		if batch.IsActive() {
-			return ErrPigBatchActive // 如果活跃，则不允许删除
-		}
-
-		// 3. 释放所有关联的猪栏
-		// 获取该批次下所有猪栏
-		pensInBatch, err := s.transferSvc.GetPensByBatchID(tx, id)
-		if err != nil {
-			return fmt.Errorf("获取猪批次 %d 关联猪栏失败: %w", id, err)
-		}
-
-		// 逐一释放猪栏
-		for _, pen := range pensInBatch {
-			if err := s.transferSvc.ReleasePen(tx, pen.ID); err != nil {
-				return fmt.Errorf("释放猪栏 %d 失败: %w", pen.ID, err)
-			}
-		}
-
-		// 4. 执行删除猪批次
-		rowsAffected, err := s.pigBatchRepo.DeletePigBatchTx(tx, id)
-		if err != nil {
-			return err
-		}
-		if rowsAffected == 0 {
-			return ErrPigBatchNotFound
-		}
-
-		return nil
-	})
-}
-
-// ListPigBatches 实现了批量查询猪批次的逻辑。
-func (s *pigBatchService) ListPigBatches(isActive *bool) ([]*models.PigBatch, error) {
-	return s.pigBatchRepo.ListPigBatches(isActive)
-}
-
-// UpdatePigBatchPens 实现了在事务中更新猪批次关联猪栏的复杂逻辑。
-// 它通过调用底层的 PigPenTransferManager 来执行数据库操作，从而保持了职责的清晰。
-func (s *pigBatchService) UpdatePigBatchPens(batchID uint, desiredPenIDs []uint) error {
-	// 使用工作单元来确保操作的原子性
-	return s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
-		// 1. 验证猪批次是否存在且活跃
-		// 注意: 此处依赖一个假设存在的 pigBatchRepo.GetPigBatchByIDTx 方法
-		pigBatch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
-		if err != nil {
-			if errors.Is(err, gorm.ErrRecordNotFound) {
-				return ErrPigBatchNotFound
-			}
-			return fmt.Errorf("获取猪批次信息失败: %w", err)
-		}
-
-		if !pigBatch.IsActive() {
-			return ErrPigBatchNotActive
-		}
-
-		// 2. 获取当前关联的猪栏 (通过子服务)
-		currentPens, err := s.transferSvc.GetPensByBatchID(tx, batchID)
-		if err != nil {
-			return fmt.Errorf("获取当前关联猪栏失败: %w", err)
-		}
-
-		currentPenMap := make(map[uint]models.Pen)
-		currentPenIDsSet := make(map[uint]struct{})
-		for _, pen := range currentPens {
-			currentPenMap[pen.ID] = *pen
-			currentPenIDsSet[pen.ID] = struct{}{}
-		}
-
-		// 3. 构建期望猪栏ID集合
-		desiredPenIDsSet := make(map[uint]struct{})
-		for _, penID := range desiredPenIDs {
-			desiredPenIDsSet[penID] = struct{}{}
-		}
-
-		// 4. 计算需要添加和移除的猪栏
-		var pensToRemove []uint
-		for penID := range currentPenIDsSet {
-			if _, found := desiredPenIDsSet[penID]; !found {
-				pensToRemove = append(pensToRemove, penID)
-			}
-		}
-
-		var pensToAdd []uint
-		for _, penID := range desiredPenIDs {
-			if _, found := currentPenIDsSet[penID]; !found {
-				pensToAdd = append(pensToAdd, penID)
-			}
-		}
-
-		// 5. 处理移除猪栏的逻辑
-		for _, penID := range pensToRemove {
-			currentPen := currentPenMap[penID]
-			updates := make(map[string]interface{})
-			updates["pig_batch_id"] = nil
-
-			if currentPen.Status == models.PenStatusOccupied {
-				updates["status"] = models.PenStatusEmpty
-			}
-
-			if err := s.transferSvc.UpdatePenFields(tx, penID, updates); err != nil {
-				return fmt.Errorf("移除猪栏 %d 失败: %w", penID, err)
-			}
-		}
-
-		// 6. 处理添加猪栏的逻辑
-		for _, penID := range pensToAdd {
-			// 通过子服务获取猪栏信息
-			actualPen, err := s.transferSvc.GetPenByID(tx, penID)
-			if err != nil {
-				if errors.Is(err, gorm.ErrRecordNotFound) {
-					return fmt.Errorf("猪栏 %d 不存在: %w", penID, ErrPenNotFound)
-				}
-				return fmt.Errorf("获取猪栏 %d 信息失败: %w", penID, err)
-			}
-
-			// 核心业务规则：校验猪栏是否可被分配
-			if actualPen.Status != models.PenStatusEmpty {
-				return fmt.Errorf("猪栏 %s 状态为 %s，无法分配: %w", actualPen.PenNumber, actualPen.Status, ErrPenStatusInvalidForAllocation)
-			}
-			if actualPen.PigBatchID != nil {
-				return fmt.Errorf("猪栏 %s 已被其他批次 %d 使用: %w", actualPen.PenNumber, *actualPen.PigBatchID, ErrPenOccupiedByOtherBatch)
-			}
-
-			updates := map[string]interface{}{
-				"pig_batch_id": &batchID,
-				"status":       models.PenStatusOccupied,
-			}
-			if err := s.transferSvc.UpdatePenFields(tx, penID, updates); err != nil {
-				return fmt.Errorf("添加猪栏 %d 失败: %w", penID, err)
-			}
-		}
-
-		return nil
-	})
-}
-
-// GetCurrentPigQuantity 实现了获取指定猪批次的当前猪只数量的逻辑。
-func (s *pigBatchService) GetCurrentPigQuantity(batchID uint) (int, error) {
-	var getErr error
-	var quantity int
-	err := s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
-		quantity, getErr = s.getCurrentPigQuantityTx(tx, batchID)
-		return getErr
-	})
-	if err != nil {
-		return 0, err
-	}
-	return quantity, nil
-}
-
-// getCurrentPigQuantityTx 实现了获取指定猪批次的当前猪只数量的逻辑。
-func (s *pigBatchService) getCurrentPigQuantityTx(tx *gorm.DB, batchID uint) (int, error) {
-	// 1. 获取猪批次初始信息
-	batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
-	if err != nil {
-		if errors.Is(err, gorm.ErrRecordNotFound) {
-			return 0, ErrPigBatchNotFound
-		}
-		return 0, fmt.Errorf("获取猪批次 %d 初始信息失败: %w", batchID, err)
-	}
-
-	// 2. 尝试获取该批次的最后一条日志记录
-	lastLog, err := s.pigBatchLogRepo.GetLastLogByBatchIDTx(tx, batchID)
-	if err != nil {
-		if errors.Is(err, gorm.ErrRecordNotFound) {
-			// 如果没有找到任何日志记录（除了初始创建），则当前数量就是初始数量
-			return batch.InitialCount, nil
-		}
-		return 0, fmt.Errorf("获取猪批次 %d 最后一条日志失败: %w", batchID, err)
-	}
-
-	// 3. 如果找到最后一条日志，则当前数量为该日志的 AfterCount
-	return lastLog.AfterCount, nil
-}
-
-func (s *pigBatchService) UpdatePigBatchQuantity(operatorID uint, batchID uint, changeType models.LogChangeType, changeAmount int, changeReason string, happenedAt time.Time) error {
-	return s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
-		return s.updatePigBatchQuantityTx(tx, operatorID, batchID, changeType, changeAmount, changeReason, happenedAt)
-	})
-}
-
-func (s *pigBatchService) updatePigBatchQuantityTx(tx *gorm.DB, operatorID uint, batchID uint, changeType models.LogChangeType, changeAmount int, changeReason string, happenedAt time.Time) error {
-	lastLog, err := s.pigBatchLogRepo.GetLastLogByBatchIDTx(tx, batchID)
-	if err != nil {
-		return err
-	}
-	// 检查数量不应该减到小于零
-	if changeAmount < 0 {
-		if lastLog.AfterCount+changeAmount < 0 {
-			return ErrInvalidOperation
-		}
-	}
-	pigBatchLog := &models.PigBatchLog{
-		PigBatchID:  batchID,
-		ChangeType:  changeType,
-		ChangeCount: changeAmount,
-		Reason:      changeReason,
-		BeforeCount: lastLog.AfterCount,
-		AfterCount:  lastLog.AfterCount + changeAmount,
-		OperatorID:  operatorID,
-		HappenedAt:  happenedAt,
-	}
-	return s.pigBatchLogRepo.CreateTx(tx, pigBatchLog)
 }

internal/domain/pig/pig_batch_service_method.go

@@ -0,0 +1,196 @@
+package pig
+
+import (
+	"errors"
+	"fmt"
+	"time"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"gorm.io/gorm"
+)
+
+// --- 领域服务实现 ---
+
+// CreatePigBatch 实现了创建猪批次的逻辑，并同时创建初始批次日志。
+func (s *pigBatchService) CreatePigBatch(operatorID uint, batch *models.PigBatch) (*models.PigBatch, error) {
+	// 业务规则可以在这里添加，例如检查批次号是否唯一等
+
+	var createdBatch *models.PigBatch
+	err := s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1. 创建猪批次
+		// 注意: 此处依赖一个假设存在的 pigBatchRepo.CreatePigBatchTx 方法
+		var err error
+		createdBatch, err = s.pigBatchRepo.CreatePigBatchTx(tx, batch)
+		if err != nil {
+			return fmt.Errorf("创建猪批次失败: %w", err)
+		}
+
+		// 2. 创建初始批次日志
+		initialLog := &models.PigBatchLog{
+			PigBatchID:  createdBatch.ID,
+			HappenedAt:  time.Now(),
+			ChangeType:  models.ChangeTypeCorrection, // 初始创建可视为一种校正
+			ChangeCount: createdBatch.InitialCount,
+			Reason:      fmt.Sprintf("创建了新的猪批次 %s，初始数量 %d", createdBatch.BatchNumber, createdBatch.InitialCount),
+			BeforeCount: 0, // 初始创建前数量为0
+			AfterCount:  createdBatch.InitialCount,
+			OperatorID:  operatorID,
+		}
+
+		// 3. 记录批次日志
+		if err := s.pigBatchLogRepo.CreateTx(tx, initialLog); err != nil {
+			return fmt.Errorf("记录初始批次日志失败: %w", err)
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return nil, err
+	}
+
+	return createdBatch, nil
+}
+
+// GetPigBatch 实现了获取单个猪批次的逻辑。
+func (s *pigBatchService) GetPigBatch(id uint) (*models.PigBatch, error) {
+	batch, err := s.pigBatchRepo.GetPigBatchByID(id)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			return nil, ErrPigBatchNotFound
+		}
+		return nil, err
+	}
+	return batch, nil
+}
+
+// UpdatePigBatch 实现了更新猪批次的逻辑。
+func (s *pigBatchService) UpdatePigBatch(batch *models.PigBatch) (*models.PigBatch, error) {
+	// 可以在这里添加更新前的业务校验
+	updatedBatch, rowsAffected, err := s.pigBatchRepo.UpdatePigBatch(batch)
+	if err != nil {
+		return nil, err
+	}
+	if rowsAffected == 0 {
+		return nil, ErrPigBatchNotFound // 如果没有行被更新，可能意味着记录不存在
+	}
+	return updatedBatch, nil
+}
+
+// DeletePigBatch 实现了删除猪批次的逻辑，并包含业务规则校验。
+func (s *pigBatchService) DeletePigBatch(id uint) error {
+	return s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1. 获取猪批次信息
+		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, id) // 使用事务内方法
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPigBatchNotFound
+			}
+			return err
+		}
+
+		// 2. 核心业务规则：检查猪批次是否为活跃状态
+		if batch.IsActive() {
+			return ErrPigBatchActive // 如果活跃，则不允许删除
+		}
+
+		// 3. 释放所有关联的猪栏
+		// 获取该批次下所有猪栏
+		pensInBatch, err := s.transferSvc.GetPensByBatchID(tx, id)
+		if err != nil {
+			return fmt.Errorf("获取猪批次 %d 关联猪栏失败: %w", id, err)
+		}
+
+		// 逐一释放猪栏
+		for _, pen := range pensInBatch {
+			if err := s.transferSvc.ReleasePen(tx, pen.ID); err != nil {
+				return fmt.Errorf("释放猪栏 %d 失败: %w", pen.ID, err)
+			}
+		}
+
+		// 4. 执行删除猪批次
+		rowsAffected, err := s.pigBatchRepo.DeletePigBatchTx(tx, id)
+		if err != nil {
+			return err
+		}
+		if rowsAffected == 0 {
+			return ErrPigBatchNotFound
+		}
+
+		return nil
+	})
+}
+
+// ListPigBatches 实现了批量查询猪批次的逻辑。
+func (s *pigBatchService) ListPigBatches(isActive *bool) ([]*models.PigBatch, error) {
+	return s.pigBatchRepo.ListPigBatches(isActive)
+}
+
+// GetCurrentPigQuantity 实现了获取指定猪批次的当前猪只数量的逻辑。
+func (s *pigBatchService) GetCurrentPigQuantity(batchID uint) (int, error) {
+	var getErr error
+	var quantity int
+	err := s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		quantity, getErr = s.getCurrentPigQuantityTx(tx, batchID)
+		return getErr
+	})
+	if err != nil {
+		return 0, err
+	}
+	return quantity, nil
+}
+
+// getCurrentPigQuantityTx 实现了获取指定猪批次的当前猪只数量的逻辑。
+func (s *pigBatchService) getCurrentPigQuantityTx(tx *gorm.DB, batchID uint) (int, error) {
+	// 1. 获取猪批次初始信息
+	batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			return 0, ErrPigBatchNotFound
+		}
+		return 0, fmt.Errorf("获取猪批次 %d 初始信息失败: %w", batchID, err)
+	}
+
+	// 2. 尝试获取该批次的最后一条日志记录
+	lastLog, err := s.pigBatchLogRepo.GetLastLogByBatchIDTx(tx, batchID)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			// 如果没有找到任何日志记录（除了初始创建），则当前数量就是初始数量
+			return batch.InitialCount, nil
+		}
+		return 0, fmt.Errorf("获取猪批次 %d 最后一条日志失败: %w", batchID, err)
+	}
+
+	// 3. 如果找到最后一条日志，则当前数量为该日志的 AfterCount
+	return lastLog.AfterCount, nil
+}
+
+func (s *pigBatchService) UpdatePigBatchQuantity(operatorID uint, batchID uint, changeType models.LogChangeType, changeAmount int, changeReason string, happenedAt time.Time) error {
+	return s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		return s.updatePigBatchQuantityTx(tx, operatorID, batchID, changeType, changeAmount, changeReason, happenedAt)
+	})
+}
+
+func (s *pigBatchService) updatePigBatchQuantityTx(tx *gorm.DB, operatorID uint, batchID uint, changeType models.LogChangeType, changeAmount int, changeReason string, happenedAt time.Time) error {
+	lastLog, err := s.pigBatchLogRepo.GetLastLogByBatchIDTx(tx, batchID)
+	if err != nil {
+		return err
+	}
+	// 检查数量不应该减到小于零
+	if changeAmount < 0 {
+		if lastLog.AfterCount+changeAmount < 0 {
+			return ErrInvalidOperation
+		}
+	}
+	pigBatchLog := &models.PigBatchLog{
+		PigBatchID:  batchID,
+		ChangeType:  changeType,
+		ChangeCount: changeAmount,
+		Reason:      changeReason,
+		BeforeCount: lastLog.AfterCount,
+		AfterCount:  lastLog.AfterCount + changeAmount,
+		OperatorID:  operatorID,
+		HappenedAt:  happenedAt,
+	}
+	return s.pigBatchLogRepo.CreateTx(tx, pigBatchLog)
+}

internal/domain/pig/pig_batch_service_pen_transfer.go

@@ -381,3 +381,75 @@ func (s *pigBatchService) ReclassifyPenToNewBatch(fromBatchID uint, toBatchID ui
 		return nil
 	})
 }
+
+func (s *pigBatchService) RemoveEmptyPenFromBatch(batchID uint, penID uint) error {
+	return s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1. 检查猪批次是否存在且活跃
+		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPigBatchNotFound
+			}
+			return err
+		}
+		if !batch.IsActive() {
+			return ErrPigBatchNotActive
+		}
+
+		// 2. 检查猪栏是否存在
+		pen, err := s.transferSvc.GetPenByID(tx, penID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPenNotFound
+			}
+			return err
+		}
+
+		// 3. 检查猪栏是否与当前批次关联
+		if pen.PigBatchID == nil || *pen.PigBatchID != batchID {
+			return ErrPenNotAssociatedWithBatch
+		}
+
+		// 4. 检查猪栏是否为空
+		pigsInPen, err := s.transferSvc.GetCurrentPigsInPen(tx, penID)
+		if err != nil {
+			return err
+		}
+		if pigsInPen > 0 {
+			return ErrPenNotEmpty
+		}
+
+		// 5. 释放猪栏 (将 pig_batch_id 设置为 nil，状态设置为空闲)
+		if err := s.transferSvc.ReleasePen(tx, penID); err != nil {
+			return err
+		}
+		return nil
+	})
+}
+
+func (s *pigBatchService) GetCurrentPigsInPen(penID uint) (int, error) {
+	var currentPigs int
+	err := s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		pigs, err := s.transferSvc.GetCurrentPigsInPen(tx, penID)
+		if err != nil {
+			return err
+		}
+		currentPigs = pigs
+		return nil
+	})
+	return currentPigs, err
+}
+
+// GetTotalPigsInPensForBatch 实现了获取指定猪群下所有猪栏的当前总存栏数的逻辑。
+func (s *pigBatchService) GetTotalPigsInPensForBatch(batchID uint) (int, error) {
+	var totalPigs int
+	err := s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		pigs, err := s.transferSvc.GetTotalPigsInPensForBatchTx(tx, batchID)
+		if err != nil {
+			return err
+		}
+		totalPigs = pigs
+		return nil
+	})
+	return totalPigs, err
+}

internal/domain/pig/pig_batch_service_pig_sick.go

@@ -0,0 +1,483 @@
+package pig
+
+import (
+	"errors"
+	"fmt"
+	"time"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"gorm.io/gorm"
+)
+
+// RecordSickPigs 记录新增病猪事件。
+func (s *pigBatchService) RecordSickPigs(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error {
+	if quantity <= 0 {
+		return errors.New("新增病猪数量必须大于0")
+	}
+
+	var err error
+	// 1. 开启事务
+	err = s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1.1 检查批次是否活跃
+		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPigBatchNotFound
+			}
+			return fmt.Errorf("获取批次 %d 失败: %w", batchID, err)
+		}
+		if !batch.IsActive() {
+			return fmt.Errorf("批次 %d 不活跃，无法记录病猪事件", batchID)
+		}
+
+		// 1.2 检查猪栏是否关联
+		pen, err := s.transferSvc.GetPenByID(tx, penID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPenNotFound
+			}
+			return fmt.Errorf("获取猪栏 %d 失败: %w", penID, err)
+		}
+		if pen.PigBatchID == nil || *pen.PigBatchID != batchID {
+			return fmt.Errorf("猪栏 %d 未与批次 %d 关联", penID, batchID)
+		}
+
+		// 1.3 检查剩余健康猪不能少于即将转化的病猪数量
+		totalPigsInBatch, err := s.getCurrentPigQuantityTx(tx, batchID)
+		if err != nil {
+			return fmt.Errorf("获取批次 %d 总猪只数量失败: %w", batchID, err)
+		}
+
+		currentSickPigs, err := s.sickSvc.GetCurrentSickPigCount(tx, batchID)
+		if err != nil {
+			return fmt.Errorf("获取批次 %d 当前病猪数量失败: %w", batchID, err)
+		}
+
+		healthyPigs := totalPigsInBatch - currentSickPigs
+		if healthyPigs < quantity {
+			return fmt.Errorf("健康猪数量不足，当前健康猪 %d 头，尝试记录病猪 %d 头", healthyPigs, quantity)
+		}
+
+		// 1.4 创建病猪日志
+		sickLog := &models.PigSickLog{
+			PigBatchID:        batchID,
+			PenID:             penID,
+			ChangeCount:       quantity, // 新增病猪，ChangeCount 为正数
+			Reason:            models.SickPigReasonTypeIllness,
+			TreatmentLocation: treatmentLocation,
+			Remarks:           remarks,
+			OperatorID:        operatorID,
+			HappenedAt:        happenedAt,
+		}
+
+		if err := s.sickSvc.ProcessSickPigLog(tx, sickLog); err != nil {
+			return fmt.Errorf("处理病猪日志失败: %w", err)
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return fmt.Errorf("记录新增病猪事件失败: %w", err)
+	}
+
+	return nil
+}
+
+// RecordSickPigRecovery 记录病猪康复事件。
+func (s *pigBatchService) RecordSickPigRecovery(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error {
+	if quantity <= 0 {
+		return errors.New("康复猪只数量必须大于0")
+	}
+
+	var err error
+	err = s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1. 检查批次是否活跃
+		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPigBatchNotFound
+			}
+			return fmt.Errorf("获取批次 %d 失败: %w", batchID, err)
+		}
+		if !batch.IsActive() {
+			return fmt.Errorf("批次 %d 不活跃，无法记录病猪康复事件", batchID)
+		}
+
+		// 2. 检查猪栏是否关联
+		pen, err := s.transferSvc.GetPenByID(tx, penID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPenNotFound
+			}
+			return fmt.Errorf("获取猪栏 %d 失败: %w", penID, err)
+		}
+		if pen.PigBatchID == nil || *pen.PigBatchID != batchID {
+			return fmt.Errorf("猪栏 %d 未与批次 %d 关联", penID, batchID)
+		}
+
+		// 3. 检查当前病猪数量是否足够康复
+		currentSickPigs, err := s.sickSvc.GetCurrentSickPigCount(tx, batchID)
+		if err != nil {
+			return fmt.Errorf("获取批次 %d 当前病猪数量失败: %w", batchID, err)
+		}
+
+		if currentSickPigs < quantity {
+			return fmt.Errorf("当前病猪数量不足，当前病猪 %d 头，尝试康复 %d 头", currentSickPigs, quantity)
+		}
+
+		// 4. 创建病猪日志
+		sickLog := &models.PigSickLog{
+			PigBatchID:        batchID,
+			PenID:             penID,
+			ChangeCount:       -quantity, // 康复病猪，ChangeCount 为负数
+			Reason:            models.SickPigReasonTypeRecovery,
+			TreatmentLocation: treatmentLocation,
+			Remarks:           remarks,
+			OperatorID:        operatorID,
+			HappenedAt:        happenedAt,
+		}
+
+		if err := s.sickSvc.ProcessSickPigLog(tx, sickLog); err != nil {
+			return fmt.Errorf("处理病猪康复日志失败: %w", err)
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return fmt.Errorf("记录病猪康复事件失败: %w", err)
+	}
+
+	return nil
+}
+
+// RecordSickPigDeath 记录病猪死亡事件。
+func (s *pigBatchService) RecordSickPigDeath(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error {
+	if quantity <= 0 {
+		return errors.New("死亡猪只数量必须大于0")
+	}
+
+	var err error
+	err = s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1. 检查批次是否活跃
+		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPigBatchNotFound
+			}
+			return fmt.Errorf("获取批次 %d 失败: %w", batchID, err)
+		}
+		if !batch.IsActive() {
+			return fmt.Errorf("批次 %d 不活跃，无法记录病猪死亡事件", batchID)
+		}
+
+		// 2. 检查猪栏是否关联
+		pen, err := s.transferSvc.GetPenByID(tx, penID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPenNotFound
+			}
+			return fmt.Errorf("获取猪栏 %d 失败: %w", penID, err)
+		}
+		if pen.PigBatchID == nil || *pen.PigBatchID != batchID {
+			return fmt.Errorf("猪栏 %d 未与批次 %d 关联", penID, batchID)
+		}
+
+		// 3. 检查当前病猪数量是否足够死亡
+		currentSickPigs, err := s.sickSvc.GetCurrentSickPigCount(tx, batchID)
+		if err != nil {
+			return fmt.Errorf("获取批次 %d 当前病猪数量失败: %w", batchID, err)
+		}
+
+		if currentSickPigs < quantity {
+			return fmt.Errorf("当前病猪数量不足，当前病猪 %d 头，尝试记录死亡 %d 头", currentSickPigs, quantity)
+		}
+
+		// 4. 检查猪栏内猪只数量是否足够死亡
+		currentPigsInPen, err := s.transferSvc.GetCurrentPigsInPen(tx, penID)
+		if err != nil {
+			return fmt.Errorf("获取猪栏 %d 当前猪只数量失败: %w", penID, err)
+		}
+		if currentPigsInPen < quantity {
+			return fmt.Errorf("猪栏 %d 内猪只数量不足，当前 %d 头，尝试记录死亡 %d 头", penID, currentPigsInPen, quantity)
+		}
+
+		// 5. 创建病猪日志 (减少病猪数量)
+		sickLog := &models.PigSickLog{
+			PigBatchID:        batchID,
+			PenID:             penID,
+			ChangeCount:       -quantity, // 死亡病猪，ChangeCount 为负数
+			Reason:            models.SickPigReasonTypeDeath,
+			TreatmentLocation: treatmentLocation,
+			Remarks:           remarks,
+			OperatorID:        operatorID,
+			HappenedAt:        happenedAt,
+		}
+		if err := s.sickSvc.ProcessSickPigLog(tx, sickLog); err != nil {
+			return fmt.Errorf("处理病猪死亡日志失败: %w", err)
+		}
+
+		// 6. 更新批次总猪只数量 (减少批次总数)
+		if err := s.UpdatePigBatchQuantity(operatorID, batchID, models.ChangeTypeDeath, -quantity, remarks, happenedAt); err != nil {
+			return fmt.Errorf("更新批次 %d 总猪只数量失败: %w", batchID, err)
+		}
+
+		// 7. 记录猪只转移日志 (减少猪栏内猪只数量)
+		transferLog := &models.PigTransferLog{
+			TransferTime: happenedAt,
+			PigBatchID:   batchID,
+			PenID:        penID,
+			Quantity:     -quantity, // 减少猪只数量
+			Type:         models.PigTransferTypeDeath,
+			OperatorID:   operatorID,
+			Remarks:      remarks,
+		}
+		if err := s.transferSvc.LogTransfer(tx, transferLog); err != nil {
+			return fmt.Errorf("记录猪只死亡转移日志失败: %w", err)
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return fmt.Errorf("记录病猪死亡事件失败: %w", err)
+	}
+
+	return nil
+}
+
+// RecordSickPigCull 记录病猪淘汰事件。
+func (s *pigBatchService) RecordSickPigCull(operatorID uint, batchID uint, penID uint, quantity int, treatmentLocation models.PigBatchSickPigTreatmentLocation, happenedAt time.Time, remarks string) error {
+	if quantity <= 0 {
+		return errors.New("淘汰猪只数量必须大于0")
+	}
+
+	var err error
+	err = s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1. 检查批次是否活跃
+		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPigBatchNotFound
+			}
+			return fmt.Errorf("获取批次 %d 失败: %w", batchID, err)
+		}
+		if !batch.IsActive() {
+			return fmt.Errorf("批次 %d 不活跃，无法记录病猪淘汰事件", batchID)
+		}
+
+		// 2. 检查猪栏是否关联
+		pen, err := s.transferSvc.GetPenByID(tx, penID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPenNotFound
+			}
+			return fmt.Errorf("获取猪栏 %d 失败: %w", penID, err)
+		}
+		if pen.PigBatchID == nil || *pen.PigBatchID != batchID {
+			return fmt.Errorf("猪栏 %d 未与批次 %d 关联", penID, batchID)
+		}
+
+		// 3. 检查当前病猪数量是否足够淘汰
+		currentSickPigs, err := s.sickSvc.GetCurrentSickPigCount(tx, batchID)
+		if err != nil {
+			return fmt.Errorf("获取批次 %d 当前病猪数量失败: %w", batchID, err)
+		}
+
+		if currentSickPigs < quantity {
+			return fmt.Errorf("当前病猪数量不足，当前病猪 %d 头，尝试淘汰 %d 头", currentSickPigs, quantity)
+		}
+
+		// 4. 检查猪栏内猪只数量是否足够淘汰
+		currentPigsInPen, err := s.transferSvc.GetCurrentPigsInPen(tx, penID)
+		if err != nil {
+			return fmt.Errorf("获取猪栏 %d 当前猪只数量失败: %w", penID, err)
+		}
+		if currentPigsInPen < quantity {
+			return fmt.Errorf("猪栏 %d 内猪只数量不足，当前 %d 头，尝试记录淘汰 %d 头", penID, currentPigsInPen, quantity)
+		}
+
+		// 5. 创建病猪日志 (减少病猪数量)
+		sickLog := &models.PigSickLog{
+			PigBatchID:        batchID,
+			PenID:             penID,
+			ChangeCount:       -quantity, // 淘汰病猪，ChangeCount 为负数
+			Reason:            models.SickPigReasonTypeEliminate,
+			TreatmentLocation: treatmentLocation,
+			Remarks:           remarks,
+			OperatorID:        operatorID,
+			HappenedAt:        happenedAt,
+		}
+		if err := s.sickSvc.ProcessSickPigLog(tx, sickLog); err != nil {
+			return fmt.Errorf("处理病猪淘汰日志失败: %w", err)
+		}
+
+		// 6. 更新批次总猪只数量 (减少批次总数)
+		if err := s.UpdatePigBatchQuantity(operatorID, batchID, models.ChangeTypeCull, -quantity, remarks, happenedAt); err != nil {
+			return fmt.Errorf("更新批次 %d 总猪只数量失败: %w", batchID, err)
+		}
+
+		// 7. 记录猪只转移日志 (减少猪栏内猪只数量)
+		transferLog := &models.PigTransferLog{
+			TransferTime: happenedAt,
+			PigBatchID:   batchID,
+			PenID:        penID,
+			Quantity:     -quantity,                  // 减少猪只数量
+			Type:         models.PigTransferTypeCull, // 淘汰类型
+			OperatorID:   operatorID,
+			Remarks:      remarks,
+		}
+		if err := s.transferSvc.LogTransfer(tx, transferLog); err != nil {
+			return fmt.Errorf("记录猪只淘汰转移日志失败: %w", err)
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return fmt.Errorf("记录病猪淘汰事件失败: %w", err)
+	}
+
+	return nil
+}
+
+// RecordDeath 记录正常猪只死亡事件。
+func (s *pigBatchService) RecordDeath(operatorID uint, batchID uint, penID uint, quantity int, happenedAt time.Time, remarks string) error {
+	if quantity <= 0 {
+		return errors.New("死亡猪只数量必须大于0")
+	}
+
+	var err error
+	err = s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1. 检查批次是否活跃
+		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPigBatchNotFound
+			}
+			return fmt.Errorf("获取批次 %d 失败: %w", batchID, err)
+		}
+		if !batch.IsActive() {
+			return fmt.Errorf("批次 %d 不活跃，无法记录死亡事件", batchID)
+		}
+
+		// 2. 检查猪栏是否关联
+		pen, err := s.transferSvc.GetPenByID(tx, penID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPenNotFound
+			}
+			return fmt.Errorf("获取猪栏 %d 失败: %w", penID, err)
+		}
+		if pen.PigBatchID == nil || *pen.PigBatchID != batchID {
+			return fmt.Errorf("猪栏 %d 未与批次 %d 关联", penID, batchID)
+		}
+
+		// 3. 检查猪栏内猪只数量是否足够死亡
+		currentPigsInPen, err := s.transferSvc.GetCurrentPigsInPen(tx, penID)
+		if err != nil {
+			return fmt.Errorf("获取猪栏 %d 当前猪只数量失败: %w", penID, err)
+		}
+		if currentPigsInPen < quantity {
+			return fmt.Errorf("猪栏 %d 内猪只数量不足，当前 %d 头，尝试记录死亡 %d 头", penID, currentPigsInPen, quantity)
+		}
+
+		// 4. 更新批次总猪只数量 (减少批次总数)
+		if err := s.UpdatePigBatchQuantity(operatorID, batchID, models.ChangeTypeDeath, -quantity, remarks, happenedAt); err != nil {
+			return fmt.Errorf("更新批次 %d 总猪只数量失败: %w", batchID, err)
+		}
+
+		// 5. 记录猪只转移日志 (减少猪栏内猪只数量)
+		transferLog := &models.PigTransferLog{
+			TransferTime: happenedAt,
+			PigBatchID:   batchID,
+			PenID:        penID,
+			Quantity:     -quantity, // 减少猪只数量
+			Type:         models.PigTransferTypeDeath,
+			OperatorID:   operatorID,
+			Remarks:      remarks,
+		}
+		if err := s.transferSvc.LogTransfer(tx, transferLog); err != nil {
+			return fmt.Errorf("记录猪只死亡转移日志失败: %w", err)
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return fmt.Errorf("记录正常猪只死亡事件失败: %w", err)
+	}
+
+	return nil
+}
+
+// RecordCull 记录正常猪只淘汰事件。
+func (s *pigBatchService) RecordCull(operatorID uint, batchID uint, penID uint, quantity int, happenedAt time.Time, remarks string) error {
+	if quantity <= 0 {
+		return errors.New("淘汰猪只数量必须大于0")
+	}
+
+	var err error
+	err = s.uow.ExecuteInTransaction(func(tx *gorm.DB) error {
+		// 1. 检查批次是否活跃
+		batch, err := s.pigBatchRepo.GetPigBatchByIDTx(tx, batchID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPigBatchNotFound
+			}
+			return fmt.Errorf("获取批次 %d 失败: %w", batchID, err)
+		}
+		if !batch.IsActive() {
+			return fmt.Errorf("批次 %d 不活跃，无法记录淘汰事件", batchID)
+		}
+
+		// 2. 检查猪栏是否关联
+		pen, err := s.transferSvc.GetPenByID(tx, penID)
+		if err != nil {
+			if errors.Is(err, gorm.ErrRecordNotFound) {
+				return ErrPenNotFound
+			}
+			return fmt.Errorf("获取猪栏 %d 失败: %w", penID, err)
+		}
+		if pen.PigBatchID == nil || *pen.PigBatchID != batchID {
+			return fmt.Errorf("猪栏 %d 未与批次 %d 关联", penID, batchID)
+		}
+
+		// 3. 检查猪栏内猪只数量是否足够淘汰
+		currentPigsInPen, err := s.transferSvc.GetCurrentPigsInPen(tx, penID)
+		if err != nil {
+			return fmt.Errorf("获取猪栏 %d 当前猪只数量失败: %w", penID, err)
+		}
+		if currentPigsInPen < quantity {
+			return fmt.Errorf("猪栏 %d 内猪只数量不足，当前 %d 头，尝试记录淘汰 %d 头", penID, currentPigsInPen, quantity)
+		}
+
+		// 4. 更新批次总猪只数量 (减少批次总数)
+		if err := s.UpdatePigBatchQuantity(operatorID, batchID, models.ChangeTypeCull, -quantity, remarks, happenedAt); err != nil {
+			return fmt.Errorf("更新批次 %d 总猪只数量失败: %w", batchID, err)
+		}
+
+		// 5. 记录猪只转移日志 (减少猪栏内猪只数量)
+		transferLog := &models.PigTransferLog{
+			TransferTime: happenedAt,
+			PigBatchID:   batchID,
+			PenID:        penID,
+			Quantity:     -quantity, // 减少猪只数量
+			Type:         models.PigTransferTypeCull,
+			OperatorID:   operatorID,
+			Remarks:      remarks,
+		}
+		if err := s.transferSvc.LogTransfer(tx, transferLog); err != nil {
+			return fmt.Errorf("记录猪只淘汰转移日志失败: %w", err)
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return fmt.Errorf("记录正常猪只淘汰事件失败: %w", err)
+	}
+
+	return nil
+}

internal/domain/plan/analysis_plan_task_manager.go

@@ -1,4 +1,4 @@
-package task
+package plan
 
 import (
 	"fmt"
@@ -11,10 +11,22 @@ import (
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/utils"
 )
 
-// AnalysisPlanTaskManager 负责管理分析计划的触发器任务。
+// AnalysisPlanTaskManager 定义了分析计划任务管理器的接口。
+type AnalysisPlanTaskManager interface {
+	// Refresh 同步数据库中的计划状态和待执行队列中的触发器任务。
+	Refresh() error
+	// CreateOrUpdateTrigger 为给定的 planID 创建其关联的触发任务。
+	// 如果触发器已存在，会根据计划类型更新其执行时间。
+	CreateOrUpdateTrigger(planID uint) error
+	// EnsureAnalysisTaskDefinition 确保计划的分析任务定义存在于 tasks 表中。
+	// 如果不存在，则会自动创建。此方法不涉及待执行队列。
+	EnsureAnalysisTaskDefinition(planID uint) error
+}
+
+// analysisPlanTaskManagerImpl 负责管理分析计划的触发器任务。
 // 它确保数据库中可执行的计划在待执行队列中有对应的触发器，并移除无效的触发器。
 // 这是一个有状态的组件，包含一个互斥锁以确保并发安全。
-type AnalysisPlanTaskManager struct {
+type analysisPlanTaskManagerImpl struct {
 	planRepo         repository.PlanRepository
 	pendingTaskRepo  repository.PendingTaskRepository
 	executionLogRepo repository.ExecutionLogRepository
@@ -22,14 +34,14 @@ type AnalysisPlanTaskManager struct {
 	mu               sync.Mutex
 }
 
-// NewAnalysisPlanTaskManager 是 AnalysisPlanTaskManager 的构造函数。
+// NewAnalysisPlanTaskManager 是 analysisPlanTaskManagerImpl 的构造函数。
 func NewAnalysisPlanTaskManager(
 	planRepo repository.PlanRepository,
 	pendingTaskRepo repository.PendingTaskRepository,
 	executionLogRepo repository.ExecutionLogRepository,
 	logger *logs.Logger,
-) *AnalysisPlanTaskManager {
-	return &AnalysisPlanTaskManager{
+) AnalysisPlanTaskManager {
+	return &analysisPlanTaskManagerImpl{
 		planRepo:         planRepo,
 		pendingTaskRepo:  pendingTaskRepo,
 		executionLogRepo: executionLogRepo,
@@ -39,7 +51,7 @@ func NewAnalysisPlanTaskManager(
 
 // Refresh 同步数据库中的计划状态和待执行队列中的触发器任务。
 // 这是一个编排方法，将复杂的逻辑分解到多个内部方法中。
-func (m *AnalysisPlanTaskManager) Refresh() error {
+func (m *analysisPlanTaskManagerImpl) Refresh() error {
 	m.mu.Lock()
 	defer m.mu.Unlock()
 
@@ -68,7 +80,7 @@ func (m *AnalysisPlanTaskManager) Refresh() error {
 
 // CreateOrUpdateTrigger 为给定的 planID 创建其关联的触发任务。
 // 如果触发器已存在，会根据计划类型更新其执行时间。
-func (m *AnalysisPlanTaskManager) CreateOrUpdateTrigger(planID uint) error {
+func (m *analysisPlanTaskManagerImpl) CreateOrUpdateTrigger(planID uint) error {
 	m.mu.Lock()
 	defer m.mu.Unlock()
 
@@ -123,7 +135,7 @@ func (m *AnalysisPlanTaskManager) CreateOrUpdateTrigger(planID uint) error {
 
 // EnsureAnalysisTaskDefinition 确保计划的分析任务定义存在于 tasks 表中。
 // 如果不存在，则会自动创建。此方法不涉及待执行队列。
-func (m *AnalysisPlanTaskManager) EnsureAnalysisTaskDefinition(planID uint) error {
+func (m *analysisPlanTaskManagerImpl) EnsureAnalysisTaskDefinition(planID uint) error {
 	m.mu.Lock()
 	defer m.mu.Unlock()
 
@@ -154,7 +166,7 @@ func (m *AnalysisPlanTaskManager) EnsureAnalysisTaskDefinition(planID uint) erro
 // --- 内部私有方法 ---
 
 // getRefreshData 从数据库获取刷新所需的所有数据。
-func (m *AnalysisPlanTaskManager) getRefreshData() (runnablePlans []*models.Plan, invalidPlanIDs []uint, pendingTasks []models.PendingTask, err error) {
+func (m *analysisPlanTaskManagerImpl) getRefreshData() (runnablePlans []*models.Plan, invalidPlanIDs []uint, pendingTasks []models.PendingTask, err error) {
 	runnablePlans, err = m.planRepo.FindRunnablePlans()
 	if err != nil {
 		m.logger.Errorf("获取可执行计划列表失败: %v", err)
@@ -180,7 +192,7 @@ func (m *AnalysisPlanTaskManager) getRefreshData() (runnablePlans []*models.Plan
 }
 
 // cleanupInvalidTasks 清理所有与失效计划相关的待执行任务。
-func (m *AnalysisPlanTaskManager) cleanupInvalidTasks(invalidPlanIDs []uint, allPendingTasks []models.PendingTask) error {
+func (m *analysisPlanTaskManagerImpl) cleanupInvalidTasks(invalidPlanIDs []uint, allPendingTasks []models.PendingTask) error {
 	if len(invalidPlanIDs) == 0 {
 		return nil // 没有需要清理的计划
 	}
@@ -224,7 +236,7 @@ func (m *AnalysisPlanTaskManager) cleanupInvalidTasks(invalidPlanIDs []uint, all
 }
 
 // addOrUpdateTriggers 检查、更新或创建触发器。
-func (m *AnalysisPlanTaskManager) addOrUpdateTriggers(runnablePlans []*models.Plan, allPendingTasks []models.PendingTask) error {
+func (m *analysisPlanTaskManagerImpl) addOrUpdateTriggers(runnablePlans []*models.Plan, allPendingTasks []models.PendingTask) error {
 	// 创建一个映射，存放所有已在队列中的计划触发器
 	pendingTriggersMap := make(map[uint]models.PendingTask)
 	for _, pt := range allPendingTasks {
@@ -266,7 +278,7 @@ func (m *AnalysisPlanTaskManager) addOrUpdateTriggers(runnablePlans []*models.Pl
 }
 
 // createTriggerTask 是创建触发器任务的内部核心逻辑。
-func (m *AnalysisPlanTaskManager) createTriggerTask(plan *models.Plan) error {
+func (m *analysisPlanTaskManagerImpl) createTriggerTask(plan *models.Plan) error {
 	analysisTask, err := m.planRepo.FindPlanAnalysisTaskByPlanID(plan.ID)
 	if err != nil {
 		return fmt.Errorf("查找计划分析任务失败: %w", err)

internal/domain/plan/device_id_extractor.go

@@ -0,0 +1 @@
+package plan

internal/domain/plan/plan_execution_manager.go

@@ -1,4 +1,4 @@
-package task
+package plan
 
 import (
 	"errors"
@@ -13,6 +13,14 @@ import (
 	"gorm.io/gorm"
 )
 
+// ExecutionManager 定义了计划执行管理器的接口。
+type ExecutionManager interface {
+	// Start 启动计划执行管理器。
+	Start()
+	// Stop 优雅地停止计划执行管理器。
+	Stop()
+}
+
 // ProgressTracker 仅用于在内存中提供计划执行的并发锁
 type ProgressTracker struct {
 	mu           sync.Mutex
@@ -73,8 +81,8 @@ func (t *ProgressTracker) GetRunningPlanIDs() []uint {
 	return ids
 }
 
-// Scheduler 是核心的、持久化的任务调度器
-type Scheduler struct {
+// planExecutionManagerImpl 是核心的、持久化的任务调度器
+type planExecutionManagerImpl struct {
 	logger                  *logs.Logger
 	pollingInterval         time.Duration
 	workers                 int
@@ -83,7 +91,8 @@ type Scheduler struct {
 	deviceRepo              repository.DeviceRepository
 	sensorDataRepo          repository.SensorDataRepository
 	planRepo                repository.PlanRepository
-	analysisPlanTaskManager *AnalysisPlanTaskManager
+	taskFactory             TaskFactory
+	analysisPlanTaskManager AnalysisPlanTaskManager
 	progressTracker         *ProgressTracker
 	deviceService           device.Service
 
@@ -92,26 +101,28 @@ type Scheduler struct {
 	stopChan chan struct{} // 用于停止主循环的信号通道
 }
 
-// NewScheduler 创建一个新的调度器实例
-func NewScheduler(
+// NewPlanExecutionManager 创建一个新的调度器实例
+func NewPlanExecutionManager(
 	pendingTaskRepo repository.PendingTaskRepository,
 	executionLogRepo repository.ExecutionLogRepository,
 	deviceRepo repository.DeviceRepository,
 	sensorDataRepo repository.SensorDataRepository,
 	planRepo repository.PlanRepository,
-	analysisPlanTaskManager *AnalysisPlanTaskManager,
+	analysisPlanTaskManager AnalysisPlanTaskManager,
+	taskFactory TaskFactory,
 	logger *logs.Logger,
 	deviceService device.Service,
 	interval time.Duration,
 	numWorkers int,
-) *Scheduler {
-	return &Scheduler{
+) ExecutionManager {
+	return &planExecutionManagerImpl{
 		pendingTaskRepo:         pendingTaskRepo,
 		executionLogRepo:        executionLogRepo,
 		deviceRepo:              deviceRepo,
 		sensorDataRepo:          sensorDataRepo,
 		planRepo:                planRepo,
 		analysisPlanTaskManager: analysisPlanTaskManager,
+		taskFactory:             taskFactory,
 		logger:                  logger,
 		deviceService:           deviceService,
 		pollingInterval:         interval,
@@ -122,7 +133,7 @@ func NewScheduler(
 }
 
 // Start 启动调度器，包括初始化协程池和启动主轮询循环
-func (s *Scheduler) Start() {
+func (s *planExecutionManagerImpl) Start() {
 	s.logger.Warnf("任务调度器正在启动，工作协程数: %d...", s.workers)
 	pool, err := ants.NewPool(s.workers, ants.WithPanicHandler(func(err interface{}) {
 		s.logger.Errorf("[严重] 任务执行时发生 panic: %v", err)
@@ -138,7 +149,7 @@ func (s *Scheduler) Start() {
 }
 
 // Stop 优雅地停止调度器
-func (s *Scheduler) Stop() {
+func (s *planExecutionManagerImpl) Stop() {
 	s.logger.Warnf("正在停止任务调度器...")
 	close(s.stopChan) // 1. 发出停止信号，停止主循环
 	s.wg.Wait()       // 2. 等待主循环完成
@@ -147,7 +158,7 @@ func (s *Scheduler) Stop() {
 }
 
 // run 是主轮询循环，负责从数据库认领任务并提交到协程池
-func (s *Scheduler) run() {
+func (s *planExecutionManagerImpl) run() {
 	defer s.wg.Done()
 	ticker := time.NewTicker(s.pollingInterval)
 	defer ticker.Stop()
@@ -165,7 +176,7 @@ func (s *Scheduler) run() {
 }
 
 // claimAndSubmit 实现了最终的“认领-锁定-执行 或 等待-放回”的健壮逻辑
-func (s *Scheduler) claimAndSubmit() {
+func (s *planExecutionManagerImpl) claimAndSubmit() {
 	runningPlanIDs := s.progressTracker.GetRunningPlanIDs()
 
 	claimedLog, pendingTask, err := s.pendingTaskRepo.ClaimNextAvailableTask(runningPlanIDs)
@@ -198,7 +209,7 @@ func (s *Scheduler) claimAndSubmit() {
 }
 
 // handleRequeue 同步地、安全地将一个无法立即执行的任务放回队列。
-func (s *Scheduler) handleRequeue(planExecutionLogID uint, taskToRequeue *models.PendingTask) {
+func (s *planExecutionManagerImpl) handleRequeue(planExecutionLogID uint, taskToRequeue *models.PendingTask) {
 	s.logger.Warnf("计划 %d 正在执行，任务 %d (TaskID: %d) 将等待并重新入队...", planExecutionLogID, taskToRequeue.ID, taskToRequeue.TaskID)
 
 	// 1. 阻塞式地等待，直到可以获取到该计划的锁。
@@ -215,7 +226,7 @@ func (s *Scheduler) handleRequeue(planExecutionLogID uint, taskToRequeue *models
 }
 
 // processTask 处理单个任务的逻辑
-func (s *Scheduler) processTask(claimedLog *models.TaskExecutionLog) {
+func (s *planExecutionManagerImpl) processTask(claimedLog *models.TaskExecutionLog) {
 	s.logger.Warnf("开始处理任务, 日志ID: %d, 任务ID: %d, 任务名称: %s, 描述: %s",
 		claimedLog.ID, claimedLog.TaskID, claimedLog.Task.Name, claimedLog.Task.Description)
 
@@ -258,7 +269,7 @@ func (s *Scheduler) processTask(claimedLog *models.TaskExecutionLog) {
 }
 
 // runTask 用于执行具体任务
-func (s *Scheduler) runTask(claimedLog *models.TaskExecutionLog) error {
+func (s *planExecutionManagerImpl) runTask(claimedLog *models.TaskExecutionLog) error {
 	// 这是个特殊任务, 用于解析Plan并将解析出的任务队列添加到待执行队列中
 	if claimedLog.Task.Type == models.TaskPlanAnalysis {
 		// 解析plan
@@ -271,7 +282,7 @@ func (s *Scheduler) runTask(claimedLog *models.TaskExecutionLog) error {
 
 	} else {
 		// 执行普通任务
-		task := s.taskFactory(claimedLog)
+		task := s.taskFactory.Production(claimedLog)
 
 		if err := task.Execute(); err != nil {
 			s.logger.Errorf("[严重] 任务执行失败, 日志ID: %d, 错误: %v", claimedLog.ID, err)
@@ -283,22 +294,8 @@ func (s *Scheduler) runTask(claimedLog *models.TaskExecutionLog) error {
 	return nil
 }
 
-// taskFactory 会根据任务类型初始化对应任务
-func (s *Scheduler) taskFactory(claimedLog *models.TaskExecutionLog) Task {
-	switch claimedLog.Task.Type {
-	case models.TaskTypeWaiting:
-		return NewDelayTask(s.logger, claimedLog)
-	case models.TaskTypeReleaseFeedWeight:
-		return NewReleaseFeedWeightTask(claimedLog, s.sensorDataRepo, s.deviceRepo, s.deviceService, s.logger)
-
-	default:
-		// TODO 这里直接panic合适吗? 不过这个场景确实不该出现任何异常的任务类型
-		panic("不支持的任务类型")
-	}
-}
-
 // analysisPlan 解析Plan并将解析出的Task列表插入待执行队列中
-func (s *Scheduler) analysisPlan(claimedLog *models.TaskExecutionLog) error {
+func (s *planExecutionManagerImpl) analysisPlan(claimedLog *models.TaskExecutionLog) error {
 	// 创建Plan执行记录
 	// 从任务的 Parameters 中解析出真实的 PlanID
 	var params struct {
@@ -371,7 +368,7 @@ func (s *Scheduler) analysisPlan(claimedLog *models.TaskExecutionLog) error {
 }
 
 // updateTaskExecutionLogStatus 修改任务历史中的执行状态
-func (s *Scheduler) updateTaskExecutionLogStatus(claimedLog *models.TaskExecutionLog) error {
+func (s *planExecutionManagerImpl) updateTaskExecutionLogStatus(claimedLog *models.TaskExecutionLog) error {
 	claimedLog.EndedAt = time.Now()
 
 	if err := s.executionLogRepo.UpdateTaskExecutionLog(claimedLog); err != nil {
@@ -383,7 +380,7 @@ func (s *Scheduler) updateTaskExecutionLogStatus(claimedLog *models.TaskExecutio
 }
 
 // handlePlanTermination 集中处理计划的终止逻辑（失败或取消）
-func (s *Scheduler) handlePlanTermination(planLogID uint, reason string) {
+func (s *planExecutionManagerImpl) handlePlanTermination(planLogID uint, reason string) {
 	// 1. 从待执行队列中删除所有相关的子任务
 	if err := s.pendingTaskRepo.DeletePendingTasksByPlanLogID(planLogID); err != nil {
 		s.logger.Errorf("从待执行队列中删除计划 %d 的后续任务时出错: %v", planLogID, err)
@@ -399,19 +396,34 @@ func (s *Scheduler) handlePlanTermination(planLogID uint, reason string) {
 		s.logger.Errorf("取消计划 %d 的后续任务日志时出错: %v", planLogID, err)
 	}
 
-	// 4. 将计划本身的状态更新为失败
+	// 4. 获取计划执行日志以获取顶层 PlanID
 	planLog, err := s.executionLogRepo.FindPlanExecutionLogByID(planLogID)
 	if err != nil {
 		s.logger.Errorf("无法找到计划执行日志 %d 以更新父计划状态: %v", planLogID, err)
 		return
 	}
+
+	// 5. 获取顶层计划的详细信息，以检查其类型
+	topLevelPlan, err := s.planRepo.GetBasicPlanByID(planLog.PlanID)
+	if err != nil {
+		s.logger.Errorf("获取顶层计划 %d 的基本信息失败: %v", planLog.PlanID, err)
+		return
+	}
+
+	// 6. 如果是系统任务，则不修改计划状态
+	if topLevelPlan.PlanType == models.PlanTypeSystem {
+		s.logger.Warnf("系统任务 %d (日志ID: %d) 执行失败，但根据策略不修改其计划状态。", topLevelPlan.ID, planLogID)
+		return
+	}
+
+	// 7. 将计划本身的状态更新为失败 (仅对非系统任务执行)
 	if err := s.planRepo.UpdatePlanStatus(planLog.PlanID, models.PlanStatusFailed); err != nil {
 		s.logger.Errorf("更新计划 %d 状态为 '失败' 时出错: %v", planLog.PlanID, err)
 	}
 }
 
 // handlePlanCompletion 集中处理计划成功完成后的所有逻辑
-func (s *Scheduler) handlePlanCompletion(planLogID uint) {
+func (s *planExecutionManagerImpl) handlePlanCompletion(planLogID uint) {
 	s.logger.Infof("计划执行 %d 的所有任务已完成，开始处理计划完成逻辑...", planLogID)
 
 	// 1. 通过 PlanExecutionLog 反查正确的顶层 PlanID

internal/domain/plan/plan_service.go

@@ -0,0 +1,409 @@
+package plan
+
+import (
+	"errors"
+	"fmt"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+	"gorm.io/gorm"
+)
+
+var (
+	// ErrPlanNotFound 表示未找到计划
+	ErrPlanNotFound = errors.New("计划不存在")
+	// ErrPlanCannotBeModified 表示计划不允许修改
+	ErrPlanCannotBeModified = errors.New("系统计划不允许修改")
+	// ErrPlanCannotBeDeleted 表示计划不允许删除
+	ErrPlanCannotBeDeleted = errors.New("系统计划不允许删除")
+	// ErrPlanCannotBeStarted 表示计划不允许手动启动
+	ErrPlanCannotBeStarted = errors.New("系统计划不允许手动启动")
+	// ErrPlanAlreadyEnabled 表示计划已处于启动状态
+	ErrPlanAlreadyEnabled = errors.New("计划已处于启动状态，无需重复操作")
+	// ErrPlanNotEnabled 表示计划未处于启动状态
+	ErrPlanNotEnabled = errors.New("计划当前不是启用状态")
+	// ErrPlanCannotBeStopped 表示计划不允许停止
+	ErrPlanCannotBeStopped = errors.New("系统计划不允许停止")
+)
+
+// Service 定义了计划领域服务的接口。
+type Service interface {
+	// Start 启动计划相关的后台服务，例如计划执行管理器。
+	Start()
+	// Stop 停止计划相关的后台服务，例如计划执行管理器。
+	Stop()
+	// RefreshPlanTriggers 刷新计划触发器，同步数据库中的计划状态和待执行队列中的触发器任务。
+	RefreshPlanTriggers() error
+
+	// CreatePlan 创建一个新的计划
+	CreatePlan(plan *models.Plan) (*models.Plan, error)
+	// GetPlanByID 根据ID获取计划详情
+	GetPlanByID(id uint) (*models.Plan, error)
+	// ListPlans 获取计划列表，支持过滤和分页
+	ListPlans(opts repository.ListPlansOptions, page, pageSize int) ([]models.Plan, int64, error)
+	// UpdatePlan 更新计划
+	UpdatePlan(plan *models.Plan) (*models.Plan, error)
+	// DeletePlan 删除计划（软删除）
+	DeletePlan(id uint) error
+	// StartPlan 启动计划
+	StartPlan(id uint) error
+	// StopPlan 停止计划
+	StopPlan(id uint) error
+}
+
+// planServiceImpl 是 Service 接口的具体实现。
+type planServiceImpl struct {
+	executionManager ExecutionManager
+	taskManager      AnalysisPlanTaskManager
+	planRepo         repository.PlanRepository
+	deviceRepo       repository.DeviceRepository
+	unitOfWork       repository.UnitOfWork
+	taskFactory      TaskFactory
+	logger           *logs.Logger
+}
+
+// NewPlanService 创建一个新的 Service 实例。
+func NewPlanService(
+	executionManager ExecutionManager,
+	taskManager AnalysisPlanTaskManager,
+	planRepo repository.PlanRepository,
+	deviceRepo repository.DeviceRepository,
+	unitOfWork repository.UnitOfWork,
+	taskFactory TaskFactory,
+	logger *logs.Logger,
+) Service {
+	return &planServiceImpl{
+		executionManager: executionManager,
+		taskManager:      taskManager,
+		planRepo:         planRepo,
+		deviceRepo:       deviceRepo,
+		unitOfWork:       unitOfWork,
+		taskFactory:      taskFactory,
+		logger:           logger,
+	}
+}
+
+// Start 启动计划相关的后台服务。
+func (s *planServiceImpl) Start() {
+	s.logger.Infof("PlanService 正在启动...")
+	s.executionManager.Start()
+}
+
+// Stop 停止计划相关的后台服务。
+func (s *planServiceImpl) Stop() {
+	s.logger.Infof("PlanService 正在停止...")
+	s.executionManager.Stop()
+}
+
+// RefreshPlanTriggers 刷新计划触发器。
+func (s *planServiceImpl) RefreshPlanTriggers() error {
+	s.logger.Infof("PlanService 正在刷新计划触发器...")
+	return s.taskManager.Refresh()
+}
+
+// CreatePlan 创建一个新的计划
+func (s *planServiceImpl) CreatePlan(planToCreate *models.Plan) (*models.Plan, error) {
+	const actionType = "领域层：创建计划"
+
+	// 1. 业务规则处理
+	// 用户创建的计划永远是自定义计划
+	planToCreate.PlanType = models.PlanTypeCustom
+
+	// 自动判断 ContentType
+	if len(planToCreate.SubPlans) > 0 {
+		planToCreate.ContentType = models.PlanContentTypeSubPlans
+	} else {
+		planToCreate.ContentType = models.PlanContentTypeTasks
+	}
+
+	// 2. 验证和重排顺序 (领域逻辑)
+	if err := planToCreate.ValidateExecutionOrder(); err != nil {
+		s.logger.Errorf("%s: 计划 (ID: %d) 的执行顺序无效: %v", actionType, planToCreate.ID, err)
+		return nil, err
+	}
+	planToCreate.ReorderSteps()
+
+	// 3. 在调用仓库前，准备好所有数据，包括设备关联
+	for i := range planToCreate.Tasks {
+		taskModel := &planToCreate.Tasks[i]
+		// 使用工厂创建临时领域对象
+		taskResolver, err := s.taskFactory.CreateTaskFromModel(taskModel)
+		if err != nil {
+			// 如果一个任务类型不支持，我们可以选择跳过或报错
+			s.logger.Warnf("跳过为任务类型 '%s' 解析设备ID: %v", taskModel.Type, err)
+			continue
+		}
+
+		deviceIDs, err := taskResolver.ResolveDeviceIDs()
+		if err != nil {
+			// 在事务外解析失败，直接返回错误
+			return nil, fmt.Errorf("为任务 '%s' 提取设备ID失败: %w", taskModel.Name, err)
+		}
+		if len(deviceIDs) > 0 {
+			// 优化：无需查询完整的设备对象，只需构建包含ID的结构体即可建立关联
+			devices := make([]models.Device, len(deviceIDs))
+			for i, id := range deviceIDs {
+				devices[i] = models.Device{Model: gorm.Model{ID: id}}
+			}
+			taskModel.Devices = devices
+		}
+	}
+
+	// 4. 调用仓库方法创建计划，该方法内部会处理事务
+	err := s.planRepo.CreatePlan(planToCreate)
+	if err != nil {
+		s.logger.Errorf("%s: 数据库创建计划失败: %v", actionType, err)
+		return nil, err
+	}
+
+	// 5. 创建成功后，调用 manager 确保触发器任务定义存在，但不立即加入待执行队列
+	if err := s.taskManager.EnsureAnalysisTaskDefinition(planToCreate.ID); err != nil {
+		// 这是一个非阻塞性错误，我们只记录日志，因为主流程（创建计划）已经成功
+		s.logger.Errorf("为新创建的计划 %d 确保触发器任务定义失败: %v", planToCreate.ID, err)
+	}
+
+	s.logger.Infof("%s: 计划创建成功, ID: %d", actionType, planToCreate.ID)
+	return planToCreate, nil
+}
+
+// GetPlanByID 根据ID获取计划详情
+func (s *planServiceImpl) GetPlanByID(id uint) (*models.Plan, error) {
+	const actionType = "领域层：获取计划详情"
+
+	plan, err := s.planRepo.GetPlanByID(id)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			s.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
+			return nil, ErrPlanNotFound
+		}
+		s.logger.Errorf("%s: 数据库查询失败: %v, ID: %d", actionType, err, id)
+		return nil, err
+	}
+
+	s.logger.Infof("%s: 获取计划详情成功, ID: %d", actionType, id)
+	return plan, nil
+}
+
+// ListPlans 获取计划列表，支持过滤和分页
+func (s *planServiceImpl) ListPlans(opts repository.ListPlansOptions, page, pageSize int) ([]models.Plan, int64, error) {
+	const actionType = "领域层：获取计划列表"
+
+	plans, total, err := s.planRepo.ListPlans(opts, page, pageSize)
+	if err != nil {
+		s.logger.Errorf("%s: 数据库查询失败: %v", actionType, err)
+		return nil, 0, err
+	}
+
+	s.logger.Infof("%s: 获取计划列表成功, 数量: %d", actionType, len(plans))
+	return plans, total, nil
+}
+
+// UpdatePlan 更新计划
+func (s *planServiceImpl) UpdatePlan(planToUpdate *models.Plan) (*models.Plan, error) {
+	const actionType = "领域层：更新计划"
+
+	existingPlan, err := s.planRepo.GetBasicPlanByID(planToUpdate.ID)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			s.logger.Warnf("%s: 计划不存在, ID: %d", actionType, planToUpdate.ID)
+			return nil, ErrPlanNotFound
+		}
+		s.logger.Errorf("%s: 获取计划信息失败: %v, ID: %d", actionType, err, planToUpdate.ID)
+		return nil, err
+	}
+
+	// 系统计划不允许修改
+	if existingPlan.PlanType == models.PlanTypeSystem {
+		s.logger.Warnf("%s: 尝试修改系统计划, ID: %d", actionType, planToUpdate.ID)
+		return nil, ErrPlanCannotBeModified
+	}
+
+	// 自动判断 ContentType
+	if len(planToUpdate.SubPlans) > 0 {
+		planToUpdate.ContentType = models.PlanContentTypeSubPlans
+	} else {
+		planToUpdate.ContentType = models.PlanContentTypeTasks
+	}
+
+	// 验证和重排顺序 (领域逻辑)
+	if err := planToUpdate.ValidateExecutionOrder(); err != nil {
+		s.logger.Errorf("%s: 计划 (ID: %d) 的执行顺序无效: %v", actionType, planToUpdate.ID, err)
+		return nil, err
+	}
+	planToUpdate.ReorderSteps()
+
+	// 只要是更新任务，就重置执行计数器
+	planToUpdate.ExecuteCount = 0
+	s.logger.Infof("计划 #%d 被更新，执行计数器已重置为 0。", planToUpdate.ID)
+
+	// 在调用仓库前，准备好所有数据，包括设备关联
+	for i := range planToUpdate.Tasks {
+		taskModel := &planToUpdate.Tasks[i]
+		taskResolver, err := s.taskFactory.CreateTaskFromModel(taskModel)
+		if err != nil {
+			s.logger.Warnf("跳过为任务类型 '%s' 解析设备ID: %v", taskModel.Type, err)
+			continue
+		}
+
+		deviceIDs, err := taskResolver.ResolveDeviceIDs()
+		if err != nil {
+			return nil, fmt.Errorf("为任务 '%s' 提取设备ID失败: %w", taskModel.Name, err)
+		}
+		if len(deviceIDs) > 0 {
+			// 优化：无需查询完整的设备对象，只需构建包含ID的结构体即可建立关联
+			devices := make([]models.Device, len(deviceIDs))
+			for i, id := range deviceIDs {
+				devices[i] = models.Device{Model: gorm.Model{ID: id}}
+			}
+			taskModel.Devices = devices
+		}
+	}
+
+	// 调用仓库方法更新计划，该方法内部会处理事务
+	err = s.planRepo.UpdatePlanMetadataAndStructure(planToUpdate)
+	if err != nil {
+		s.logger.Errorf("%s: 数据库更新计划失败: %v, Plan: %+v", actionType, err, planToUpdate)
+		return nil, err
+	}
+
+	if err := s.taskManager.EnsureAnalysisTaskDefinition(planToUpdate.ID); err != nil {
+		s.logger.Errorf("为更新后的计划 %d 确保触发器任务定义失败: %v", planToUpdate.ID, err)
+	}
+
+	updatedPlan, err := s.planRepo.GetPlanByID(planToUpdate.ID)
+	if err != nil {
+		s.logger.Errorf("%s: 获取更新后计划详情失败: %v, ID: %d", actionType, err, planToUpdate.ID)
+		return nil, errors.New("获取更新后计划详情时发生内部错误")
+	}
+
+	s.logger.Infof("%s: 计划更新成功, ID: %d", actionType, updatedPlan.ID)
+	return updatedPlan, nil
+}
+
+// DeletePlan 删除计划（软删除）
+func (s *planServiceImpl) DeletePlan(id uint) error {
+	const actionType = "领域层：删除计划"
+
+	plan, err := s.planRepo.GetBasicPlanByID(id)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			s.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
+			return ErrPlanNotFound
+		}
+		s.logger.Errorf("%s: 获取计划信息失败: %v, ID: %d", actionType, err, id)
+		return err
+	}
+
+	// 系统计划不允许删除
+	if plan.PlanType == models.PlanTypeSystem {
+		s.logger.Warnf("%s: 尝试删除系统计划, ID: %d", actionType, id)
+		return ErrPlanCannotBeDeleted
+	}
+
+	// 如果计划处于启用状态，先停止它
+	if plan.Status == models.PlanStatusEnabled {
+		if err := s.planRepo.StopPlanTransactionally(id); err != nil {
+			s.logger.Errorf("%s: 停止计划失败: %v, ID: %d", actionType, err, id)
+			return err
+		}
+	}
+
+	if err := s.planRepo.DeletePlan(id); err != nil {
+		s.logger.Errorf("%s: 数据库删除失败: %v, ID: %d", actionType, err, id)
+		return err
+	}
+
+	s.logger.Infof("%s: 计划删除成功, ID: %d", actionType, id)
+	return nil
+}
+
+// StartPlan 启动计划
+func (s *planServiceImpl) StartPlan(id uint) error {
+	const actionType = "领域层：启动计划"
+
+	plan, err := s.planRepo.GetBasicPlanByID(id)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			s.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
+			return ErrPlanNotFound
+		}
+		s.logger.Errorf("%s: 获取计划信息失败: %v, ID: %d", actionType, err, id)
+		return err
+	}
+
+	// 系统计划不允许手动启动
+	if plan.PlanType == models.PlanTypeSystem {
+		s.logger.Warnf("%s: 尝试手动启动系统计划, ID: %d", actionType, id)
+		return ErrPlanCannotBeStarted
+	}
+	// 计划已处于启动状态，无需重复操作
+	if plan.Status == models.PlanStatusEnabled {
+		s.logger.Warnf("%s: 计划已处于启动状态，无需重复操作, ID: %d", actionType, id)
+		return ErrPlanAlreadyEnabled
+	}
+
+	// 如果计划未处于启用状态
+	if plan.Status != models.PlanStatusEnabled {
+		// 如果执行计数器大于0，重置为0
+		if plan.ExecuteCount > 0 {
+			if err := s.planRepo.UpdateExecuteCount(plan.ID, 0); err != nil {
+				s.logger.Errorf("%s: 重置计划执行计数失败: %v, ID: %d", actionType, err, plan.ID)
+				return err
+			}
+			s.logger.Infof("计划 #%d 的执行计数器已重置为 0。", plan.ID)
+		}
+
+		// 更新计划状态为启用
+		if err := s.planRepo.UpdatePlanStatus(plan.ID, models.PlanStatusEnabled); err != nil {
+			s.logger.Errorf("%s: 更新计划状态失败: %v, ID: %d", actionType, err, plan.ID)
+			return err
+		}
+		s.logger.Infof("已成功更新计划 #%d 的状态为 '已启动'。", plan.ID)
+	}
+
+	// 创建或更新触发器
+	if err := s.taskManager.CreateOrUpdateTrigger(plan.ID); err != nil {
+		s.logger.Errorf("%s: 创建或更新触发器失败: %v, ID: %d", actionType, err, plan.ID)
+		return err
+	}
+
+	s.logger.Infof("%s: 计划已成功启动, ID: %d", actionType, id)
+	return nil
+}
+
+// StopPlan 停止计划
+func (s *planServiceImpl) StopPlan(id uint) error {
+	const actionType = "领域层：停止计划"
+
+	plan, err := s.planRepo.GetBasicPlanByID(id)
+	if err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			s.logger.Warnf("%s: 计划不存在, ID: %d", actionType, id)
+			return ErrPlanNotFound
+		}
+		s.logger.Errorf("%s: 获取计划信息失败: %v, ID: %d", actionType, err, id)
+		return err
+	}
+
+	// 系统计划不允许停止
+	if plan.PlanType == models.PlanTypeSystem {
+		s.logger.Warnf("%s: 尝试停止系统计划, ID: %d", actionType, id)
+		return ErrPlanCannotBeStopped
+	}
+
+	// 计划当前不是启用状态
+	if plan.Status != models.PlanStatusEnabled {
+		s.logger.Warnf("%s: 计划当前不是启用状态, ID: %d, Status: %s", actionType, id, plan.Status)
+		return ErrPlanNotEnabled
+	}
+
+	// 停止计划事务性操作
+	if err := s.planRepo.StopPlanTransactionally(id); err != nil {
+		s.logger.Errorf("%s: 停止计划失败: %v, ID: %d", actionType, err, id)
+		return err
+	}
+
+	s.logger.Infof("%s: 计划已成功停止, ID: %d", actionType, id)
+	return nil
+}

internal/domain/plan/task.go

@@ -0,0 +1,34 @@
+package plan
+
+import "git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+
+// Task 定义了所有可被调度器执行的任务必须实现的接口。
+type Task interface {
+	// Execute 是任务的核心执行逻辑。
+	// ctx: 用于控制任务的超时或取消。
+	// log: 包含了当前任务执行的完整上下文信息，包括从数据库中加载的任务参数等。
+	// 返回的 error 表示任务是否执行成功。调度器会根据返回的 error 是否为 nil 来决定任务状态。
+	Execute() error
+
+	// OnFailure 定义了当 Execute 方法返回错误时，需要执行的回滚或清理逻辑。
+	// log: 任务执行的上下文。
+	// executeErr: 从 Execute 方法返回的原始错误。
+	OnFailure(executeErr error)
+
+	TaskDeviceIDResolver
+}
+
+// TaskDeviceIDResolver 定义了从任务配置中解析设备ID的方法
+type TaskDeviceIDResolver interface {
+	// ResolveDeviceIDs 从任务配置中解析并返回所有关联的设备ID列表
+	// 返回值: uint数组，每个字符串代表一个设备ID
+	ResolveDeviceIDs() ([]uint, error)
+}
+
+// TaskFactory 是一个工厂接口，用于根据任务执行日志创建任务实例。
+type TaskFactory interface {
+	// Production 根据指定的任务执行日志创建一个任务实例。
+	Production(claimedLog *models.TaskExecutionLog) Task
+	// CreateTaskFromModel 仅根据任务模型创建一个任务实例，用于非执行场景（如参数解析）。
+	CreateTaskFromModel(taskModel *models.Task) (TaskDeviceIDResolver, error)
+}

internal/domain/task/delay_task.go

@@ -4,6 +4,7 @@ import (
 	"fmt"
 	"time"
 
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/plan"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
 )
@@ -19,7 +20,7 @@ type DelayTask struct {
 	logger        *logs.Logger
 }
 
-func NewDelayTask(logger *logs.Logger, executionTask *models.TaskExecutionLog) Task {
+func NewDelayTask(logger *logs.Logger, executionTask *models.TaskExecutionLog) plan.Task {
 	return &DelayTask{
 		executionTask: executionTask,
 		logger:        logger,
@@ -64,3 +65,7 @@ func (d *DelayTask) parseParameters() error {
 func (d *DelayTask) OnFailure(executeErr error) {
 	d.logger.Errorf("任务 %v: 执行失败: %v", d.executionTask.TaskID, executeErr)
 }
+
+func (d *DelayTask) ResolveDeviceIDs() ([]uint, error) {
+	return []uint{}, nil
+}

internal/domain/task/delay_task_test.go

@@ -1,61 +0,0 @@
-package task_test
-
-import (
-	"fmt"
-	"testing"
-	"time"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/service/task"
-)
-
-func TestNewDelayTask(t *testing.T) {
-	id := "test-delay-task-1"
-	duration := 100 * time.Millisecond
-	priority := 1
-
-	dt := task.NewDelayTask(id, duration, priority)
-
-	if dt.GetID() != id {
-		t.Errorf("期望任务ID为 %s, 实际为 %s", id, dt.GetID())
-	}
-	if dt.GetPriority() != priority {
-		t.Errorf("期望任务优先级为 %d, 实际为 %d", priority, dt.GetPriority())
-	}
-	if dt.IsDone() != false {
-		t.Error("任务初始状态不应为已完成")
-	}
-	// 动态生成的描述，需要匹配 GetDescription 的实现
-	expectedDesc := fmt.Sprintf("延迟任务，ID: %s，延迟时间: %s", id, duration)
-	if dt.GetDescription() != expectedDesc {
-		t.Errorf("期望任务描述为 %s, 实际为 %s", expectedDesc, dt.GetDescription())
-	}
-}
-
-func TestDelayTaskExecute(t *testing.T) {
-	id := "test-delay-task-execute"
-	duration := 50 * time.Millisecond // 使用较短的延迟以加快测试速度
-	priority := 1
-
-	dt := task.NewDelayTask(id, duration, priority)
-
-	if dt.IsDone() {
-		t.Error("任务执行前不应为已完成状态")
-	}
-
-	startTime := time.Now()
-	err := dt.Execute()
-	endTime := time.Now()
-
-	if err != nil {
-		t.Errorf("Execute 方法返回错误: %v", err)
-	}
-	if !dt.IsDone() {
-		t.Error("任务执行后应为已完成状态")
-	}
-
-	// 验证延迟时间大致正确，允许一些误差
-	elapsed := endTime.Sub(startTime)
-	if elapsed < duration || elapsed > duration*2 {
-		t.Errorf("期望执行时间在 %v 左右, 但实际耗时 %v", duration, elapsed)
-	}
-}

internal/domain/task/full_collection_task.go

@@ -0,0 +1,100 @@
+package task
+
+import (
+	"fmt"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/device"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/plan"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
+)
+
+// FullCollectionTask 实现了 plan.Task 接口，用于执行一次全量的设备数据采集
+type FullCollectionTask struct {
+	log           *models.TaskExecutionLog
+	deviceRepo    repository.DeviceRepository
+	deviceService device.Service
+	logger        *logs.Logger
+}
+
+// NewFullCollectionTask 创建一个全量采集任务实例
+func NewFullCollectionTask(
+	log *models.TaskExecutionLog,
+	deviceRepo repository.DeviceRepository,
+	deviceService device.Service,
+	logger *logs.Logger,
+) plan.Task {
+	return &FullCollectionTask{
+		log:           log,
+		deviceRepo:    deviceRepo,
+		deviceService: deviceService,
+		logger:        logger,
+	}
+}
+
+// Execute 是任务的核心执行逻辑
+func (t *FullCollectionTask) Execute() error {
+	t.logger.Infow("开始执行全量采集任务", "task_id", t.log.TaskID, "task_type", t.log.Task.Type, "log_id", t.log.ID)
+
+	sensors, err := t.deviceRepo.ListAllSensors()
+	if err != nil {
+		return fmt.Errorf("全量采集任务: 从数据库获取所有传感器失败: %w", err)
+	}
+
+	if len(sensors) == 0 {
+		t.logger.Infow("全量采集任务: 未发现任何传感器设备，跳过本次采集", "task_id", t.log.TaskID, "task_type", t.log.Task.Type, "log_id", t.log.ID)
+		return nil
+	}
+
+	sensorsByController := make(map[uint][]*models.Device)
+	for _, sensor := range sensors {
+		sensorsByController[sensor.AreaControllerID] = append(sensorsByController[sensor.AreaControllerID], sensor)
+	}
+
+	var firstError error
+	for controllerID, controllerSensors := range sensorsByController {
+		t.logger.Infow("全量采集任务: 准备为区域主控下的传感器下发采集指令",
+			"task_id", t.log.TaskID,
+			"task_type", t.log.Task.Type,
+			"log_id", t.log.ID,
+			"controller_id", controllerID,
+			"sensor_count", len(controllerSensors),
+		)
+		if err := t.deviceService.Collect(controllerID, controllerSensors); err != nil {
+			t.logger.Errorw("全量采集任务: 为区域主控下发采集指令失败",
+				"task_id", t.log.TaskID,
+				"task_type", t.log.Task.Type,
+				"log_id", t.log.ID,
+				"controller_id", controllerID,
+				"error", err,
+			)
+			if firstError == nil {
+				firstError = err // 保存第一个错误
+			}
+		}
+	}
+
+	if firstError != nil {
+		return fmt.Errorf("全量采集任务执行期间发生错误: %w", firstError)
+	}
+
+	t.logger.Infow("全量采集任务执行完成", "task_id", t.log.TaskID, "task_type", t.log.Task.Type, "log_id", t.log.ID)
+	return nil
+}
+
+// OnFailure 定义了当 Execute 方法返回错误时，需要执行的回滚或清理逻辑
+func (t *FullCollectionTask) OnFailure(executeErr error) {
+	t.logger.Errorw("全量采集任务执行失败",
+		"task_id", t.log.TaskID,
+		"task_type", t.log.Task.Type,
+		"log_id", t.log.ID,
+		"error", executeErr,
+	)
+}
+
+// ResolveDeviceIDs 获取当前任务需要使用的设备ID列表
+func (t *FullCollectionTask) ResolveDeviceIDs() ([]uint, error) {
+	// 全量采集任务不和任何设备绑定, 每轮采集都会重新获取全量传感器
+	return []uint{}, nil
+}

internal/domain/task/release_feed_weight_task.go

@@ -3,9 +3,11 @@ package task
 import (
 	"encoding/json"
 	"fmt"
+	"sync"
 	"time"
 
 	"git.huangwc.com/pig/pig-farm-controller/internal/domain/device"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/plan"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
@@ -30,6 +32,9 @@ type ReleaseFeedWeightTask struct {
 
 	feedPort device.Service
 
+	// onceParse 保证解析参数只执行一次
+	onceParse sync.Once
+
 	logger *logs.Logger
 }
 
@@ -40,12 +45,12 @@ func NewReleaseFeedWeightTask(
 	deviceRepo repository.DeviceRepository,
 	deviceService device.Service,
 	logger *logs.Logger,
-) Task {
+) plan.Task {
 	return &ReleaseFeedWeightTask{
 		claimedLog:     claimedLog,
 		deviceRepo:     deviceRepo,
 		sensorDataRepo: sensorDataRepo,
-		feedPort:       deviceService, // 直接注入
+		feedPort:       deviceService,
 		logger:         logger,
 	}
 }
@@ -116,45 +121,48 @@ func (r *ReleaseFeedWeightTask) getNowWeight() (float64, error) {
 }
 
 func (r *ReleaseFeedWeightTask) parseParameters() error {
-	if r.claimedLog.Task.Parameters == nil {
-		r.logger.Errorf("任务 %v: 缺少参数", r.claimedLog.TaskID)
-		return fmt.Errorf("任务 %v: 参数不全", r.claimedLog.TaskID)
-	}
+	var err error
+	r.onceParse.Do(func() {
+		if r.claimedLog.Task.Parameters == nil {
+			r.logger.Errorf("任务 %v: 缺少参数", r.claimedLog.TaskID)
+			err = fmt.Errorf("任务 %v: 参数不全", r.claimedLog.TaskID)
+		}
 
-	var params ReleaseFeedWeightTaskParams
-	err := r.claimedLog.Task.ParseParameters(&params)
-	if err != nil {
-		r.logger.Errorf("任务 %v: 解析参数失败: %v", r.claimedLog.TaskID, err)
-		return fmt.Errorf("任务 %v: 解析参数失败: %v", r.claimedLog.TaskID, err)
-	}
+		var params ReleaseFeedWeightTaskParams
+		err := r.claimedLog.Task.ParseParameters(&params)
+		if err != nil {
+			r.logger.Errorf("任务 %v: 解析参数失败: %v", r.claimedLog.TaskID, err)
+			err = fmt.Errorf("任务 %v: 解析参数失败: %v", r.claimedLog.TaskID, err)
+		}
 
-	// 校验参数是否存在
-	if params.ReleaseWeight == 0 {
-		r.logger.Errorf("任务 %v: 参数 release_weight 缺失或无效", r.claimedLog.TaskID)
-		return fmt.Errorf("任务 %v: 参数 release_weight 缺失或无效", r.claimedLog.TaskID)
-	}
-	if params.FeedPortDeviceID == 0 {
-		r.logger.Errorf("任务 %v: 参数 feed_port_device_id 缺失或无效", r.claimedLog.TaskID)
-		return fmt.Errorf("任务 %v: 参数 feed_port_device_id 缺失或无效", r.claimedLog.TaskID)
-	}
-	if params.MixingTankDeviceID == 0 {
-		r.logger.Errorf("任务 %v: 参数 mixing_tank_device_id 缺失或无效", r.claimedLog.TaskID)
-		return fmt.Errorf("任务 %v: 参数 mixing_tank_device_id 缺失或无效", r.claimedLog.TaskID)
-	}
+		// 校验参数是否存在
+		if params.ReleaseWeight == 0 {
+			r.logger.Errorf("任务 %v: 参数 release_weight 缺失或无效", r.claimedLog.TaskID)
+			err = fmt.Errorf("任务 %v: 参数 release_weight 缺失或无效", r.claimedLog.TaskID)
+		}
+		if params.FeedPortDeviceID == 0 {
+			r.logger.Errorf("任务 %v: 参数 feed_port_device_id 缺失或无效", r.claimedLog.TaskID)
+			err = fmt.Errorf("任务 %v: 参数 feed_port_device_id 缺失或无效", r.claimedLog.TaskID)
+		}
+		if params.MixingTankDeviceID == 0 {
+			r.logger.Errorf("任务 %v: 参数 mixing_tank_device_id 缺失或无效", r.claimedLog.TaskID)
+			err = fmt.Errorf("任务 %v: 参数 mixing_tank_device_id 缺失或无效", r.claimedLog.TaskID)
+		}
 
-	r.releaseWeight = params.ReleaseWeight
-	r.mixingTankDeviceID = params.MixingTankDeviceID
-	r.feedPortDevice, err = r.deviceRepo.FindByID(params.FeedPortDeviceID)
-	if err != nil {
-		r.logger.Errorf("任务 %v: 获取设备信息失败: %v", r.claimedLog.TaskID, err)
-		return fmt.Errorf("任务 %v: 获取设备信息失败: %v", r.claimedLog.TaskID, err)
-	}
+		r.releaseWeight = params.ReleaseWeight
+		r.mixingTankDeviceID = params.MixingTankDeviceID
+		r.feedPortDevice, err = r.deviceRepo.FindByID(params.FeedPortDeviceID)
+		if err != nil {
+			r.logger.Errorf("任务 %v: 获取设备信息失败: %v", r.claimedLog.TaskID, err)
+			err = fmt.Errorf("任务 %v: 获取设备信息失败: %v", r.claimedLog.TaskID, err)
+		}
 
-	return nil
+	})
+	return err
 }
 
 func (r *ReleaseFeedWeightTask) OnFailure(executeErr error) {
-	r.logger.Errorf("开始善后处理, 日志ID:%v", r.claimedLog.ID)
+	r.logger.Errorf("开始善后处理, 日志ID:%v; 错误信息: %v", r.claimedLog.ID, executeErr)
 	if r.feedPort != nil {
 		err := r.feedPort.Switch(r.feedPortDevice, device.DeviceActionStop)
 		if err != nil {
@@ -165,3 +173,10 @@ func (r *ReleaseFeedWeightTask) OnFailure(executeErr error) {
 	}
 	r.logger.Errorf("善后处理完成, 日志ID:%v", r.claimedLog.ID)
 }
+
+func (r *ReleaseFeedWeightTask) ResolveDeviceIDs() ([]uint, error) {
+	if err := r.parseParameters(); err != nil {
+		return nil, err
+	}
+	return []uint{r.feedPortDevice.ID, r.mixingTankDeviceID}, nil
+}

internal/domain/task/task.go

@@ -1,30 +1,71 @@
 package task
 
 import (
+	"fmt"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/device"
+	"git.huangwc.com/pig/pig-farm-controller/internal/domain/plan"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
 	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
 )
 
-// Task 定义了所有可被调度器执行的任务必须实现的接口。
-type Task interface {
-	// Execute 是任务的核心执行逻辑。
-	// ctx: 用于控制任务的超时或取消。
-	// log: 包含了当前任务执行的完整上下文信息，包括从数据库中加载的任务参数等。
-	// 返回的 error 表示任务是否执行成功。调度器会根据返回的 error 是否为 nil 来决定任务状态。
-	Execute() error
-
-	// OnFailure 定义了当 Execute 方法返回错误时，需要执行的回滚或清理逻辑。
-	// log: 任务执行的上下文。
-	// executeErr: 从 Execute 方法返回的原始错误。
-	OnFailure(executeErr error)
+type taskFactory struct {
+	logger         *logs.Logger
+	sensorDataRepo repository.SensorDataRepository
+	deviceRepo     repository.DeviceRepository
+	deviceService  device.Service
 }
 
-// TaskFactory 是一个任务组装工厂, 可以根据Task类型获取到对应的初始化函数
-var TaskFactory = func(tt models.TaskType) Task {
-	switch tt {
-	case models.TaskTypeWaiting:
-		return &DelayTask{}
-	default:
-		// 出现位置任务类型说明业务逻辑出现重大问题, 一个异常任务被创建了出来
-		panic("发现未知任务类型")
+func NewTaskFactory(
+	logger *logs.Logger,
+	sensorDataRepo repository.SensorDataRepository,
+	deviceRepo repository.DeviceRepository,
+	deviceService device.Service,
+) plan.TaskFactory {
+	return &taskFactory{
+		logger:         logger,
+		sensorDataRepo: sensorDataRepo,
+		deviceRepo:     deviceRepo,
+		deviceService:  deviceService,
+	}
+}
+
+func (t *taskFactory) Production(claimedLog *models.TaskExecutionLog) plan.Task {
+	switch claimedLog.Task.Type {
+	case models.TaskTypeWaiting:
+		return NewDelayTask(t.logger, claimedLog)
+	case models.TaskTypeReleaseFeedWeight:
+		return NewReleaseFeedWeightTask(claimedLog, t.sensorDataRepo, t.deviceRepo, t.deviceService, t.logger)
+	case models.TaskTypeFullCollection:
+		return NewFullCollectionTask(claimedLog, t.deviceRepo, t.deviceService, t.logger)
+	default:
+		// TODO 这里直接panic合适吗? 不过这个场景确实不该出现任何异常的任务类型
+		t.logger.Panicf("不支持的任务类型: %s", claimedLog.Task.Type)
+		panic("不支持的任务类型") // 显式panic防编译器报错
+	}
+}
+
+// CreateTaskFromModel 实现了 TaskFactory 接口，用于从模型创建任务实例。
+func (t *taskFactory) CreateTaskFromModel(taskModel *models.Task) (plan.TaskDeviceIDResolver, error) {
+	// 这个方法不关心 claimedLog 的其他字段，所以可以构造一个临时的
+	// 它只用于访问那些不依赖于执行日志的方法，比如 ResolveDeviceIDs
+	tempLog := &models.TaskExecutionLog{Task: *taskModel}
+
+	switch taskModel.Type {
+	case models.TaskTypeWaiting:
+		return NewDelayTask(t.logger, tempLog), nil
+	case models.TaskTypeReleaseFeedWeight:
+		return NewReleaseFeedWeightTask(
+			tempLog,
+			t.sensorDataRepo,
+			t.deviceRepo,
+			t.deviceService,
+			t.logger,
+		), nil
+	case models.TaskTypeFullCollection:
+		return NewFullCollectionTask(tempLog, t.deviceRepo, t.deviceService, t.logger), nil
+	default:
+		return nil, fmt.Errorf("不支持为类型 '%s' 的任务创建模型实例", taskModel.Type)
 	}
 }

internal/domain/token/token_service.go

@@ -13,19 +13,19 @@ type Claims struct {
 	jwt.RegisteredClaims
 }
 
-// TokenService 定义了 token 操作的接口
-type TokenService interface {
+// Service 定义了 token 操作的接口
+type Service interface {
 	GenerateToken(userID uint) (string, error)
 	ParseToken(tokenString string) (*Claims, error)
 }
 
-// tokenService 是 TokenService 接口的实现
+// tokenService 是 Service 接口的实现
 type tokenService struct {
 	secret []byte
 }
 
-// NewTokenService 创建并返回一个新的 TokenService 实例
-func NewTokenService(secret []byte) TokenService {
+// NewTokenService 创建并返回一个新的 Service 实例
+func NewTokenService(secret []byte) Service {
 	return &tokenService{secret: secret}
 }
 

internal/domain/token/token_service_test.go

@@ -1,107 +0,0 @@
-package token_test
-
-import (
-	"errors"
-	"testing"
-	"time"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/app/service/token"
-	"github.com/golang-jwt/jwt/v5"
-)
-
-func TestGenerateToken(t *testing.T) {
-	// 使用一个测试密钥初始化 TokenService
-	testSecret := []byte("test_secret_key")
-	service := token.NewTokenService(testSecret)
-
-	userID := uint(123)
-	tokenString, err := service.GenerateToken(userID)
-
-	if err != nil {
-		t.Fatalf("生成令牌失败: %v", err)
-	}
-
-	if tokenString == "" {
-		t.Fatal("生成的令牌字符串为空")
-	}
-
-	// 解析 token 以确保其有效性及声明
-	claims, err := service.ParseToken(tokenString)
-	if err != nil {
-		t.Fatalf("生成后解析令牌失败: %v", err)
-	}
-
-	if claims.UserID != userID {
-		t.Errorf("期望用户ID %d, 实际为 %d", userID, claims.UserID)
-	}
-
-	// 检查 token 是否未过期 (在合理范围内)
-	if claims.ExpiresAt == nil || claims.ExpiresAt.Time.Before(time.Now().Add(-time.Minute)) {
-		t.Errorf("令牌过期时间无效或已过期")
-	}
-
-	if claims.Issuer != "pig-farm-controller" {
-		t.Errorf("期望签发者 \"pig-farm-controller\", 实际为 \"%s\"", claims.Issuer)
-	}
-}
-
-func TestParseToken(t *testing.T) {
-	// 使用两个不同的测试密钥
-	correctSecret := []byte("the_correct_secret")
-	wrongSecret := []byte("a_very_wrong_secret")
-
-	serviceWithCorrectKey := token.NewTokenService(correctSecret)
-	serviceWithWrongKey := token.NewTokenService(wrongSecret)
-
-	userID := uint(456)
-
-	// 1. 生成一个有效的 token
-	validToken, err := serviceWithCorrectKey.GenerateToken(userID)
-	if err != nil {
-		t.Fatalf("为解析测试生成有效令牌失败: %v", err)
-	}
-
-	// 测试用例 1: 使用正确的密钥成功解析
-	claims, err := serviceWithCorrectKey.ParseToken(validToken)
-	if err != nil {
-		t.Errorf("使用正确密钥解析有效令牌失败: %v", err)
-	}
-	if claims.UserID != userID {
-		t.Errorf("解析有效令牌时期望用户ID %d, 实际为 %d", userID, claims.UserID)
-	}
-
-	// 测试用例 2: 无效 token (例如, 格式错误的字符串)
-	invalidTokenString := "this.is.not.a.valid.jwt"
-	_, err = serviceWithCorrectKey.ParseToken(invalidTokenString)
-	if err == nil {
-		t.Error("解析格式错误的令牌意外成功")
-	}
-
-	// 测试用C:\Users\divano\Desktop\work\AA-Pig\pig-farm-controller\internal\infra\repository\plan_repository_test.go例 3: 过期 token
-	expiredClaims := token.Claims{
-		UserID: userID,
-		RegisteredClaims: jwt.RegisteredClaims{
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(-time.Hour)), // 1 小时前
-			Issuer:    "pig-farm-controller",
-		},
-	}
-	expiredTokenClaims := jwt.NewWithClaims(jwt.SigningMethodHS256, expiredClaims)
-	expiredTokenString, err := expiredTokenClaims.SignedString(correctSecret)
-	if err != nil {
-		t.Fatalf("生成过期令牌失败: %v", err)
-	}
-	_, err = serviceWithCorrectKey.ParseToken(expiredTokenString)
-	if err == nil {
-		t.Error("解析过期令牌意外成功")
-	}
-
-	// 新增测试用例 4: 使用错误的密钥解析
-	_, err = serviceWithWrongKey.ParseToken(validToken)
-	if err == nil {
-		t.Error("使用错误密钥解析令牌意外成功")
-	}
-	// 我们可以更精确地检查错误类型，以确保它是签名错误
-	if !errors.Is(err, jwt.ErrTokenSignatureInvalid) {
-		t.Errorf("期望得到签名无效错误 (ErrTokenSignatureInvalid)，但得到了: %v", err)
-	}
-}

internal/infra/config/config.go

@@ -35,6 +35,18 @@ type Config struct {
 
 	// TaskConfig 任务调度配置
 	Task TaskConfig `yaml:"task"`
+
+	// Lora Lora配置
+	Lora LoraConfig `yaml:"lora"`
+
+	// LoraMesh LoraMesh配置
+	LoraMesh LoraMeshConfig `yaml:"lora_mesh"`
+
+	// Notify 通知服务配置
+	Notify NotifyConfig `yaml:"notify"`
+
+	// Collection 定时采集配置
+	Collection CollectionConfig `yaml:"collection"`
 }
 
 // AppConfig 代表应用基础配置
@@ -130,10 +142,76 @@ type TaskConfig struct {
 	NumWorkers int `yaml:"num_workers"`
 }
 
+type LoraMode string
+
+const (
+	LoraMode_LoRaWAN  LoraMode = "lora_wan"
+	LoraMode_LoRaMesh LoraMode = "lora_mesh"
+)
+
+// LoraConfig 代表Lora配置
+type LoraConfig struct {
+	Mode LoraMode `yaml:"mode"`
+}
+
+// LoraMeshConfig 代表Lora Mesh配置
+type LoraMeshConfig struct {
+	UARTPort          string `yaml:"uart_port"`
+	BaudRate          int    `yaml:"baud_rate"`
+	Timeout           int    `yaml:"timeout"`
+	LoraMeshMode      string `yaml:"lora_mesh_mode"`
+	MaxChunkSize      int    `yaml:"max_chunk_size"`
+	ReassemblyTimeout int    `yaml:"reassembly_timeout"`
+}
+
+// NotifyConfig 包含了所有与通知服务相关的配置
+type NotifyConfig struct {
+	Primary          string       `yaml:"primary"`          // 首选通知渠道 (e.g., "邮件", "企业微信", "飞书", "日志")
+	FailureThreshold int          `yaml:"failureThreshold"` // 连续失败多少次后触发广播模式
+	SMTP             SMTPConfig   `yaml:"smtp"`
+	WeChat           WeChatConfig `yaml:"wechat"`
+	Lark             LarkConfig   `yaml:"lark"`
+}
+
+// SMTPConfig SMTP邮件配置
+type SMTPConfig struct {
+	Enabled  bool   `yaml:"enabled"`
+	Host     string `yaml:"host"`
+	Port     int    `yaml:"port"`
+	Username string `yaml:"username"`
+	Password string `yaml:"password"`
+	Sender   string `yaml:"sender"`
+}
+
+// WeChatConfig 企业微信应用配置
+type WeChatConfig struct {
+	Enabled bool   `yaml:"enabled"`
+	CorpID  string `yaml:"corpID"`
+	AgentID string `yaml:"agentID"`
+	Secret  string `yaml:"secret"`
+}
+
+// LarkConfig 飞书应用配置
+type LarkConfig struct {
+	Enabled   bool   `yaml:"enabled"`
+	AppID     string `yaml:"appID"`
+	AppSecret string `yaml:"appSecret"`
+}
+
+// CollectionConfig 代表定时采集配置
+type CollectionConfig struct {
+	// Interval 采集间隔(分钟), 默认 1
+	Interval int `yaml:"interval"`
+}
+
 // NewConfig 创建并返回一个新的配置实例
 func NewConfig() *Config {
 	// 默认值可以在这里设置，但我们优先使用配置文件中的值
-	return &Config{}
+	return &Config{
+		Collection: CollectionConfig{
+			Interval: 1, // 默认为1分钟
+		},
+	}
 }
 
 // Load 从指定路径加载配置文件

internal/infra/database/postgres.go

@@ -171,18 +171,19 @@ func (ps *PostgresStorage) creatingHyperTable() error {
 		{models.PigSickLog{}, "happened_at"},
 		{models.PigPurchase{}, "purchase_date"},
 		{models.PigSale{}, "sale_date"},
+		{models.Notification{}, "alarm_timestamp"},
 	}
 
 	for _, table := range tablesToConvert {
 		tableName := table.model.TableName()
 		chunkInterval := "1 days" // 统一设置为1天
-		ps.logger.Infow("准备将表转换为超表", "table", tableName, "chunk_interval", chunkInterval)
+		ps.logger.Debugw("准备将表转换为超表", "table", tableName, "chunk_interval", chunkInterval)
 		sql := fmt.Sprintf("SELECT create_hypertable('%s', '%s', chunk_time_interval => INTERVAL '%s', if_not_exists => TRUE);", tableName, table.timeColumn, chunkInterval)
 		if err := ps.db.Exec(sql).Error; err != nil {
 			ps.logger.Errorw("转换为超表失败", "table", tableName, "error", err)
 			return fmt.Errorf("将 %s 转换为超表失败: %w", tableName, err)
 		}
-		ps.logger.Infow("成功将表转换为超表 (或已转换)", "table", tableName)
+		ps.logger.Debugw("成功将表转换为超表 (或已转换)", "table", tableName)
 	}
 
 	return nil
@@ -211,6 +212,7 @@ func (ps *PostgresStorage) applyCompressionPolicies() error {
 		{models.PigSickLog{}, "pig_batch_id"},
 		{models.PigPurchase{}, "pig_batch_id"},
 		{models.PigSale{}, "pig_batch_id"},
+		{models.Notification{}, "user_id"},
 	}
 
 	for _, policy := range policies {
@@ -218,21 +220,23 @@ func (ps *PostgresStorage) applyCompressionPolicies() error {
 		compressAfter := "3 days" // 统一设置为2天后（即进入第3天）开始压缩
 
 		// 1. 开启表的压缩设置，并指定分段列
-		ps.logger.Infow("为表启用压缩设置", "table", tableName, "segment_by", policy.segmentColumn)
-		alterSQL := fmt.Sprintf("ALTER TABLE %s SET (timescaledb.compress, timescaledb.compress_segmentby = '%s');", tableName, policy.segmentColumn)
+		ps.logger.Debugw("为表启用压缩设置", "table", tableName, "segment_by", policy.segmentColumn)
+		// 使用 + 而非Sprintf以规避goland静态检查报错
+		alterSQL := "ALTER TABLE" + " " + tableName + " SET (timescaledb.compress, timescaledb.compress_segmentby = '" + policy.segmentColumn + "');"
 		if err := ps.db.Exec(alterSQL).Error; err != nil {
 			// 忽略错误，因为这个设置可能是不可变的，重复执行会报错
 			ps.logger.Warnw("启用压缩设置时遇到问题 (可能已设置，可忽略)", "table", tableName, "error", err)
 		}
+		ps.logger.Debugw("成功为表启用压缩设置 (或已启用)", "table", tableName)
 
 		// 2. 添加压缩策略
-		ps.logger.Infow("为表添加压缩策略", "table", tableName, "compress_after", compressAfter)
+		ps.logger.Debugw("为表添加压缩策略", "table", tableName, "compress_after", compressAfter)
 		policySQL := fmt.Sprintf("SELECT add_compression_policy('%s', INTERVAL '%s', if_not_exists => TRUE);", tableName, compressAfter)
 		if err := ps.db.Exec(policySQL).Error; err != nil {
 			ps.logger.Errorw("添加压缩策略失败", "table", tableName, "error", err)
 			return fmt.Errorf("为 %s 添加压缩策略失败: %w", tableName, err)
 		}
-		ps.logger.Infow("成功为表添加压缩策略 (或已存在)", "table", tableName)
+		ps.logger.Debugw("成功为表添加压缩策略 (或已存在)", "table", tableName)
 	}
 
 	return nil
@@ -244,22 +248,22 @@ func (ps *PostgresStorage) creatingIndex() error {
 	// 如果索引已存在，此命令不会报错
 
 	// 为 sensor_data 表的 data 字段创建 GIN 索引
-	ps.logger.Info("正在为 sensor_data 表的 data 字段创建 GIN 索引")
+	ps.logger.Debug("正在为 sensor_data 表的 data 字段创建 GIN 索引")
 	ginSensorDataIndexSQL := "CREATE INDEX IF NOT EXISTS idx_sensor_data_data_gin ON sensor_data USING GIN (data);"
 	if err := ps.db.Exec(ginSensorDataIndexSQL).Error; err != nil {
 		ps.logger.Errorw("为 sensor_data 的 data 字段创建 GIN 索引失败", "error", err)
 		return fmt.Errorf("为 sensor_data 的 data 字段创建 GIN 索引失败: %w", err)
 	}
-	ps.logger.Info("成功为 sensor_data 的 data 字段创建 GIN 索引 (或已存在)")
+	ps.logger.Debug("成功为 sensor_data 的 data 字段创建 GIN 索引 (或已存在)")
 
 	// 为 tasks.parameters 创建 GIN 索引
-	ps.logger.Info("正在为 tasks 表的 parameters 字段创建 GIN 索引")
+	ps.logger.Debug("正在为 tasks 表的 parameters 字段创建 GIN 索引")
 	taskGinIndexSQL := "CREATE INDEX IF NOT EXISTS idx_tasks_parameters_gin ON tasks USING GIN (parameters);"
 	if err := ps.db.Exec(taskGinIndexSQL).Error; err != nil {
 		ps.logger.Errorw("为 tasks 的 parameters 字段创建 GIN 索引失败", "error", err)
 		return fmt.Errorf("为 tasks 的 parameters 字段创建 GIN 索引失败: %w", err)
 	}
-	ps.logger.Info("成功为 tasks 的 parameters 字段创建 GIN 索引 (或已存在)")
+	ps.logger.Debug("成功为 tasks 的 parameters 字段创建 GIN 索引 (或已存在)")
 
 	return nil
 }

internal/infra/logs/logs_test.go

@@ -1,166 +0,0 @@
-package logs_test
-
-import (
-	"bytes"
-	"context"
-	"encoding/json"
-	"errors"
-	"strings"
-	"testing"
-	"time"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/config"
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
-	"github.com/stretchr/testify/assert"
-	"go.uber.org/zap"
-	"go.uber.org/zap/zapcore"
-)
-
-// captureOutput 是一个辅助函数，用于捕获 logger 的输出到内存缓冲区
-func captureOutput(cfg config.LogConfig) (*logs.Logger, *bytes.Buffer) {
-	var buf bytes.Buffer
-
-	encoder := logs.GetEncoder(cfg.Format)
-
-	writer := zapcore.AddSync(&buf)
-
-	level := zap.NewAtomicLevel()
-	_ = level.UnmarshalText([]byte(cfg.Level))
-
-	core := zapcore.NewCore(encoder, writer, level)
-	// 匹配 logs.go 中 NewLogger 的行为，添加调用者信息
-	zapLogger := zap.New(core, zap.AddCaller(), zap.AddCallerSkip(1))
-
-	logger := &logs.Logger{SugaredLogger: zapLogger.Sugar()}
-	return logger, &buf
-}
-func TestNewLogger(t *testing.T) {
-	t.Run("日志级别应生效", func(t *testing.T) {
-		// 1. 创建一个级别为 WARN 的 logger
-		logger, buf := captureOutput(config.LogConfig{Level: "warn", Format: "console"})
-
-		// 2. 调用不同级别的日志方法
-		logger.Info("这条 info 日志不应被打印")
-		logger.Warn("这条 warn 日志应该被打印")
-
-		// 3. 断言输出
-		output := buf.String()
-		assert.NotContains(t, output, "这条 info 日志不应被打印")
-		assert.Contains(t, output, "这条 warn 日志应该被打印")
-	})
-
-	t.Run("JSON 格式应生效", func(t *testing.T) {
-		// 1. 创建一个格式为 JSON 的 logger
-		logger, buf := captureOutput(config.LogConfig{Level: "info", Format: "json"})
-
-		// 2. 打印一条日志
-		logger.Info("测试json输出")
-
-		// 3. 断言输出
-		output := buf.String()
-		// 验证它是否是合法的 JSON，并且包含预期的键值对
-		var logEntry map[string]interface{}
-		// 注意：由于日志库可能会在行尾添加换行符，我们先 trim space
-		err := json.Unmarshal([]byte(strings.TrimSpace(output)), &logEntry)
-		assert.NoError(t, err, "日志输出应为合法的JSON")
-		assert.Equal(t, "INFO", logEntry["level"])
-		assert.Equal(t, "测试json输出", logEntry["msg"])
-	})
-
-	t.Run("文件日志构造函数不应 panic", func(t *testing.T) {
-		// 这个测试保持原样，只验证构造函数在启用文件时不会崩溃
-		// 注意：我们不在单元测试中实际写入文件
-		cfgFile := config.LogConfig{
-			Level:      "info",
-			EnableFile: true,
-			FilePath:   "test.log", // 在测试环境中，这个文件不会被真正创建
-		}
-		assert.NotPanics(t, func() { logs.NewLogger(cfgFile) })
-	})
-}
-
-func TestLogger_Write_ForGin(t *testing.T) {
-	logger, buf := captureOutput(config.LogConfig{Level: "info"})
-
-	ginLog := "[GIN-debug] Listening and serving HTTP on :8080\n"
-	_, err := logger.Write([]byte(ginLog))
-
-	assert.NoError(t, err)
-	output := buf.String()
-	// logger.Write 会将 gin 的日志转为 info 级别
-	assert.Contains(t, output, "INFO")
-	assert.Contains(t, output, strings.TrimSpace(ginLog))
-}
-
-func TestGormLogger(t *testing.T) {
-	logger, buf := captureOutput(config.LogConfig{Level: "debug"}) // 设置为 debug 以捕获所有级别
-	gormLogger := logs.NewGormLogger(logger)
-
-	// 模拟 GORM 的 Trace 调用参数
-	ctx := context.Background()
-	sql := "SELECT * FROM users WHERE id = 1"
-	rows := int64(1)
-	fc := func() (string, int64) {
-		return sql, rows
-	}
-
-	t.Run("慢查询应记录为警告", func(t *testing.T) {
-		buf.Reset()
-		// 模拟一个耗时超过 200ms 的查询
-		begin := time.Now().Add(-300 * time.Millisecond)
-		gormLogger.Trace(ctx, begin, fc, nil)
-
-		output := buf.String()
-		assert.Contains(t, output, "WARN", "应包含 WARN 级别")
-		assert.Contains(t, output, "[GORM] slow query", "应包含慢查询信息")
-		assert.Contains(t, output, "SELECT * FROM users WHERE id = 1", "应包含 SQL 语句")
-	})
-
-	t.Run("普通错误应记录为Error", func(t *testing.T) {
-		buf.Reset()
-		queryError := errors.New("syntax error")
-		gormLogger.Trace(ctx, time.Now(), fc, queryError)
-
-		output := buf.String()
-		assert.Contains(t, output, "ERROR")
-		assert.Contains(t, output, "[GORM] error: syntax error")
-	})
-
-	t.Run("当SkipErrRecordNotFound为true时应跳过RecordNotFound错误", func(t *testing.T) {
-		buf.Reset()
-		// 确保默认设置是 true
-		gormLogger.SkipErrRecordNotFound = true
-		// 错误必须包含 "record not found" 字符串以匹配 logs.go 中的判断逻辑
-		queryError := errors.New("record not found")
-		gormLogger.Trace(ctx, time.Now(), fc, queryError)
-
-		assert.Empty(t, buf.String(), "开启 SkipErrRecordNotFound 后，record not found 错误不应产生任何日志")
-	})
-
-	t.Run("当SkipErrRecordNotFound为false时应记录RecordNotFound错误", func(t *testing.T) {
-		buf.Reset()
-		// 手动将 SkipErrRecordNotFound 设置为 false
-		gormLogger.SkipErrRecordNotFound = false
-
-		queryError := errors.New("record not found")
-		gormLogger.Trace(ctx, time.Now(), fc, queryError)
-
-		// 恢复设置，避免影响其他测试
-		gormLogger.SkipErrRecordNotFound = true
-
-		output := buf.String()
-		assert.NotEmpty(t, output, "关闭 SkipErrRecordNotFound 后，record not found 错误应该产生日志")
-		assert.Contains(t, output, "ERROR")
-		assert.Contains(t, output, "[GORM] error: record not found")
-	})
-
-	t.Run("正常查询应记录为Debug", func(t *testing.T) {
-		buf.Reset()
-		// 模拟一个快速查询
-		gormLogger.Trace(ctx, time.Now(), fc, nil)
-
-		output := buf.String()
-		assert.Contains(t, output, "DEBUG") // 正常查询是 Debug 级别
-		assert.Contains(t, output, "[GORM] trace")
-	})
-}

internal/infra/models/device.go

@@ -77,6 +77,9 @@ type Device struct {
 	// Properties 用于存储特定类型设备的独有属性，采用JSON格式。
 	// 建议在应用层为不同子类型的设备定义专用的属性结构体，以保证数据一致性。
 	Properties datatypes.JSON `json:"properties"`
+
+	// Tasks 是与此设备关联的任务列表，通过 DeviceTask 关联表实现多对多关系
+	Tasks []Task `gorm:"many2many:device_tasks;" json:"tasks"`
 }
 
 // SelfCheck 对 Device 的关键字段和属性进行业务逻辑验证。

internal/infra/models/device_template.go

@@ -32,9 +32,9 @@ type ValueDescriptor struct {
 
 // SwitchCommands 定义了开关类指令所需的Modbus参数
 type SwitchCommands struct {
-	// ModbusStartAddress 记录Modbus寄存器的起始地址，用于生成指令。
+	// ModbusStartAddress 记录Modbus寄存器的起始地址，用于生成指令。(一般是第三到四字节)
 	ModbusStartAddress uint16 `json:"modbus_start_address"`
-	// ModbusQuantity 记录Modbus寄存器的数量，对于开关通常为1。
+	// ModbusQuantity 记录Modbus寄存器的数量，对于开关通常为1。(一般是五到六字节)
 	ModbusQuantity uint16 `json:"modbus_quantity"`
 }
 
@@ -49,11 +49,11 @@ func (sc *SwitchCommands) SelfCheck() error {
 
 // SensorCommands 定义了传感器读取指令所需的Modbus参数
 type SensorCommands struct {
-	// ModbusFunctionCode 记录Modbus功能码，例如 ReadHoldingRegisters。
+	// ModbusFunctionCode 记录Modbus功能码，例如 ReadHoldingRegisters。(一般是第二字节)
 	ModbusFunctionCode command_generater.ModbusFunctionCode `json:"modbus_function_code"`
-	// ModbusStartAddress 记录Modbus寄存器的起始地址，用于生成指令。
+	// ModbusStartAddress 记录Modbus寄存器的起始地址，用于生成指令。(一般是第三到四字节)
 	ModbusStartAddress uint16 `json:"modbus_start_address"`
-	// ModbusQuantity 记录Modbus寄存器的数量，用于生成指令。
+	// ModbusQuantity 记录Modbus寄存器的数量，用于生成指令。(一般是五到六字节)
 	ModbusQuantity uint16 `json:"modbus_quantity"`
 }
 

internal/infra/models/execution.go

@@ -171,7 +171,10 @@ const (
 	ContextAuditActionType     AuditContextKey = "auditActionType"
 	ContextAuditTargetResource AuditContextKey = "auditTargetResource"
 	ContextAuditDescription    AuditContextKey = "auditDescription"
-	ContextUserKey             AuditContextKey = "user"
+	ContextAuditStatus         AuditContextKey = "auditStatus"
+	ContextAuditResultDetails  AuditContextKey = "auditResultDetails"
+
+	ContextUserKey AuditContextKey = "user"
 )
 
 func (a AuditContextKey) String() string {

internal/infra/models/models.go

@@ -22,6 +22,7 @@ func GetAllModels() []interface{} {
 		&DeviceTemplate{},
 		&SensorData{},
 		&DeviceCommandLog{},
+		&DeviceTask{},
 
 		// Plan & Task Models
 		&Plan{},
@@ -59,6 +60,9 @@ func GetAllModels() []interface{} {
 		// Medication Models
 		&Medication{},
 		&MedicationLog{},
+
+		// Notification Models
+		&Notification{},
 	}
 }
 

internal/infra/models/notify.go

@@ -0,0 +1,77 @@
+package models
+
+import (
+	"database/sql/driver"
+	"errors"
+	"time"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/notify"
+	"go.uber.org/zap/zapcore"
+	"gorm.io/gorm"
+)
+
+// NotificationStatus 定义了通知发送尝试的状态枚举。
+type NotificationStatus string
+
+const (
+	NotificationStatusSuccess NotificationStatus = "发送成功" // 通知已成功发送
+	NotificationStatusFailed  NotificationStatus = "发送失败" // 通知发送失败
+	NotificationStatusSkipped NotificationStatus = "已跳过"  // 通知因某些原因被跳过（例如：用户未配置联系方式）
+)
+
+// LogLevel is a custom type for zapcore.Level to handle database scanning and valuing.
+type LogLevel zapcore.Level
+
+// Scan implements the sql.Scanner interface.
+func (l *LogLevel) Scan(value interface{}) error {
+	var s string
+	switch v := value.(type) {
+	case []byte:
+		s = string(v)
+	case string:
+		s = v
+	default:
+		return errors.New("LogLevel的类型无效")
+	}
+
+	var zl zapcore.Level
+	if err := zl.UnmarshalText([]byte(s)); err != nil {
+		return err
+	}
+	*l = LogLevel(zl)
+	return nil
+}
+
+// Value implements the driver.Valuer interface.
+func (l LogLevel) Value() (driver.Value, error) {
+	return (zapcore.Level)(l).String(), nil
+}
+
+// Notification 表示已发送或尝试发送的通知记录。
+type Notification struct {
+	gorm.Model
+
+	// NotifierType 通知器类型 (例如："邮件", "企业微信", "飞书", "日志")
+	NotifierType notify.NotifierType `gorm:"type:varchar(20);not null;index" json:"notifier_type"`
+	// UserID 接收通知的用户ID，用于追溯通知记录到特定用户
+	UserID uint `gorm:"index" json:"user_id"` // 增加 UserID 字段，并添加索引
+	// Title 通知标题
+	Title string `gorm:"type:varchar(255);not null" json:"title"`
+	// Message 通知内容
+	Message string `gorm:"type:text;not null" json:"message"`
+	// Level 通知级别 (例如：INFO, WARN, ERROR)
+	Level LogLevel `gorm:"type:varchar(10);not null" json:"level"`
+	// AlarmTimestamp 通知内容生成时的时间戳，与 ID 构成复合主键
+	AlarmTimestamp time.Time `gorm:"primaryKey;not null" json:"alarm_timestamp"`
+	// ToAddress 接收地址 (例如：邮箱地址, 企业微信ID, 日志标识符)
+	ToAddress string `gorm:"type:varchar(255);not null" json:"to_address"`
+	// Status 通知发送尝试的状态 (例如："待发送", "发送成功", "发送失败", "已跳过")
+	Status NotificationStatus `gorm:"type:varchar(20);not null;default:'待发送'" json:"status"`
+	// ErrorMessage 如果通知发送失败，此字段存储错误信息
+	ErrorMessage string `gorm:"type:text" json:"error_message"`
+}
+
+// TableName 指定 Notification 模型的表名。
+func (Notification) TableName() string {
+	return "notifications"
+}

internal/infra/models/pig_transfer.go

@@ -14,7 +14,7 @@ const (
 	PigTransferTypeCrossBatch           PigTransferType = "跨群调栏" // 不同猪群间的调动
 	PigTransferTypeSale                 PigTransferType = "销售"   // 猪只售出
 	PigTransferTypeDeath                PigTransferType = "死亡"   // 猪只死亡
-	PigTransferTypeEliminate            PigTransferType = "淘汰"   // 猪只淘汰
+	PigTransferTypeCull                 PigTransferType = "淘汰"   // 猪只淘汰
 	PigTransferTypePurchase             PigTransferType = "新购入"  // 新购入猪只
 	PigTransferTypeDeliveryRoomTransfor PigTransferType = "产房转入" // 产房转入
 	// 可以根据业务需求添加更多类型，例如：转出到其他农场等

internal/infra/models/plan.go

@@ -34,6 +34,7 @@ const (
 	TaskPlanAnalysis          TaskType = "计划分析" // 解析Plan的Task列表并添加到待执行队列的特殊任务
 	TaskTypeWaiting           TaskType = "等待"   // 等待任务
 	TaskTypeReleaseFeedWeight TaskType = "下料"   // 下料口释放指定重量任务
+	TaskTypeFullCollection    TaskType = "全量采集" // 新增的全量采集任务
 )
 
 // -- Task Parameters --
@@ -52,12 +53,20 @@ const (
 	PlanStatusFailed   PlanStatus = "执行失败" // 执行失败
 )
 
+type PlanType string
+
+const (
+	PlanTypeCustom PlanType = "自定义任务"
+	PlanTypeSystem PlanType = "系统任务"
+)
+
 // Plan 代表系统中的一个计划，可以包含子计划或任务
 type Plan struct {
 	gorm.Model
 
 	Name          string            `gorm:"not null" json:"name"`
 	Description   string            `json:"description"`
+	PlanType      PlanType          `gorm:"not null;index" json:"plan_type"` // 任务类型, 包括系统任务和用户自定义任务
 	ExecutionType PlanExecutionType `gorm:"not null;index" json:"execution_type"`
 	Status        PlanStatus        `gorm:"default:'已禁用';index" json:"status"` // 计划是否被启动
 	ExecuteNum    uint              `gorm:"default:0" json:"execute_num"`      // 计划预期执行次数
@@ -169,6 +178,9 @@ type Task struct {
 	ExecutionOrder int            `gorm:"not null" json:"execution_order"` // 在计划中的执行顺序
 	Type           TaskType       `gorm:"not null" json:"type"`            // 任务的类型，对应 task 包中的具体动作
 	Parameters     datatypes.JSON `json:"parameters"`                      // 任务特定参数的JSON (例如: 设备ID, 值)
+
+	// Devices 是与此任务关联的设备列表，通过 DeviceTask 关联表实现多对多关系
+	Devices []Device `gorm:"many2many:device_tasks;" json:"devices"`
 }
 
 // TableName 自定义 GORM 使用的数据库表名
@@ -188,3 +200,18 @@ func (t Task) ParseParameters(v interface{}) error {
 	}
 	return json.Unmarshal(t.Parameters, v)
 }
+
+// DeviceTask 是设备和任务之间的关联模型，表示一个设备可以执行多个任务，一个任务可以被多个设备执行。
+type DeviceTask struct {
+	gorm.Model
+	DeviceID uint `gorm:"not null;index"` // 设备ID
+	TaskID   uint `gorm:"not null;index"` // 任务ID
+
+	// 可选：如果需要存储关联的额外信息，可以在这里添加字段，例如：
+	// Configuration datatypes.JSON `json:"configuration"` // 任务在特定设备上的配置
+}
+
+// TableName 自定义 GORM 使用的数据库表名
+func (DeviceTask) TableName() string {
+	return "device_tasks"
+}

internal/infra/models/plan_test.go

@@ -1,202 +0,0 @@
-package models_test
-
-import (
-	"sort"
-	"testing"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"github.com/stretchr/testify/assert"
-)
-
-func TestPlan_ReorderSteps(t *testing.T) {
-	type testCase struct {
-		name           string
-		initialPlan    *models.Plan
-		expectedOrders []int
-	}
-
-	testCases := []testCase{
-		// --- Test Cases for Tasks ---
-		{
-			name: "Tasks: 完美顺序",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeTasks,
-				Tasks: []models.Task{
-					{ExecutionOrder: 1},
-					{ExecutionOrder: 2},
-					{ExecutionOrder: 3},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "Tasks: 有间断",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeTasks,
-				Tasks: []models.Task{
-					{ExecutionOrder: 1},
-					{ExecutionOrder: 3},
-					{ExecutionOrder: 5},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "Tasks: 从0开始",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeTasks,
-				Tasks: []models.Task{
-					{ExecutionOrder: 0},
-					{ExecutionOrder: 1},
-					{ExecutionOrder: 2},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "Tasks: 完全无序",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeTasks,
-				Tasks: []models.Task{
-					{ExecutionOrder: 8},
-					{ExecutionOrder: 2},
-					{ExecutionOrder: 4},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "Tasks: 包含负数",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeTasks,
-				Tasks: []models.Task{
-					{ExecutionOrder: -5},
-					{ExecutionOrder: 10},
-					{ExecutionOrder: 2},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "Tasks: 空切片",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeTasks,
-				Tasks:       []models.Task{},
-			},
-			expectedOrders: []int{},
-		},
-		{
-			name: "Tasks: 单个元素",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeTasks,
-				Tasks: []models.Task{
-					{ExecutionOrder: 100},
-				},
-			},
-			expectedOrders: []int{1},
-		},
-		// --- Test Cases for SubPlans ---
-		{
-			name: "SubPlans: 完美顺序",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeSubPlans,
-				SubPlans: []models.SubPlan{
-					{ExecutionOrder: 1},
-					{ExecutionOrder: 2},
-					{ExecutionOrder: 3},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "SubPlans: 有间断",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeSubPlans,
-				SubPlans: []models.SubPlan{
-					{ExecutionOrder: 1},
-					{ExecutionOrder: 3},
-					{ExecutionOrder: 5},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "SubPlans: 从0开始",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeSubPlans,
-				SubPlans: []models.SubPlan{
-					{ExecutionOrder: 0},
-					{ExecutionOrder: 1},
-					{ExecutionOrder: 2},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "SubPlans: 完全无序",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeSubPlans,
-				SubPlans: []models.SubPlan{
-					{ExecutionOrder: 8},
-					{ExecutionOrder: 2},
-					{ExecutionOrder: 4},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "SubPlans: 包含负数",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeSubPlans,
-				SubPlans: []models.SubPlan{
-					{ExecutionOrder: -5},
-					{ExecutionOrder: 10},
-					{ExecutionOrder: 2},
-				},
-			},
-			expectedOrders: []int{1, 2, 3},
-		},
-		{
-			name: "SubPlans: 空切片",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeSubPlans,
-				SubPlans:    []models.SubPlan{},
-			},
-			expectedOrders: []int{},
-		},
-		{
-			name: "SubPlans: 单个元素",
-			initialPlan: &models.Plan{
-				ContentType: models.PlanContentTypeSubPlans,
-				SubPlans: []models.SubPlan{
-					{ExecutionOrder: 100},
-				},
-			},
-			expectedOrders: []int{1},
-		},
-	}
-
-	for _, tc := range testCases {
-		t.Run(tc.name, func(t *testing.T) {
-			// 调用被测试的方法
-			tc.initialPlan.ReorderSteps()
-
-			// 提取并验证最终的顺序
-			finalOrders := make([]int, 0)
-			if tc.initialPlan.ContentType == models.PlanContentTypeTasks {
-				for _, task := range tc.initialPlan.Tasks {
-					finalOrders = append(finalOrders, task.ExecutionOrder)
-				}
-			} else if tc.initialPlan.ContentType == models.PlanContentTypeSubPlans {
-				for _, subPlan := range tc.initialPlan.SubPlans {
-					finalOrders = append(finalOrders, subPlan.ExecutionOrder)
-				}
-			}
-
-			// 对 finalOrders 进行排序，以确保比较的一致性，因为 ReorderSteps 后的顺序是固定的
-			sort.Ints(finalOrders)
-
-			assert.Equal(t, tc.expectedOrders, finalOrders, "The final execution orders should be a continuous sequence starting from 1.")
-		})
-	}
-}

internal/infra/models/user_test.go

@@ -1,74 +0,0 @@
-// Package models_test 包含对 models 包的单元测试
-package models_test
-
-import (
-	"testing"
-
-	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
-	"github.com/stretchr/testify/assert"
-	"golang.org/x/crypto/bcrypt"
-)
-
-func TestUser_CheckPassword(t *testing.T) {
-	plainPassword := "my-secret-password"
-
-	// 1. 生成一个密码哈希用于测试
-	hashedPassword, err := bcrypt.GenerateFromPassword([]byte(plainPassword), bcrypt.DefaultCost)
-	assert.NoError(t, err, "生成密码哈希不应出错")
-
-	user := &models.User{
-		Password: string(hashedPassword),
-	}
-
-	t.Run("密码正确", func(t *testing.T) {
-		// 2. 使用正确的明文密码进行校验
-		match := user.CheckPassword(plainPassword)
-		assert.True(t, match, "正确的密码应该校验通过")
-	})
-
-	t.Run("密码错误", func(t *testing.T) {
-		// 3. 使用错误的明文密码进行校验
-		match := user.CheckPassword("wrong-password")
-		assert.False(t, match, "错误的密码应该校验失败")
-	})
-
-	t.Run("空密码", func(t *testing.T) {
-		// 4. 使用空字符串作为密码进行校验
-		match := user.CheckPassword("")
-		assert.False(t, match, "空密码应该校验失败")
-	})
-}
-func TestUser_BeforeCreate(t *testing.T) {
-	t.Run("密码应被成功哈希", func(t *testing.T) {
-		plainPassword := "securepassword123"
-		user := &models.User{
-			Username: "testuser",
-			Password: plainPassword,
-		}
-
-		// 模拟 GORM 钩子调用
-		err := user.BeforeCreate(nil) // GORM 钩子通常接收 *gorm.DB，这里我们传入 nil，因为 BeforeCreate 不依赖 DB
-		assert.NoError(t, err, "BeforeCreate 不应返回错误")
-
-		// 验证密码是否已被哈希（不再是明文）
-		assert.NotEqual(t, plainPassword, user.Password, "密码应已被哈希")
-
-		// 验证哈希后的密码是否能被正确校验
-		assert.True(t, user.CheckPassword(plainPassword), "哈希后的密码应能通过校验")
-	})
-
-	t.Run("空密码不应被哈希", func(t *testing.T) {
-		plainPassword := ""
-		user := &models.User{
-			Username: "empty_pass_user",
-			Password: plainPassword,
-		}
-
-		// 模拟 GORM 钩子调用
-		err := user.BeforeCreate(nil)
-		assert.NoError(t, err, "BeforeCreate 不应返回错误")
-
-		// 验证密码仍然是空字符串
-		assert.Equal(t, plainPassword, user.Password, "空密码不应被哈希")
-	})
-}

internal/infra/notify/lark.go

@@ -0,0 +1,193 @@
+package notify
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"sync"
+	"time"
+)
+
+const (
+	// 飞书获取 tenant_access_token 的 API 地址
+	larkGetTokenURL = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
+	// 飞书发送消息的 API 地址
+	larkSendMessageURL = "https://open.feishu.cn/open-apis/im/v1/messages"
+)
+
+// larkNotifier 实现了 Notifier 接口，用于通过飞书自建应用发送私聊消息。
+type larkNotifier struct {
+	appID     string // 应用 ID
+	appSecret string // 应用密钥
+
+	// 用于线程安全地管理 tenant_access_token
+	mu             sync.Mutex
+	accessToken    string
+	tokenExpiresAt time.Time
+}
+
+// NewLarkNotifier 创建一个新的 larkNotifier 实例。
+// 调用者需要注入飞书应用的 AppID 和 AppSecret。
+func NewLarkNotifier(appID, appSecret string) Notifier {
+	return &larkNotifier{
+		appID:     appID,
+		appSecret: appSecret,
+	}
+}
+
+// Send 向指定用户发送一条飞书消息卡片。
+// toAddr 参数是接收者的邮箱地址。
+func (l *larkNotifier) Send(content AlarmContent, toAddr string) error {
+	// 1. 获取有效的 tenant_access_token
+	token, err := l.getAccessToken()
+	if err != nil {
+		return err
+	}
+
+	// 2. 构建消息卡片 JSON
+	// 飞书消息卡片结构复杂，这里构建一个简单的 Markdown 文本卡片
+	cardContent := map[string]interface{}{
+		"config": map[string]bool{
+			"wide_screen_mode": true,
+		},
+		"elements": []map[string]interface{}{
+			{
+				"tag": "div",
+				"text": map[string]string{
+					"tag": "lark_md",
+					"content": fmt.Sprintf("## %s\n**级别**: %s\n**时间**: %s\n\n%s",
+						content.Title,
+						content.Level.String(),
+						content.Timestamp.Format(DefaultTimeFormat),
+						content.Message,
+					),
+				},
+			},
+		},
+	}
+
+	cardJSON, err := json.Marshal(cardContent)
+	if err != nil {
+		return fmt.Errorf("序列化飞书卡片内容失败: %w", err)
+	}
+
+	// 3. 构建请求的 JSON Body
+	payload := larkMessagePayload{
+		ReceiveID:     toAddr,
+		ReceiveIDType: "email",       // 指定接收者类型为邮箱
+		MsgType:       "interactive", // 消息卡片类型
+		Content:       string(cardJSON),
+	}
+
+	jsonBytes, err := json.Marshal(payload)
+	if err != nil {
+		return fmt.Errorf("序列化飞书消息失败: %w", err)
+	}
+
+	// 4. 发送 HTTP POST 请求
+	url := fmt.Sprintf("%s?receive_id_type=email", larkSendMessageURL) // 在 URL 中指定 receive_id_type
+	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonBytes))
+	if err != nil {
+		return fmt.Errorf("创建飞书请求失败: %w", err)
+	}
+	req.Header.Set("Content-Type", "application/json")
+	req.Header.Set("Authorization", "Bearer "+token) // 携带 access_token
+
+	client := &http.Client{}
+	resp, err := client.Do(req)
+	if err != nil {
+		return fmt.Errorf("发送飞书通知失败: %w", err)
+	}
+	defer resp.Body.Close()
+
+	// 5. 检查响应
+	var response larkResponse
+	if err := json.NewDecoder(resp.Body).Decode(&response); err != nil {
+		return fmt.Errorf("解析飞书响应失败: %w", err)
+	}
+
+	if response.Code != 0 {
+		return fmt.Errorf("飞书API返回错误: code=%d, msg=%s", response.Code, response.Msg)
+	}
+
+	return nil
+}
+
+// getAccessToken 获取并缓存 tenant_access_token，处理了线程安全和自动刷新。
+func (l *larkNotifier) getAccessToken() (string, error) {
+	l.mu.Lock()
+	defer l.mu.Unlock()
+
+	// 如果 token 存在且有效期还有5分钟以上，则直接返回缓存的 token
+	if l.accessToken != "" && time.Now().Before(l.tokenExpiresAt.Add(-5*time.Minute)) {
+		return l.accessToken, nil
+	}
+
+	// 否则，重新获取 token
+	payload := map[string]string{
+		"app_id":     l.appID,
+		"app_secret": l.appSecret,
+	}
+	jsonBytes, err := json.Marshal(payload)
+	if err != nil {
+		return "", fmt.Errorf("序列化获取 token 请求体失败: %w", err)
+	}
+
+	req, err := http.NewRequest("POST", larkGetTokenURL, bytes.NewBuffer(jsonBytes))
+	if err != nil {
+		return "", fmt.Errorf("创建获取 token 请求失败: %w", err)
+	}
+	req.Header.Set("Content-Type", "application/json")
+
+	client := &http.Client{}
+	resp, err := client.Do(req)
+	if err != nil {
+		return "", fmt.Errorf("获取 tenant_access_token 请求失败: %w", err)
+	}
+	defer resp.Body.Close()
+
+	var tokenResp larkTokenResponse
+	if err := json.NewDecoder(resp.Body).Decode(&tokenResp); err != nil {
+		return "", fmt.Errorf("解析 tenant_access_token 响应失败: %w", err)
+	}
+
+	if tokenResp.Code != 0 {
+		return "", fmt.Errorf("获取 tenant_access_token API 返回错误: code=%d, msg=%s", tokenResp.Code, tokenResp.Msg)
+	}
+
+	// 缓存新的 token 和过期时间
+	l.accessToken = tokenResp.TenantAccessToken
+	l.tokenExpiresAt = time.Now().Add(time.Duration(tokenResp.Expire) * time.Second)
+
+	return l.accessToken, nil
+}
+
+// Type 返回通知器的类型
+func (l *larkNotifier) Type() NotifierType {
+	return NotifierTypeLark
+}
+
+// --- API 数据结构 ---
+
+// larkTokenResponse 是获取 tenant_access_token API 的响应结构体
+type larkTokenResponse struct {
+	Code              int    `json:"code"`
+	Msg               string `json:"msg"`
+	TenantAccessToken string `json:"tenant_access_token"`
+	Expire            int    `json:"expire"` // 有效期，单位秒
+}
+
+// larkMessagePayload 是发送消息 API 的请求体结构
+type larkMessagePayload struct {
+	ReceiveID     string `json:"receive_id"`
+	ReceiveIDType string `json:"receive_id_type"`
+	MsgType       string `json:"msg_type"`
+	Content       string `json:"content"` // 对于 interactive 消息，这里是卡片的 JSON 字符串
+}
+
+// larkResponse 是飞书 API 的通用响应结构体
+type larkResponse struct {
+	Code int    `json:"code"`
+	Msg  string `json:"msg"`
+}

internal/infra/notify/log_notifier.go

@@ -0,0 +1,37 @@
+package notify
+
+import (
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
+)
+
+// logNotifier 实现了 Notifier 接口，用于将告警信息记录到日志中。
+type logNotifier struct {
+	logger *logs.Logger
+}
+
+// NewLogNotifier 创建一个新的 logNotifier 实例。
+// 它接收一个日志记录器，用于实际的日志输出。
+func NewLogNotifier(logger *logs.Logger) Notifier {
+	return &logNotifier{
+		logger: logger,
+	}
+}
+
+// Send 将告警内容以结构化的方式记录到日志中。
+// toAddr 参数在这里表示告警的预期接收者地址，也会被记录。
+func (l *logNotifier) Send(content AlarmContent, toAddr string) error {
+	l.logger.Infow("告警已记录到日志",
+		"notifierType", NotifierTypeLog,
+		"title", content.Title,
+		"message", content.Message,
+		"level", content.Level.String(),
+		"timestamp", content.Timestamp.Format(DefaultTimeFormat),
+		"toAddr", toAddr,
+	)
+	return nil // 记录日志操作本身不应失败
+}
+
+// Type 返回通知器的类型。
+func (l *logNotifier) Type() NotifierType {
+	return NotifierTypeLog
+}

internal/infra/notify/notify.go

@@ -0,0 +1,44 @@
+package notify
+
+import (
+	"time"
+
+	"go.uber.org/zap/zapcore"
+)
+
+// DefaultTimeFormat 定义了所有通知中统一使用的时间格式。
+const DefaultTimeFormat = "2006-01-02 15:04:05"
+
+// NotifierType 定义了通知器的类型。
+type NotifierType string
+
+const (
+	// NotifierTypeSMTP 表示 SMTP 邮件通知器。
+	NotifierTypeSMTP NotifierType = "邮件"
+	// NotifierTypeWeChat 表示企业微信通知器。
+	NotifierTypeWeChat NotifierType = "企业微信"
+	// NotifierTypeLark 表示飞书通知器。
+	NotifierTypeLark NotifierType = "飞书"
+	// NotifierTypeLog 表示日志通知器，作为最终的告警记录渠道。
+	NotifierTypeLog NotifierType = "日志"
+)
+
+// AlarmContent 定义了通知的内容
+type AlarmContent struct {
+	// 通知标题
+	Title string
+	// 通知信息
+	Message string
+	// 通知级别
+	Level zapcore.Level
+	// 通知时间
+	Timestamp time.Time
+}
+
+// Notifier 定义了通知发送器的接口
+type Notifier interface {
+	// Send 发送通知
+	Send(content AlarmContent, toAddr string) error
+	// Type 返回通知器的类型
+	Type() NotifierType
+}

internal/infra/notify/smtp.go

@@ -0,0 +1,73 @@
+package notify
+
+import (
+	"fmt"
+	"net/smtp"
+	"strings"
+)
+
+// smtpNotifier 实现了 Notifier 接口，用于通过 SMTP 发送邮件通知。
+type smtpNotifier struct {
+	host     string // SMTP 服务器地址
+	port     int    // SMTP 服务器端口
+	username string // 发件人邮箱地址
+	password string // 发件人邮箱授权码
+	sender   string // 发件人名称或地址，显示在邮件的 \"From\" 字段
+}
+
+// NewSMTPNotifier 创建一个新的 smtpNotifier 实例。
+// 调用者需要注入 SMTP 相关的配置。
+func NewSMTPNotifier(host string, port int, username, password, sender string) Notifier {
+	return &smtpNotifier{
+		host:     host,
+		port:     port,
+		username: username,
+		password: password,
+		sender:   sender,
+	}
+}
+
+// Send 使用 net/smtp 包发送一封邮件。
+func (s *smtpNotifier) Send(content AlarmContent, toAddr string) error {
+	// 1. 设置认证信息
+	auth := smtp.PlainAuth("", s.username, s.password, s.host)
+
+	// 2. 构建邮件内容
+	// 邮件头
+	subject := content.Title
+	contentType := "Content-Type: text/plain; charset=UTF-8"
+	fromHeader := fmt.Sprintf("From: %s", s.sender)
+	toHeader := fmt.Sprintf("To: %s", toAddr)
+	subjectHeader := fmt.Sprintf("Subject: %s", subject)
+
+	// 邮件正文
+	body := fmt.Sprintf("级别: %s\n时间: %s\n\n%s",
+		content.Level.String(),
+		content.Timestamp.Format(DefaultTimeFormat),
+		content.Message,
+	)
+
+	// 拼接完整的邮件报文
+	msg := strings.Join([]string{
+		fromHeader,
+		toHeader,
+		subjectHeader,
+		contentType,
+		"", // 邮件头和正文之间的空行
+		body,
+	}, "\r\n")
+
+	// 3. 发送邮件
+	addr := fmt.Sprintf("%s:%d", s.host, s.port)
+	err := smtp.SendMail(addr, auth, s.username, []string{toAddr}, []byte(msg))
+	if err != nil {
+		return fmt.Errorf("发送邮件失败: %w", err)
+	}
+
+	return nil
+}
+
+// Type 返回通知器的类型
+func (s *smtpNotifier) Type() NotifierType {
+	return NotifierTypeSMTP
+}