Files
xlxumu/README.md
ylweng f1273daeac docs: 重构API文档和系统架构文档,统一技术栈规范docs(architecture): 更新系统架构设计文档
- 重新组织文档结构,优化标题层级
- 添加系统架构图,直观展示系统组成- 补充前端架构、后端架构、数据架构等详细内容
- 更新安全架构、部署架构、性能优化策略等章节
- 增加扩展性设计和高可用设计章节
- 总结系统架构设计特点和优势
2025-09-11 01:04:51 +08:00

117 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
## 项目结构
```
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/ # 项目文档
```
## 快速开始
### 前端项目启动
1. **管理后台系统**
```bash
cd admin-system/dashboard
npm install
npm run dev
```
2. **微信小程序**
使用微信开发者工具打开对应的小程序目录
3. **官网**
直接在浏览器中打开website/index.html文件
### 后端服务启动
#### Node.js版本
```bash
cd backend
npm install
npm start
```
#### Java版本
```bash
cd backend-java
mvn clean install
```
然后分别启动各个微服务:
```bash
# 启动farming-service
cd backend-java/services/farming-service
mvn spring-boot:run
# 启动user-center-service
cd backend-java/services/user-center-service
mvn spring-boot:run
```
## 文档
详细的项目文档位于`docs/`目录下,包括:
- 需求文档
- 设计文档
- API文档
- 开发计划
## 贡献
欢迎提交Issue和Pull Request来改进本项目。
## 许可证
[MIT License](LICENSE)