bmad初始化

bmad/project-overview-zh.md

@@ -0,0 +1,37 @@
+# 项目概述 - 猪场控制器
+
+## 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)