# 奶茶店管理系统

基于Spring Boot + MyBatis + MySQL + Thymeleaf的奶茶店管理系统，包含用户端和商家端两个主要模块，集成协同过滤推荐算法。

## 技术栈

- **后端框架**: Spring Boot 2.7.18
- **数据库**: MySQL 8.0+
- **ORM**: MyBatis
- **认证**: JWT Token
- **前端**: HTML + Thymeleaf + Bootstrap 5
- **算法**: 协同过滤推荐算法（基于用户的协同过滤）

## 功能模块

### 用户端功能
1. 用户注册登录
2. 个人信息管理
3. 商品浏览（支持分类筛选）
4. 商品个性化定制（甜度、冰度、配料）
5. 购物车管理
6. 订单下单支付（模拟微信/支付宝）
7. 订单跟踪
8. 个性化商品推荐（协同过滤算法）
9. 公告查看
10. 留言反馈

### 商家端功能
1. 商家注册登录
2. 商家信息管理
3. 商品管理（新增/编辑/下架）
4. 商品规格和配料管理
5. 订单管理（接单/拒单/状态更新）
6. 库存管理（入库/出库/预警）
7. 公告发布
8. 评价管理（查看/回复）
9. 数据统计（日/周/月销量、营收、热门商品）

## 数据库设计

数据库表结构请参考 `src/main/resources/db/schema.sql`

主要表包括：
- user, user_address - 用户相关
- merchant - 商家
- product, product_spec, product_topping, product_custom - 商品相关
- cart - 购物车
- order, order_item, order_track - 订单相关
- inventory, inventory_log - 库存相关
- announcement - 公告
- message - 留言反馈
- review - 评价
- user_behavior, user_similarity - 协同过滤算法相关

## 安装和运行

### 1. 环境要求
- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+

### 2. 数据库配置
1. 创建数据库：
```sql
CREATE DATABASE nl_shop CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 执行建表SQL：
```bash
mysql -u root -p nl_shop < src/main/resources/db/schema.sql
```

3. 修改配置文件 `src/main/resources/application.yml`：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/nl_shop?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: your_password
```

### 3. 编译运行
```bash
mvn clean install
mvn spring-boot:run
```

### 4. 访问系统
- 用户端登录: http://localhost:8080/user/login.html
- 商家端登录: http://localhost:8080/merchant/login.html

## 协同过滤算法

系统实现了基于用户的协同过滤推荐算法：

1. **用户行为记录**: 记录用户的浏览、购买、评分行为
2. **相似度计算**: 使用余弦相似度计算用户之间的相似度
3. **推荐生成**: 基于相似用户的偏好生成推荐列表
4. **冷启动处理**: 新用户推荐热门商品

算法实现在 `CollaborativeFilteringService` 中。

## API接口

### 用户端接口
- POST `/user/register` - 用户注册
- POST `/user/login` - 用户登录
- GET `/user/products` - 商品列表
- GET `/user/products/{id}` - 商品详情
- GET `/user/recommend` - 个性化推荐
- POST `/user/cart/add` - 加入购物车
- POST `/user/order/create` - 创建订单
- POST `/user/order/{id}/pay` - 支付订单

### 商家端接口
- POST `/merchant/register` - 商家注册
- POST `/merchant/login` - 商家登录
- GET `/merchant/products` - 商品列表
- POST `/merchant/products` - 新增商品
- GET `/merchant/orders` - 订单列表
- PUT `/merchant/orders/{id}/accept` - 接单
- GET `/merchant/statistics/sales` - 销量统计

详细API文档请参考Controller代码。

## 项目结构

```
nl_shop/
├── src/main/java/com/nlshop/
│   ├── config/              # 配置类
│   ├── controller/          # 控制器层
│   │   ├── user/           # 用户端控制器
│   │   └── merchant/       # 商家端控制器
│   ├── service/            # 业务逻辑层
│   │   ├── user/
│   │   ├── merchant/
│   │   └── algorithm/      # 协同过滤算法
│   ├── mapper/             # MyBatis Mapper
│   ├── entity/             # 实体类
│   ├── dto/                # 数据传输对象
│   ├── util/               # 工具类
│   └── interceptor/        # 拦截器
└── src/main/resources/
    ├── mapper/             # MyBatis XML映射
    ├── templates/          # Thymeleaf模板
    └── db/                 # 数据库脚本
```

## 注意事项

1. JWT Token默认有效期为24小时，可在 `application.yml` 中配置
2. 文件上传路径配置在 `application.yml` 的 `file.upload-path`
3. 密码使用MD5加密（生产环境建议使用BCrypt）
4. 支付功能为模拟实现，实际项目需要对接真实支付接口

## 开发计划

- [x] 项目基础架构
- [x] 数据库设计
- [x] 用户端功能
- [x] 商家端功能
- [x] 协同过滤算法
- [x] 前端页面
- [ ] 单元测试
- [ ] 性能优化
- [ ] Redis缓存集成

## 许可证

MIT License