# 馋猫外卖

**Repository Path**: ddeatrr/hungry-cat

## Basic Information

- **Project Name**: 馋猫外卖
- **Description**: springboot vue  uniapp 实现 馋猫外卖
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-21
- **Last Updated**: 2026-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 馋猫外卖, Vue, uni-app, 外卖

## README

<p align="center">
  <strong style="font-size: 28px; color: #FF2D55;">馋猫外卖</strong><br/>
  <sub>外卖场景应用 · 攒钱进馋猫钱罐 · 假装点外卖，真的攒下钱</sub>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Spring%20Boot-2.7.18-blue.svg" alt="Spring Boot"/>
  <img src="https://img.shields.io/badge/Vue-3.5-blue.svg" alt="Vue"/>
  <img src="https://img.shields.io/badge/uni--app-H5-green.svg" alt="uni-app"/>
</p>

## qq讨论群: 149100946
## **问题反馈** qq: 727869402 wx: MAMBA_4EVER24

---

## 在线演示

**移动端**：[http://101.34.78.30:8081/](http://101.34.78.30:8081/)

**演示账号**：手机 `13800138000` / 密码 `admin123`

### 移动端能力一览

<table>
  <tr>
    <td align="center" width="33%"><img src="docs/images/home.png" width="240" alt="外卖首页"/><br/><sub>外卖首页</sub></td>
    <td align="center" width="33%"><img src="docs/images/shop.png" width="240" alt="店铺点单"/><br/><sub>店铺点单</sub></td>
    <td align="center" width="33%"><img src="docs/images/confirm.png" width="240" alt="确认订单"/><br/><sub>确认订单</sub></td>
  </tr>
  <tr>
    <td align="center"><img src="docs/images/pay.png" width="240" alt="收银台"/><br/><sub>收银台 · 存入钱罐</sub></td>
    <td align="center"><img src="docs/images/order.png" width="240" alt="订单追踪"/><br/><sub>订单追踪</sub></td>
    <td align="center"><img src="docs/images/mine.png" width="240" alt="我的"/><br/><sub>我的 · 钱罐 / 卡路里</sub></td>
  </tr>
</table>

---

## 项目背景

馋猫外卖是一套可独立部署的外卖场景应用，自带会员、商品、交易、支付与钱包能力，按外卖业务语义封装店铺、点单、下单与配送进度体验。

核心玩法：**下单支付 → 金额存入馋猫钱罐**，配合备餐/配送进度动画与「拦截卡路里」统计，适合演示、活动运营或轻量私域场景。主题色 `#FF2D55`。

---

## 技术栈

| 端 | 技术 | 目录 |
|----|------|------|
| **C 端 H5（完整版）** | uni-app + Vue3 + Vite + Pinia | `yudao-ui/chanmao`（本地） |
| **C 端 H5（Lite）** | 同上，开源演示 | `yudao-ui/chanmao-lite` |
| **管理后台** | Vue3 + Element Plus | `yudao-ui/yudao-ui-admin-vue3` |
| **后端** | Spring Boot 2.7 + MyBatis Plus + Redis | `yudao-server`、`yudao-module-*` |
| **数据库** | MySQL 5.7+ | 库名 `chanmao` |

---

## 主要功能

- **外卖首页**：8 宫格品类（可取消选中）、限时馋抢购、附近店铺列表
- **店铺点单**：左侧分类 + 菜品列表、加购、一店一车结算
- **确认订单 / 支付**：地址、优惠券、备注；商品单走模拟支付，**支付后存入馋猫钱罐**
- **订单详情**：四步进度、地图示意、支付后 60 秒倒计时变「已送达」
- **我的**：钱罐余额、可用券「去使用」、累计拦截卡路里
- **管理后台**：店铺 CRUD、商品挂店、营销活动、订单管理

---

## 思维导图

```
                        馋猫外卖
           ┌──────────────┼──────────────┬──────────┐
           ▼              ▼              ▼          ▼
        C端 H5        管理后台          后端       部署
           │              │              │          │
    ┌──────┼──────┐   ┌───┴───┐    ┌─────┴─────┐   ├─ Nginx 8081
    ▼      ▼      ▼   ▼       ▼    ▼     ▼     ▼   ├─ API 8086
  首页   点单   下单  店铺   订单  takeout product  ├─ MySQL
    │      │      │   商品   营销  trade   pay      └─ Redis
    ▼      ▼      ▼   券秒杀  中心  member  钱包
  钱罐   支付   订单
  追踪
```

- **C 端 H5**：外卖首页 → 店铺点单 → 确认下单 → 钱罐支付 → 订单追踪 → 我的钱罐
- **管理后台**：店铺管理 · 商品菜品 · 优惠券秒杀 · 订单中心 · 会员钱包
- **后端**：takeout 店铺 · product 商品 · trade 交易 · pay 支付钱包 · member 会员
- **部署**：Nginx 8081 · API 8086 · MySQL · Redis

---

## 项目启动

### 环境要求

- JDK 8
- MySQL 5.7+
- Redis
- Node.js 18+（前端）

### 后端

1. 导入 SQL（顺序）：`sql/mysql/ruoyi-vue-pro.sql` → `member-mall.sql` → `takeout-*.sql`
2. 修改 `yudao-server/src/main/resources/application-local.yaml`（数据库、Redis）
3. 打包启动：

```bash
mvn -pl yudao-server -am package -DskipTests
java -jar yudao-server/target/yudao-server.jar
```

本地默认端口 **48080**。

### 管理端

```bash
cd yudao-ui/yudao-ui-admin-vue3
pnpm install
pnpm dev
```

### C 端 H5

**完整版（本地开发）**

```bash
cd yudao-ui/chanmao
pnpm install
cp .env.production.example .env.production
pnpm dev:h5
pnpm exec vite build --mode production
```

**Lite 演示版（Gitee 开源 / 线上 :8082 预览）**

```bash
cd yudao-ui/chanmao-lite
pnpm install
cp .env.production.example .env.production
pnpm dev:h5
node scripts/build-lite.mjs
```

---

## 包结构说明

```text
馋猫外卖/
├── yudao-server/              # 启动入口
├── yudao-module-mall/         # 商品 / 促销 / 交易（含 takeout 接口）
├── yudao-module-member/       # 会员
├── yudao-module-pay/          # 支付 / 钱包
├── yudao-ui/
│   ├── chanmao/               # C 端 H5 完整版（本地，不提交）
│   ├── chanmao-lite/          # C 端 H5 Lite（Gitee 开源）
│   └── yudao-ui-admin-vue3/   # 管理后台
├── docs/                      # 截图与对外介绍
├── sql/mysql/                 # 数据库脚本
└── scripts/deploy/            # 服务器部署脚本
```

---

## 生产部署

H5 与 API 地址、Nginx、Docker MySQL 等**线上配置在本地** `scripts/deploy/`（已加入 `.gitignore`，含服务器 IP 与密码，勿提交仓库）。部署前复制 `yudao-ui/chanmao/.env.production.example` 为 `.env.production` 并填写实际域名。

---

**代码地址** [https://gitee.com/ddeatrr/hungry-cat](https://gitee.com/ddeatrr/hungry-cat)  
**问题反馈** qq: 727869402 wx: MAMBA_4EVER24 qq讨论群: 149100946