# LuckinAdmin

**Repository Path**: chenl16/luckin-admin

## Basic Information

- **Project Name**: LuckinAdmin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-25
- **Last Updated**: 2025-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LuckinAdmin 咖啡管理系统

## 项目简介

LuckinAdmin 是一个基于现代Web技术栈构建的咖啡店综合管理系统，前端采用Vue3技术生态，后端基于FastAPI实现。系统包含用户管理、商品管理、订单处理、数据可视化等核心功能模块。

## 技术栈

### 前端技术
- **框架**: Vue3 + Vite
- **状态管理**: Pinia
- **UI框架**: Element Plus
- **数据可视化**: ECharts 
- **开发语言**: TypeScript
- **路由管理**: Vue Router 
- **HTTP客户端**: Axios

### 后端技术
- **框架**: FastAPI
- **开发语言**: Python 3.9+
- **ORM**: SQLAlchemy 2.0
- **数据库**: MySQL 8.0
- **API文档**: Swagger UI

## 主要功能

### 后台管理模块
- **用户管理**
  - 角色权限分配
  - 登录与注册
- **商品管理**
  - 咖啡品类维护
  - 配方成分管理
- **订单管理**
  - 实时订单处理
  - 历史订单查询
- **数据分析**
  - 销售数据可视化

## 环境要求

- Node.js 16+
- Python 3.9+
- MySQL 8.0+

## 快速启动

### 前端服务
```bash
cd LuckinAdmin
npm install
npm run dev
```

### 后端服务

```bash
cd LuckinAdmin_server
pip install -r requirements.txt
python3 main.py
```

### 数据库初始化

```mysql
CREATE DATABASE luckinadmin CHARACTER SET utf8mb4;
USE luckinadmin
SOURCE luckinadmin.sql
```

## 项目结构

```
luckin-admin
├── LuckinAdmin #前端项目
│   ├── src
│   │   ├── assets # 静态资源
│   │   │   ├── images
│   │   │   │   ├── icons
│   │   │   └── typescript
│   │   ├── components # 公共组件
│   │   │   ├── chart # 图表组件
│   │   ├── router  # 路由管理
│   │   ├── stores  # 状态管理
│   │   ├── utils	# API请求
│   │   └── views # 页面视图
├── LuckinAdmin_server #后端项目
│   ├── main.py #应用核心
│   ├── mysql_connector.py # 连接数据库
│   ├── order.py # 订单逻辑
│   ├── requirements.txt 
│   └── user.py # 用户逻辑
├── luckinadmin.sql # 数据库
├── mysql-init.sh #数据库初始化脚本
└── README.md
```