删除过时文档，优化项目结构

2025-09-10 20:04:14 +08:00
parent 02fe7d11da
commit f80848fc0f
31 changed files with 1055 additions and 0 deletions
--- a/backend-java/README.md
+++ b/backend-java/README.md
@@ -0,0 +1,148 @@
+# 宁夏智慧养殖监管平台 - Java后端
+
+这是宁夏智慧养殖监管平台的Java微服务版本后端实现，使用Spring Boot框架构建。
+
+## 技术栈
+
+- **Java版本**: Java 17
+- **框架**: Spring Boot 3.1.0
+- **安全框架**: Spring Security
+- **数据库**: MySQL 8.0+
+- **ORM框架**: Spring Data JPA (Hibernate)
+- **API文档**: Springdoc OpenAPI (Swagger 3)
+- **认证**: JWT (JSON Web Tokens)
+- **密码加密**: BCrypt
+- **构建工具**: Maven
+- **服务器端口**: 5350
+
+## 项目结构
+
+```
+backend-java/
+├── src/
+│   ├── main/
+│   │   ├── java/
+│   │   │   └── com/nxxmdata/farmmonitor/
+│   │   │       ├── Application.java          # 应用启动类
+│   │   │       ├── config/                   # 配置类
+│   │   │       ├── controller/               # 控制器层
+│   │   │       ├── service/                  # 服务层
+│   │   │       ├── repository/               # 数据访问层
+│   │   │       ├── model/                    # 数据模型
+│   │   │       ├── dto/                      # 数据传输对象
+│   │   │       ├── security/                 # 安全相关
+│   │   │       └── exception/                # 异常处理
+│   │   └── resources/
+│   │       ├── application.yml               # 应用配置
+│   │       └── application-dev.yml           # 开发环境配置
+│   └── test/                                 # 测试代码
+├── pom.xml                                   # Maven配置文件
+└── README.md                                 # 项目说明文档
+```
+
+## 功能模块
+
+1. **用户认证模块**
+   - 用户登录/注册
+   - JWT Token生成与验证
+   - 密码加密存储
+
+2. **用户管理模块**
+   - 用户信息管理
+   - 角色权限管理
+
+3. **农场管理模块**
+   - 农场信息管理
+   - 地理位置信息处理
+
+4. **设备监控模块**
+   - 设备状态监控
+   - 传感器数据处理
+
+5. **动物管理模块**
+   - 动物档案管理
+   - 健康状态跟踪
+
+6. **预警管理模块**
+   - 系统告警处理
+   - 告警规则配置
+
+7. **订单管理模块**
+   - 产品销售管理
+   - 订单处理流程
+
+8. **统计分析模块**
+   - 数据统计分析
+   - 报表生成
+
+## API文档
+
+启动服务后，可通过以下地址访问API文档：
+
+- Swagger UI: http://localhost:5350/swagger-ui.html
+- OpenAPI JSON: http://localhost:5350/v3/api-docs
+
+## 数据库配置
+
+在 `application.yml` 文件中配置数据库连接：
+
+```yaml
+spring:
+  datasource:
+    url: jdbc:mysql://192.168.0.240:3307/nxxmdata?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
+    username: root
+    password: aiot$Aiot123
+    driver-class-name: com.mysql.cj.jdbc.Driver
+```
+
+## 快速开始
+
+### 环境要求
+
+- Java 17+
+- Maven 3.6+
+- MySQL 8.0+
+
+### 构建项目
+
+```bash
+mvn clean package
+```
+
+### 运行项目
+
+```bash
+mvn spring-boot:run
+```
+
+或者
+
+```bash
+java -jar target/farm-monitor-1.0.0.jar
+```
+
+## 开发规范
+
+1. 遵循RESTful API设计规范
+2. 使用JWT进行无状态认证
+3. 密码使用BCrypt加密存储
+4. 代码注释规范清晰
+5. API文档完整
+
+## 安全设计
+
+1. 使用JWT Token进行身份验证
+2. 密码使用BCrypt加密存储
+3. 基于角色的访问控制(RBAC)
+4. SQL注入防护（使用JPA）
+5. XSS防护（前端处理）
+
+## 性能优化
+
+1. 数据库连接池配置
+2. Hibernate二级缓存（可选）
+3. API响应时间监控
+4. 数据库查询优化
+
+---
+*最后更新: 2025年9月*