# MilkStore

**Repository Path**: team-615/milk-store

## Basic Information

- **Project Name**: MilkStore
- **Description**: MilkStore是一个基于uni-app开发的奶茶点单微信小程序，提供奶茶店线上点单、外卖配送等功能，让用户随时随地享受美味奶茶。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 3
- **Created**: 2025-03-17
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 奶茶点单小程序

## 项目介绍
这是一个基于uni-app开发的奶茶点单微信小程序，提供奶茶店线上点单、外卖配送等功能，让用户随时随地享受美味奶茶。项目采用前后端分离架构，前端使用uni-app实现跨平台开发，后端使用Spring Boot提供API服务，数据存储使用MySQL数据库。

## 项目进度
- [x] 用户认证模块（验证码登录）
- [x] 产品展示模块
- [x] 分类管理模块
- [x] 轮播图管理
- [x] 城市门店模块
- [x] 会员勋章系统
- [x] 优惠券系统
- [ ] 购物车模块
- [ ] 订单管理模块
- [ ] 支付集成
- [ ] 用户地址管理

## 功能特点
- 精美首页：展示热门产品、优惠活动、季节限定产品和会员福利
- 便捷点单：分类浏览奶茶产品，自定义糖度、冰量和配料
- 多元支付：支持微信支付、会员卡支付和积分抵扣
- 门店导航：基于地理位置显示附近门店，提供详细地址和距离信息
- 订单管理：查看历史订单，追踪订单制作和配送状态
- 会员系统：会员积分累计、等级提升、优惠券和专属活动
- 勋章收集：二十四节气限定、大自然限定等多种特色勋章
- 个性化推荐：基于用户购买习惯推荐可能喜欢的产品

## 技术架构
### 前端
- 框架：uni-app
- 开发语言：Vue 3 (组合式API)
- 样式处理：SCSS
- 状态管理：Vuex/Pinia
- 部署平台：微信小程序

### 后端
- 框架：Spring Boot
- 数据库：MySQL
- ORM：MyBatis
- 身份验证：JWT
- API文档：已提供完整API接口文档

## 页面结构
- 首页：轮播广告、活动推广、热门产品和功能入口
- 点单页：分类菜单浏览、产品详情和购物车
- 订单确认页：配送信息、支付方式和优惠券选择
- 订单页：订单列表、订单状态和配送追踪
- 订单详情：订单信息、状态更新和订单操作
- 我的页面：用户信息、会员等级和功能入口
- 地图选择页：门店定位、城市选择和距离计算
- 勋章墙：用户获得的成就勋章展示

## 安装和运行
### 前端
1. 克隆仓库
```bash
git clone https://gitee.com/team-615/milk-store.git
```

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

3. 运行项目
```bash
npm run dev:mp-weixin
```

4. 使用微信开发者工具打开项目目录下的`dist/dev/mp-weixin`文件夹

### 后端
1. 克隆后端仓库
```bash
git clone https://gitee.com/team-615/milkStore-backend.git
```

2. 配置数据库
- 创建MySQL数据库
- 执行`src/main/resources/sql`目录下的SQL脚本初始化数据库表和示例数据

3. 配置应用
- 修改`application.properties`中的数据库连接信息

4. 运行应用
```bash
./mvnw spring-boot:run
```

## 项目截图
(项目截图将在开发完成后添加)

## API文档
详细API接口文档请参考项目中的`奶茶店API接口文档.md`文件，其中包含了所有后端接口的地址和参数说明。

## 贡献指南
欢迎提交Issue和Pull Request，一起完善这个项目！

## 许可证
MIT License