aiotagro/xlxumu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: 重构数据库配置为SQLite开发环境并移除冗余文档

Browse Source
This commit is contained in:
aiotagro
2025-09-21 15:16:48 +08:00
parent d207610009
commit 3c8648a635
259 changed files with 88239 additions and 8379 deletions
Download Patch File Download Diff File Expand all files Collapse all files

250
README.md
View File

@@ -1,117 +1,205 @@
# xlxumu - 畜牧管理系统
# 畜牧养殖管理平台
## 项目概述
xlxumu是一个综合性的畜牧管理系统，旨在为畜牧业提供全面的数字化解决方案。该系统涵盖了从养殖管理、金融服务、政府监管到电商交易等各个环节，通过现代化的技术架构和用户友好的界面设计，提升畜牧业的管理效率和经济效益。
畜牧养殖管理平台是一个综合性的数字化养殖管理解决方案，旨在通过现代化的信息技术手段，为养殖户、管理机构、金融机构等提供全方位的养殖管理服务。
## 技术架构
### 核心功能
项目采用前后端分离的架构设计，包含多个技术栈：
- **养殖管理**：动物档案管理、健康监控、饲料管理、疫苗接种记录
- **交易平台**：牲畜交易、价格监控、订单管理、物流跟踪
- **金融服务**：保险管理、贷款申请、风险评估、资金监管
- **数据分析**：养殖数据统计、市场分析、趋势预测、决策支持
- **政府监管**：养殖场备案、疫情监控、食品安全追溯、政策发布
### 前端技术栈
### 技术架构
1. **管理后台系统** (admin-system)
- React + Vite
- Ant Design Pro
- TypeScript
2. **小程序端** (mini_program)
- 微信小程序原生开发
- WXML + WXSS + JavaScript
3. **官网** (website)
- HTML5 + CSS3 + JavaScript
### 后端技术栈
1. **Node.js版本** (backend)
- Node.js + Express
- MySQL
2. **Java版本** (backend-java)
- Java 8+ + Spring Boot 2.7.x
- Spring Cloud 2021.x
- MySQL 8.0
- **前端技术**：Vue.js 3 + Element Plus + Vite
- **小程序**：微信小程序原生开发
- **后端技术**：Node.js + Express / Python + FastAPI
- **数据库**：MySQL + Redis + MongoDB
- **部署方案**：Docker + Nginx + 云服务器
## 项目结构
```
xlxumu/
├── admin-system/ # 管理后台系统
│ ├── bank-supervision/ # 银行监管子系统
│ ├── cattle-trading/ # 牛只交易子系统
│ ├── dashboard/ # 仪表板子系统
│ ├── farming-management/ # 养殖管理子系统
│ ├── government-platform/ # 政府平台子系统
│ ├── insurance-supervision/ # 保险监管子系统
│ └── mall-management/ # 商城管理子系统
├── backend/ # Node.js后端服务
├── backend-java/ # Java后端服务
├── mini_program/ # 微信小程序
│ ├── bank-supervision/ # 银行监管小程序
│ ├── beef-mall/ # 牛肉商城小程序
│ ├── cattle-trading/ # 牛只交易小程序
│ ├── farming-manager/ # 养殖管理小程序
│ └── insurance-supervision/ # 保险监管小程序
├── website/ # 官网
└── docs/ # 项目文档
├── README.md # 项目入口文档
├── docs/ # 文档目录
│ ├── requirements/ # 需求文档
│ ├── architecture/ # 架构文档
│ ├── design/ # 详细设计文档
│ ├── development/ # 开发文档
│ └── operations/ # 运维文档
├── admin-system/ # 管理后台系统
│ ├── dashboard/ # 数据看板
│ ├── farming-management/ # 养殖管理
│ ├── cattle-trading/ # 牲畜交易
│ ├── bank-supervision/ # 银行监管
│ ├── insurance-supervision/ # 保险监管
│ ├── government-platform/ # 政府平台
│ └── mall-management/ # 商城管理
├── mini_program/ # 小程序应用
│ ├── farming-manager/ # 养殖管理小程序
│ ├── cattle-trading/ # 交易平台小程序
│ ├── beef-mall/ # 牛肉商城小程序
│ ├── bank-supervision/ # 银行监管小程序
│ └── insurance-supervision/ # 保险监管小程序
├── backend/ # 后端服务
│ ├── api/ # API服务
│ ├── database/ # 数据库管理
│ ├── services/ # 业务服务
│ └── utils/ # 工具类
├── website/ # 官方网站
├── scripts/ # 脚本工具
└── deployment/ # 部署配置
```
## 快速开始
### 前端项目启动
### 环境要求
1. **管理后台系统**
- Node.js 16+
- Python 3.9+
- MySQL 8.0+
- Redis 6.0+
- Docker & Docker Compose
### 安装步骤
1. **克隆项目**
```bash
git clone https://github.com/your-org/xlxumu.git
cd xlxumu
```
2. **安装依赖**
```bash
# 安装前端依赖
cd admin-system/dashboard
npm install
# 安装后端依赖
cd ../../backend/api
npm install
```
3. **配置环境**
```bash
# 复制环境配置文件
cp backend/api/.env.example backend/api/.env
# 编辑配置文件，填入数据库等配置信息
```
4. **初始化数据库**
```bash
cd backend/database
npm run setup
```
5. **启动服务**
```bash
# 启动后端服务
cd backend/api
npm run dev
# 启动前端服务
cd admin-system/dashboard
npm run dev
```
2. **微信小程序**
使用微信开发者工具打开对应的小程序目录
### Docker 部署
3. **官网**
直接在浏览器中打开website/index.html文件
### 后端服务启动
#### Node.js版本
```bash
cd backend
npm install
npm start
# 使用 Docker Compose 一键启动
docker-compose up -d
# 查看服务状态
docker-compose ps
```
#### Java版本
```bash
cd backend-java
mvn clean install
```
## 文档导航
然后分别启动各个微服务：
```bash
# 启动farming-service
cd backend-java/services/farming-service
mvn spring-boot:run
### 📋 需求文档
- [整个项目需求文档](docs/requirements/整个项目需求文档.md) - 项目整体需求概述
- [官网需求文档](docs/requirements/官网需求文档.md) - 官方网站功能需求
- [后端管理需求文档](docs/requirements/后端管理需求文档.md) - 后端管理系统需求
- [管理后台需求文档](docs/requirements/管理后台需求文档.md) - 管理后台功能需求
- [小程序app需求文档](docs/requirements/小程序app需求文档.md) - 小程序应用需求
# 启动user-center-service
cd backend-java/services/user-center-service
mvn spring-boot:run
```
### 🏗️ 架构文档
- [整个项目的架构文档](docs/architecture/整个项目的架构文档.md) - 系统整体架构设计
- [后端架构文档](docs/architecture/后端架构文档.md) - 后端服务架构
- [小程序架构文档](docs/architecture/小程序架构文档.md) - 小程序技术架构
- [管理后台架构文档](docs/architecture/管理后台架构文档.md) - 管理后台架构
## 文档
### 📐 详细设计文档
- [数据库设计文档](docs/design/数据库设计文档.md) - 数据库表结构设计
- [管理后台接口设计文档](docs/design/管理后台接口设计文档.md) - 管理后台API设计
- [小程序app接口设计文档](docs/design/小程序app接口设计文档.md) - 小程序API设计
详细的项目文档位于`docs/`目录下，包括：
- 需求文档
- 设计文档
- API文档
- 开发计划
### 👨‍💻 开发文档
- [后端开发文档](docs/development/后端开发文档.md) - 后端开发指南
- [后端管理开发文档](docs/development/后端管理开发文档.md) - 后端管理系统开发
- [小程序app开发文档](docs/development/小程序app开发文档.md) - 小程序开发指南
- [管理后台开发文档](docs/development/管理后台开发文档.md) - 管理后台开发指南
## 贡献
### 🛠️ 运维文档
- [测试文档](docs/operations/测试文档.md) - 测试策略和用例
- [部署文档](docs/operations/部署文档.md) - 部署指南和配置
- [运维文档](docs/operations/运维文档.md) - 运维操作和监控
- [安全文档](docs/operations/安全文档.md) - 安全策略和防护
- [用户手册文档](docs/operations/用户手册文档.md) - 用户操作指南
欢迎提交Issue和Pull Request来改进本项目。
## 开发团队
### 项目角色分工
- **项目经理**：项目整体规划和进度管控
- **产品经理**：需求分析和产品设计
- **架构师**：系统架构设计和技术选型
- **前端开发**：管理后台和官网开发
- **小程序开发**：微信小程序开发
- **后端开发**：API服务和数据库设计
- **测试工程师**：功能测试和性能测试
- **运维工程师**：部署和运维管理
### 开发规范
- **代码规范**：遵循ESLint和Prettier配置
- **Git规范**：使用Git Flow工作流
- **API规范**：遵循RESTful设计原则
- **文档规范**：使用Markdown格式编写
## 部署环境
### 开发环境
- **地址**：http://dev.xlxumu.com
- **数据库**：开发环境数据库
- **用途**：日常开发和功能测试
### 测试环境
- **地址**：http://test.xlxumu.com
- **数据库**：测试环境数据库
- **用途**：集成测试和用户验收测试
### 生产环境
- **地址**：https://www.xlxumu.com
- **数据库**：生产环境数据库
- **用途**：正式运营环境
## 联系方式
- **项目仓库**：https://github.com/your-org/xlxumu
- **问题反馈**：https://github.com/your-org/xlxumu/issues
- **技术支持**：tech-support@xlxumu.com
- **商务合作**：business@xlxumu.com
## 许可证
[MIT License](LICENSE)
本项目采用 [MIT License](LICENSE) 开源协议。
---
**最后更新**：2024年12月
**文档版本**：v1.0.0