# smart-campus-platform

**Repository Path**: biyouji_admin_admin/smart-campus-platform

## Basic Information

- **Project Name**: smart-campus-platform
- **Description**: 一个基于 Vue3 + FastAPI + MySQL 的现代化电商后台管理系统。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-27
- **Last Updated**: 2026-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 电商管理系统

一个基于 Vue3 + FastAPI + MySQL 的现代化电商后台管理系统。

## 🚀 项目特性

- **前端技术栈**: Vue3 + Element Plus + Pinia + Vue Router
- **后端技术栈**: FastAPI + SQLAlchemy + MySQL + JWT认证
- **现代化UI**: 响应式设计，支持移动端
- **权限管理**: 基于角色的访问控制
- **数据可视化**: ECharts图表展示
- **RESTful API**: 标准化API接口设计

## 📋 功能模块

### 核心功能
- 🔐 用户认证与授权
- 📊 数据统计仪表盘
- 🛍️ 商品管理（增删改查、库存管理）
- 📂 分类管理（树形结构）
- 📋 订单管理（状态跟踪、支付管理）
- 👥 客户管理（信息维护、消费统计）
- ⚙️ 系统设置（基本配置、支付设置）

### 技术特性
- JWT Token认证
- 数据库连接池
- 请求响应拦截
- 错误处理机制
- 分页查询
- 数据验证

## 🏗️ 项目结构

```
电商管理系统/
├── backend/                 # 后端服务
│   ├── app/
│   │   ├── api/            # API路由
│   │   ├── core/           # 核心配置
│   │   ├── models/         # 数据模型
│   │   └── schemas/        # 数据验证
│   ├── main.py             # 应用入口
│   ├── requirements.txt    # Python依赖
│   └── start.py           # 启动脚本
├── frontend/               # 前端应用
│   ├── src/
│   │   ├── components/     # 组件
│   │   ├── views/         # 页面
│   │   ├── router/        # 路由
│   │   ├── stores/        # 状态管理
│   │   └── utils/         # 工具函数
│   ├── package.json       # 前端依赖
│   └── vite.config.js     # 构建配置
└── database_schema.sql     # 数据库结构
```

## 🛠️ 环境要求

### 后端环境
- Python 3.8+
- MySQL 5.7+
- pip

### 前端环境
- Node.js 16+
- npm 或 yarn

## 📦 安装部署

### 1. 克隆项目
```bash
git clone <repository-url>
cd 电商管理系统
```

### 2. 数据库设置
```bash
# 创建数据库
mysql -u root -p
CREATE DATABASE ecommerce_admin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 导入数据库结构
mysql -u root -p ecommerce_admin < database_schema.sql
```

### 3. 后端部署
```bash
cd backend

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置数据库连接等信息

# 启动服务
python start.py
```

### 4. 前端部署
```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build
```

## 🔧 配置说明

### 后端配置 (.env)
```env
# 数据库配置
DATABASE_URL=mysql+pymysql://root:password@localhost:3306/ecommerce_admin

# JWT配置
SECRET_KEY=your-secret-key-here
ACCESS_TOKEN_EXPIRE_MINUTES=30

# CORS配置
ALLOWED_HOSTS=["http://localhost:3000"]
```

### 前端配置 (vite.config.js)
```javascript
export default defineConfig({
  server: {
    proxy: {
      '/api': {
        target: 'http://localhost:8000',
        changeOrigin: true
      }
    }
  }
})
```

## 🚀 快速开始

### 默认账户
- 用户名: `admin`
- 密码: `admin123`

### 访问地址
- 前端应用: http://localhost:3000
- 后端API: http://localhost:8000
- API文档: http://localhost:8000/docs

## 📚 API文档

启动后端服务后，访问 http://localhost:8000/docs 查看完整的API文档。

### 主要API端点
- `POST /api/v1/auth/login` - 用户登录
- `GET /api/v1/auth/me` - 获取当前用户信息
- `GET /api/v1/products` - 获取商品列表
- `POST /api/v1/products` - 创建商品
- `GET /api/v1/orders` - 获取订单列表
- `GET /api/v1/categories` - 获取分类列表

## 🧪 测试

### 后端API测试
```bash
cd backend
python test_api.py
```

### 前端测试
```bash
cd frontend
npm run test
```

## 📈 性能优化

- 数据库索引优化
- 前端代码分割
- 图片懒加载
- API响应缓存
- 分页查询

## 🔒 安全特性

- JWT Token认证
- 密码加密存储
- SQL注入防护
- XSS攻击防护
- CORS跨域配置
- 请求频率限制

## 🤝 贡献指南

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🆘 常见问题

### Q: 数据库连接失败？
A: 请检查 `.env` 文件中的数据库配置信息，确保MySQL服务正在运行。

### Q: 前端页面空白？
A: 请确保后端服务已启动，并检查浏览器控制台的错误信息。

### Q: API请求失败？
A: 请检查CORS配置，确保前端域名在允许列表中。

## 📞 联系方式

如有问题或建议，请通过以下方式联系：

- 手机号: 15570791615
- 项目Issues: [GitHub Issues](https://github.com/your-repo/issues)

---

⭐ 如果这个项目对你有帮助，请给它一个星标！