# Backend - 活牛采购智能数字化系统后端服务

## 📋 项目概述

活牛采购智能数字化系统后端服务采用Node.js + Express框架构建，为前端应用、管理后台和小程序提供统一的API接口服务。系统采用微服务架构设计，支持高并发、高可用的业务处理。

**核心特性：**
- 🛠️ **微服务架构**：模块化服务设计，易于维护和扩展
- 🔐 **统一认证**：JWT + RBAC权限控制系统
- 📊 **实时数据**：WebSocket实时数据推送
- 📹 **文件管理**：支持大文件上传和视频处理
- 💰 **支付集成**：支持多种支付方式
- 📈 **监控日志**：完善的日志和监控体系

## 🛠 技术栈

| 类别 | 技术选型 | 版本 | 说明 |
|------|----------|------|------|
| **运行时** | Node.js | ^18.17.0 | 服务器运行环境 |
| **Web框架** | Express.js | ^4.18.0 | 轻量级Web框架 |
| **数据库ORM** | Sequelize | ^6.32.0 | 关系型数据库ORM |
| **数据库** | MySQL | ^8.0 | 主数据库 |
| **缓存** | Redis | ^7.0 | 内存缓存和会话存储 |
| **认证** | jsonwebtoken | ^9.0.0 | JWT认证 |
| **参数验证** | joi | ^17.9.0 | 请求参数验证 |
| **文件上传** | multer | ^1.4.5 | 文件上传中间件 |
| **日志** | winston | ^3.10.0 | 日志管理 |
| **实时通信** | Socket.io | ^4.7.0 | WebSocket实时通信 |

## 📂 项目结构

```
backend/
├── src/                        # 源代码目录
│   ├── app.js                  # 应用入口文件
│   ├── config/                 # 配置文件
│   ├── controllers/            # 控制器层
│   ├── services/               # 服务层
│   ├── models/                 # 数据模型
│   ├── middleware/             # 中间件
│   ├── routes/                 # 路由定义
│   ├── utils/                  # 工具函数
│   ├── validators/             # 参数验证器
│   ├── jobs/                   # 后台任务
│   └── database/               # 数据库相关
├── tests/                      # 测试文件
├── docs/                       # 文档目录
├── uploads/                    # 上传文件目录
├── logs/                       # 日志目录
└── package.json                # 项目依赖
```

## 🚀 快速开始

### 环境要求
- Node.js >= 18.0.0
- MySQL >= 8.0
- Redis >= 7.0
- npm >= 8.0.0

### 数据库配置
```bash
# 数据库连接信息
主机: 129.211.213.226
端口: 9527
用户名: root
密码: aiotAiot123!
数据库: jiebandata
```

### 安装依赖
```bash
cd backend
npm install
```

### 环境配置
```bash
# 复制环境配置文件
cp .env.example .env.development

# 编辑配置文件
vim .env.development
```

### 数据库初始化
```bash
# 执行数据库迁移
npm run db:migrate

# 执行数据填充
npm run db:seed
```

### 启动服务
```bash
# 开发环境
npm run dev

# 生产环境
npm start
```

服务将运行在 http://localhost:3001