# 源代码树分析 - 主模块

本文档提供了项目源代码结构的带注释概述，重点关注包含核心应用程序逻辑的 `internal/` 目录。

```
internal/
├── app/                  # 应用层：处理 HTTP 请求、DTO 和协调服务。
│   ├── api/              # API 定义和路由 (Echo 框架)。
│   ├── controller/       # 各领域（用户、设备、计划、猪场、监控）的请求处理器。
│   │   ├── device/       # 设备相关的 API 控制器。
│   │   ├── management/   # 管理相关的 API 控制器（例如，猪群批次）。
│   │   ├── monitor/      # 监控相关的 API 控制器。
│   │   ├── plan/         # 计划相关的 API 控制器。
│   │   └── user/         # 用户相关的 API 控制器。
│   ├── dto/              # 数据传输对象：API 的请求/响应模型。
│   ├── middleware/       # HTTP 中间件（例如，身份验证、审计日志）。
│   ├── service/          # 应用服务：业务逻辑协调。
│   └── webhook/          # Webhook 处理器（例如，ChirpStack）。
├── core/                 # 核心应用组件：初始化和数据设置。
│   ├── application.go    # 主应用程序设置。
│   ├── component_initializers.go # 初始化各种应用程序组件。
│   └── data_initializer.go # 初始化核心数据。
├── domain/               # 领域层：业务逻辑和实体。
│   ├── audit/            # 审计相关的领域服务。
│   ├── device/           # 设备相关的领域服务。
│   ├── notify/           # 通知领域服务。
│   ├── pig/              # 猪只和猪群批次相关的领域服务。
│   ├── scheduler/        # 调度领域服务。
│   ├── task/             # 任务相关的领域服务。
│   └── token/            # 令牌管理领域服务。
└── infra/                # 基础设施层：外部关注点（数据库、日志、配置、外部 API）。
    ├── config/           # 配置管理。
    ├── database/         # 数据库连接和 ORM 设置 (PostgreSQL, SQLite)。
    ├── logs/             # 日志工具。
    ├── models/           # GORM 模型（数据库模式定义）。
    ├── notify/           # 通知实现（Lark、SMTP、微信）。
    ├── repository/       # 数据仓库：数据库交互逻辑。
    ├── transport/        # 外部通信（例如，LoRaWAN ChirpStack）。
    │   ├── lora/         # LoRaWAN 特定传输。
    │   └── proto/        # 协议缓冲区定义。
    └── utils/            # 通用工具。
```