# LMY

**Repository Path**: cmalou/lmy

## Basic Information

- **Project Name**: LMY
- **Description**: lmy的毕业设计
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-08
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 生鲜电商管理系统

基于SpringBoot + Vue3 + MyBatis-Plus的中小型生鲜电商管理系统

## 项目结构

```
LMY/
├── fresh-mall-backend/          # 后端项目
│   ├── src/main/java/com/freshmail/
│   │   ├── config/              # 配置类
│   │   ├── controller/          # 控制器层
│   │   │   ├── admin/          # 管理端接口
│   │   │   └── user/           # 用户端接口
│   │   ├── service/            # 业务逻辑层
│   │   │   └── impl/           # Service实现类
│   │   ├── mapper/             # 数据访问层
│   │   ├── entity/             # 实体类
│   │   ├── dto/                # 数据传输对象
│   │   ├── vo/                 # 视图对象
│   │   ├── common/             # 公共类
│   │   │   └── exception/      # 异常处理
│   │   └── util/               # 工具类
│   └── src/main/resources/
│       ├── mapper/             # MyBatis映射文件
│       ├── sql/                # 数据库脚本
│       └── application.yml     # 配置文件
├── fresh-mall-frontend/
│   ├── user-client/            # 用户端前端
│   │   └── src/
│   │       ├── api/           # API接口
│   │       ├── components/    # 公共组件
│   │       ├── views/         # 页面
│   │       ├── router/        # 路由
│   │       ├── store/         # 状态管理
│   │       └── utils/         # 工具类
│   └── admin-client/          # 管理端前端
│       └── src/
│           ├── api/
│           ├── components/
│           ├── views/
│           ├── router/
│           ├── store/
│           └── utils/
└── 开发文档.md                 # 开发文档
```

## 技术栈

### 后端
- **框架**: SpringBoot 2.7.14
- **ORM**: MyBatis-Plus 3.5.3
- **数据库**: MySQL 8.0
- **缓存**: Redis
- **认证**: JWT
- **JDK**: 1.8

### 前端
- **框架**: Vue 3
- **UI组件**: Element-Plus
- **HTTP客户端**: Axios
- **状态管理**: Pinia
- **路由**: Vue Router 4
- **构建工具**: Vite

## 快速开始

### 1. 环境准备

- JDK 1.8+
- Maven 3.6+
- MySQL 8.0
- Node.js 14+
- Redis (可选)

### 2. 数据库配置

1. 创建数据库:
```sql
CREATE DATABASE fresh_mall DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
```

2. 执行SQL脚本:
```bash
mysql -u root -p fresh_mall < fresh-mall-backend/src/main/resources/sql/fresh_mall.sql
```

### 3. 后端启动

1. 进入后端项目目录:
```bash
cd fresh-mall-backend
```

2. 修改配置文件 `src/main/resources/application.yml`:
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/fresh_mall?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false
    username: root
    password: 123456  # 修改为你的数据库密码
```

3. 启动后端服务:
```bash
mvn spring-boot:run
```

或者使用IDEA打开项目,运行 `FreshMallApplication.java`

后端服务将在 `http://localhost:8080` 启动

### 4. 前端启动

#### 用户端

1. 进入用户端项目目录:
```bash
cd fresh-mall-frontend/user-client
```

2. 安装依赖:
```bash
npm install
```

3. 启动开发服务器:
```bash
npm run dev
```

用户端将在 `http://localhost:3000` 启动

#### 管理端

1. 进入管理端项目目录:
```bash
cd fresh-mall-frontend/admin-client
```

2. 安装依赖:
```bash
npm install
```

3. 启动开发服务器:
```bash
npm run dev
```

管理端将在 `http://localhost:3001` 启动

## 默认账号

### 管理员账号
- 用户名: `admin`
- 密码: `admin123`

### 测试用户
可以通过用户端注册页面注册新用户

## 主要功能

### 用户端功能
- ✅ 用户注册/登录
- ✅ 商品浏览、搜索
- ✅ 购物车管理
- ✅ 订单管理
- ✅ 收货地址管理
- ✅ 个人信息管理

### 管理端功能
- ✅ 管理员登录
- ✅ 商品管理 (CRUD、上下架)
- ✅ 商品分类管理
- ✅ 订单管理 (查看、发货、退款)
- ✅ 用户管理
- ✅ 数据统计

## API接口文档

### 用户端接口

#### 用户模块
- `POST /api/user/register` - 用户注册
- `POST /api/user/login` - 用户登录
- `GET /api/user/info` - 获取用户信息
- `PUT /api/user/update` - 更新用户信息

#### 商品模块
- `GET /api/product/list` - 商品列表
- `GET /api/product/detail/{id}` - 商品详情
- `GET /api/product/search` - 搜索商品
- `GET /api/product/hot` - 热销商品
- `GET /api/product/new` - 新品推荐

#### 购物车模块
- `GET /api/cart/list` - 购物车列表
- `POST /api/cart/add` - 添加到购物车
- `PUT /api/cart/update` - 更新购物车
- `DELETE /api/cart/delete/{id}` - 删除购物车项

#### 订单模块
- `POST /api/order/create` - 创建订单
- `GET /api/order/list` - 订单列表
- `GET /api/order/detail/{id}` - 订单详情
- `POST /api/order/pay` - 支付订单
- `PUT /api/order/cancel` - 取消订单
- `PUT /api/order/confirm` - 确认收货

### 管理端接口

#### 管理员模块
- `POST /api/admin/login` - 管理员登录
- `GET /api/admin/info` - 获取管理员信息
- `GET /api/admin/list` - 管理员列表

#### 商品管理
- `GET /api/admin/product/list` - 商品列表
- `POST /api/admin/product/add` - 添加商品
- `PUT /api/admin/product/update` - 更新商品
- `DELETE /api/admin/product/delete/{id}` - 删除商品

#### 订单管理
- `GET /api/admin/order/list` - 订单列表
- `GET /api/admin/order/detail/{id}` - 订单详情
- `PUT /api/admin/order/delivery` - 发货

#### 数据统计
- `GET /api/admin/statistics/overview` - 数据概览

## 项目特色

1. **前后端分离架构**: 清晰的职责划分,便于维护和扩展
2. **RESTful API设计**: 标准化的接口设计
3. **JWT无状态认证**: 提高系统安全性和可扩展性
4. **MyBatis-Plus**: 简化数据库操作,提高开发效率
5. **响应式设计**: 适配多种设备屏幕
6. **完善的异常处理**: 统一的异常处理机制
7. **代码规范**: 遵循阿里巴巴Java开发规范

## 注意事项

1. 首次运行前请确保MySQL数据库已启动
2. 确保8080、3000、3001端口未被占用
3. Redis为可选配置,如不使用需注释相关配置
4. 文件上传路径可在application.yml中配置

## 开发计划

- [ ] 文件上传功能实现
- [ ] 商品评价功能
- [ ] 优惠券系统
- [ ] 秒杀功能
- [ ] 数据可视化图表
- [ ] 微信/支付宝支付对接
- [ ] Excel导出功能
- [ ] 短信验证码

## 许可证

MIT License

## 联系方式

如有问题,请通过以下方式联系:
- Email: your-email@example.com
- GitHub: https://github.com/yourusername

---

**开发时间**: 2025年11月

**版本**: v1.0.0