# sky-take-out

**Repository Path**: ArashiCode-coder/sky-take-out

## Basic Information

- **Project Name**: sky-take-out
- **Description**: 基于 Spring Boot 3 + 微信小程序的外卖点餐系统，支持菜品管理、在线下单、WebSocket 实时通知
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-11-06
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SpringBoot, MyBatis, Redis, WebSocket, 微信小程序

## README

# 苍穹外卖 (Sky Take Out)

基于 Spring Boot 3 的外卖点餐系统，包含管理端后台和微信小程序用户端。

## 技术栈

**后端**

- Spring Boot 3.5.8
- Spring Security + JWT 认证
- MyBatis + PageHelper
- MySQL 8.0 + Druid 连接池
- Redis 缓存
- WebSocket 消息推送
- MinIO 对象存储
- 微信支付

**前端**

- 微信小程序 (uni-app)

## 项目结构

```
sky-take-out/
├── sky-common/          # 公共模块（工具类、常量、异常等）
├── sky-pojo/            # 实体类模块（Entity、DTO、VO）
├── sky-server/          # 主服务模块（Controller、Service、Mapper）
├── mp-weixin/           # 微信小程序前端
├── database/            # 数据库脚本
└── nginx-1.20.2/        # Nginx 配置
```

## 环境要求

- JDK 17+
- Maven 3.8+
- MySQL 8.0+
- Redis 6.0+
- MinIO（可选，用于文件存储）

## 快速开始

### 1. 初始化数据库

```sql
-- 执行数据库脚本
source database/sky.sql
```

### 2. 修改配置

编辑 `sky-server/src/main/resources/application-dev.yml`：

```yaml
sky:
  datasource:
    host: localhost
    port: 3306
    database: sky_take_out
    username: your_username
    password: your_password

  redis:
    host: localhost
    port: 6379
    database: 10

  minio:
    endpoint: http://127.0.0.1:9000
    access-key-id: your_access_key
    access-key-secret: your_secret_key
    bucket-name: sky-take-out
```

### 3. 启动后端服务

```bash
# 安装依赖
mvn clean install

# 启动后端服务
mvn spring-boot:run -pl sky-server
```

服务启动后访问：http://localhost:8080

### 4. 启动 Nginx（管理端前端）

```bash
# 进入 nginx 目录
cd nginx-1.20.2

# Windows 启动
start nginx.exe

# 停止
nginx.exe -s stop
```

管理端前端已放置在 `nginx-1.20.2/html/sky/` 目录下，访问：http://localhost

Nginx 代理配置：

- `/api/**` → 后端 `/admin/**`（管理端接口）
- `/user/**` → 后端 `/user/**`（用户端接口）
- `/ws/**` → WebSocket 连接

### 5. 启动微信小程序（用户端）

1. 下载 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
2. 导入 `mp-weixin` 目录
3. 在开发者工具中配置 AppID
4. 修改小程序中的后端接口地址为你的服务器地址
5. 编译运行

### 6. 默认账号

管理员账号：`admin` / `123456`

## 功能模块

**管理端**

- 员工管理
- 分类管理
- 菜品管理
- 套餐管理
- 订单管理
- 数据统计
- 店铺状态

**用户端**

- 微信登录
- 浏览菜品/套餐
- 购物车
- 地址管理
- 在线下单
- 订单查询
- 微信支付

## API 接口

- 管理端接口：`/admin/**`
- 用户端接口：`/user/**`
- 支付回调：`/notify/**`

## License

MIT