# 项目概述 - 猪场控制器

## 1. 项目名称和目的

**项目名称**: 猪场控制器

**目的**: 猪场控制器是一个后端应用程序，旨在管理猪场的各个方面。其核心功能包括用户管理、设备控制、计划执行、全面的猪群批次管理和实时数据监控。它旨在提供一个集中式系统，用于高效和自动化的猪场运营。

## 2. 执行摘要

猪场控制器是一个健壮的后端应用程序，使用 Go 语言开发，利用 Echo Web 框架进行 API 开发，并使用 GORM 进行数据库交互。它被构建为一个分层、以 API 为中心的后端服务，确保了模块化和可维护性。该应用程序集成了 PostgreSQL（支持 TimescaleDB）用于数据存储，并旨在处理复杂的农场管理逻辑，包括通过 ChirpStack 进行 LoRaWAN 设备通信。它提供了一套全面的 RESTful API，用于外部系统集成和内部操作控制。

## 3. 技术栈摘要

| 类别        | 技术          | 版本    |
| :---------- | :------------ | :------ |
| 语言        | Go            | 1.25    |
| Web 框架    | Echo          | v4.13.4 |
| ORM         | GORM          | v1.30.5 |
| 数据库驱动  | PostgreSQL    |         |
| 数据库驱动  | SQLite        |         |
| 日志        | Zap           | v1.27.0 |
| 文档        | Swaggo        | v1.16.6 |

## 4. 架构类型分类

**架构类型**: 分层/以 API 为中心的后端服务

**仓库结构**: 单体

## 5. 详细文档链接

*   [API 契约](./api-contracts-main-zh.md)
*   [数据模型](./data-models-main-zh.md)
*   [源代码树分析](./source-tree-analysis-zh.md)
*   [开发指南](./development-guide-main-zh.md)
*   [架构文档](./architecture-main-zh.md)