xlxumu/README.md

# xlxumu - 锡林郭勒盟地区智慧养殖产业平台

## 项目概述

本项目是一个综合性的畜牧业数字化管理平台，主要面向锡林郭勒盟地区的养殖产业，包含官网展示、后台管理、移动端小程序、大屏可视化等多个子系统。平台集成了养殖管理、金融服务（银行监管、保险监管）、政府监管、牛只交易、牛肉商城、数据分析等功能模块，旨在通过数字化手段提升整个产业链的管理效率和透明度。

## 项目结构

```
.
├── backend-java/              # 后端Java微服务项目
│   ├── api/                   # API网关
│   ├── gateway/               # 网关服务
│   ├── registry/              # 服务注册与发现
│   ├── config-server/         # 配置中心
│   ├── services/              # 业务服务模块
│   │   ├── farming-service/     # 养殖管理服务
│   │   ├── finance-service/     # 金融服务
│   │   ├── government-service/  # 政府监管服务
│   │   ├── trade-service/       # 交易管理服务
│   │   ├── mall-service/        # 商城管理服务
│   │   ├── data-platform-service/ # 数据中台服务
│   │   ├── ai-service/          # AI能力服务
│   │   └── user-center-service/ # 用户中心服务
│   ├── common/                # 公共模块
│   ├── docs/                  # 文档
│   └── scripts/               # 脚本
├── admin-system/              # 管理后台系统
│   ├── farming-management/    # 养殖管理系统
│   ├── bank-supervision/      # 银行监管系统
│   ├── insurance-supervision/ # 保险监管系统
│   ├── government-platform/   # 政府监管平台
│   ├── cattle-trading/        # 活牛交易系统
│   ├── mall-management/       # 商城管理系统
│   └── dashboard/             # 大屏可视化系统
├── website/                   # 官网项目
├── mini_program/              # 微信小程序矩阵
│   ├── beef-mall/             # 牛肉商城小程序
│   ├── farming-manager/       # 养殖管理小程序
│   ├── bank-supervision/      # 银行监管小程序
│   ├── insurance-supervision/ # 保险监管小程序
│   ├── cattle-trading/        # 活牛交易小程序
│   ├── gov-supervision/       # 政府监管小程序
│   ├── data-platform/         # 数据中台小程序
│   └── ai-capabilities/      # AI能力小程序
├── docs/                      # 文档目录
│   ├── design/                # 设计文档
│   ├── requirements/          # 需求文档
│   └── development_plans/     # 开发计划文档
├── test/                      # 测试文件目录
└── deployment/                # 部署相关配置
```

## 文档目录

详细文档请参见 [docs/README.md](docs/README.md) 文件，其中包含所有系统文档的完整列表和链接。

- `docs/requirements/` - 需求文档
- `docs/design/` - 设计文档
- `docs/development_plans/` - 开发计划
- `docs/PROJECT_STRUCTURE.md` - 项目结构说明文档

## 技术栈

### 技术栈
- **官网项目 (website/)**: HTML5 + CSS3 + JavaScript
- **管理后台系统 (admin-system/)**: Vue.js 3 + TypeScript + Ant Design Vue + Pinia
- **微信小程序矩阵 (mini_program/)**: 微信小程序原生开发 + uni-app

### 后端技术栈
- **核心框架**: Spring Boot 2.7.5 + Spring Cloud 2021.0.5
- **编程语言**: Java 11
- **构建工具**: Maven 3.8+
- **数据库**: MySQL 8.0
- **缓存系统**: Redis
- **消息队列**: RabbitMQ
- **API文档**: Swagger/OpenAPI 3.0
- **监控**: Spring Boot Admin + Micrometer
- **安全**: Spring Security + OAuth2 + JWT
- **配置中心**: Spring Cloud Config
- **服务发现**: Spring Cloud Eureka
- **负载均衡**: Spring Cloud LoadBalancer
- **熔断器**: Resilience4j
- **链路追踪**: Spring Cloud Sleuth + Zipkin
- **容器化**: Docker
- **编排**: Kubernetes

## 部署说明

详细的部署说明请参考 [deployment/README.md](deployment/README.md) 文件。

## 开发说明

1. 管理后台系统 (admin-system/) 使用 Vite 构建
2. 后端项目 (backend-java/) 基于 Java 11 和 Spring Boot 2.7.5
3. 各个子系统可以独立开发和部署
4. 微服务架构便于扩展和维护

## 项目特点

1. **模块化设计**: 前后端分离，模块化设计便于团队协作
2. **微服务架构**: 后端采用微服务架构，提高系统可扩展性
3. **多端支持**: 支持PC端、移动端、微信小程序和大屏展示
4. **数据驱动**: 集成数据分析和可视化展示
5. **安全可靠**: 完善的权限管理和数据安全保障