README
苍穹外卖已上线
Spring Boot 外卖系统。管理端、小程序、证书和上传目录都实打实运维过。
仓库没有公开。下面是 README 摘录。
苍穹外卖
基于 Spring Boot 的外卖点餐系统后端,包含管理端与用户端(微信小程序)接口,支持订单管理、数据报表、WebSocket 催单,以及基于 LangChain4j 的 AI 智能菜单推荐。
技术栈
| 技术 | 说明 |
|---|---|
| Spring Boot 2.7.3 | 基础框架 |
| MyBatis-Plus | 数据持久化 |
| MySQL + Druid | 业务库与连接池 |
| Redis | 缓存、店铺营业状态等 |
| RabbitMQ | 订单延迟关单、支付成功消息 |
| JWT (jjwt) | 管理端 / 用户端鉴权 |
| Knife4j 3.0.2 | 在线接口文档 |
| WebSocket | 催单等实时通知 |
| 阿里云 OSS | 图片上传(可选本地存储) |
| 微信支付 | 小程序支付 |
| LangChain4j 0.36.2 | AI 智能推荐(OpenAI 兼容协议) |
| Apache POI | 运营数据 Excel 导出 |
模块结构
sky-take-out
├── sky-common # 公共层:工具类、常量、异常、统一返回、配置属性
├── sky-pojo # 数据模型:entity / dto / vo
└── sky-server # 启动与业务:Controller、Service、Mapper、配置、MQ、WebSocket、AI
依赖关系:sky-server → sky-common + sky-pojo
功能概览
管理端(/admin/**)
- 员工登录与权限管理
- 分类 / 菜品 / 套餐 CRUD、启停售
- 文件上传(OSS 或本地存储)
- 店铺营业状态
- 订单接单、拒单、派送、完成
- 营业额 / 用户 / 订单统计、销量 Top10、Excel 导出
- 工作台今日经营数据
- WebSocket 接收催单等通知
用户端(/user/**)
- 微信登录
- 浏览分类、菜品、套餐
- 购物车、地址簿
- 下单、支付、历史订单、再来一单、催单
- AI 智能菜单推荐
AI 智能推荐
基于 LangChain4j + Function Calling:大模型可自动查询用户历史订单偏好与当前起售菜单,再生成自然语言回复与结构化推荐列表。
支持任意 OpenAI 兼容 接口(Kimi / DeepSeek / 通义千问等)。
接口
POST /user/ai/recommend
Header: authentication: <用户端 JWT>
Content-Type: application/json
{
"message": "我想吃清淡一点的"
}
响应示例:
{
"code": 1,
"data": {
"reply": "根据您的口味,为您推荐以下几道清淡菜品……",
"recommendations": [
{
"itemId": 1,
"itemName": "清炒时蔬",
"itemType": "dish",
"price": 18.00,
"image": "https://...",
"description": "...",
"reason": "清淡少油,符合您的需求"
}
]
}
}
itemType 取值:dish(菜品)或 setmeal(套餐)。
配置项(sky.ai.*)
| 配置键 | 默认值 | 说明 |
|---|---|---|
sky.ai.api-key |
(必填) | API Key,也可通过环境变量 SKY_AI_API_KEY 注入 |
sky.ai.base-url |
https://api.moonshot.cn/v1 |
OpenAI 兼容 Base URL |
sky.ai.model |
moonshot-v1-32k |
模型名称 |
sky.ai.max-tokens |
2000 |
最大 Token |
sky.ai.temperature |
0.7 |
温度 |
sky.ai.timeout-seconds |
90 |
超时(秒) |
sky.ai.log-enabled |
false |
是否打印 LLM 请求/响应日志 |
厂商示例:
# Kimi(默认)
sky:
ai:
api-key: ${SKY_AI_API_KEY:}
base-url: https://api.moonshot.cn/v1
model: moonshot-v1-32k
# DeepSeek
# base-url: https://api.deepseek.com
# model: deepseek-chat
# 通义千问
# base-url: https://dashscope.aliyuncs.com/compatible-mode/v1
# model: qwen-plus
未配置
sky.ai.api-key时服务将无法启动。
环境要求
- JDK 8+
- Maven 3.6+(或使用项目自带
mvnw) - MySQL
- Redis
- RabbitMQ(需安装 延迟消息插件)
- AI 服务 API Key(Kimi / DeepSeek / 通义等)
可选:阿里云 OSS、微信小程序 AppId/Secret、微信支付、百度地图 AK。
快速开始
1. 准备配置文件
仓库已提供示例配置(不含真实密钥)。复制后填写本地值:
cd sky-server/src/main/resources
cp application.yml.example application.yml
cp application-dev.yml.example application-dev.yml
Windows(PowerShell):
cd sky-server\src\main\resources
Copy-Item application.yml.example application.yml
Copy-Item application-dev.yml.example application-dev.yml
sky-server/src/main/resources/
├── application.yml.example # 可提交
├── application-dev.yml.example # 可提交
├── application.yml # 本地填写,勿提交
└── application-dev.yml # 本地敏感配置,勿提交
按需修改 MySQL / Redis / RabbitMQ / JWT / AI Key 等;OSS、微信、百度等为可选配置。
2. 启动
# 根目录
./mvnw -pl sky-server -am spring-boot:run
# Windows
mvnw.cmd -pl sky-server -am spring-boot:run
或在 IDE 中运行主类 com.sky.SkyApplication。
3. 接口文档
启动后访问:http://localhost:8080/doc.html(Knife4j,含管理端 / 用户端分组)
目录结构
CangQiongWaiMai/
├── pom.xml
├── mvnw / mvnw.cmd
├── sky-common/ # 公共模块
├── sky-pojo/ # 实体与传输对象
└── sky-server/
└── src/main/java/com/sky/
├── SkyApplication.java
├── ai/ # AI 助手与工具
├── config/ # Redis / MQ / OSS / WebMvc / LangChain4j 等
├── controller/
│ ├── admin/ # 管理端接口
│ └── user/ # 用户端接口
├── handler/
├── interceptor/ # JWT 拦截器
├── listener/ # MQ 监听(延迟关单、支付成功)
├── mapper/
├── service/
├── task/ # 定时任务
└── websocket/ # WebSocket 服务
注意事项
- 切勿提交
application-dev.yml、.env等含数据库密码、API Key、微信密钥的文件。 - RabbitMQ 延迟关单依赖 delayed message 插件,未安装会导致相关交换机声明失败。
- 管理端请求头默认使用
token,用户端使用authentication。 - AI 推荐依赖外部大模型服务,网络与配额异常时请检查
sky.ai.*配置与服务商控制台。
License
仅供学习与实战参考。