YShop Drink - Claude Code 配置
项目信息
| 属性 |
值 |
| 项目名称 |
yshop-drink |
| 项目类型 |
project-group (多项目组) |
| 项目版本 |
3.2.3 |
| 项目描述 |
意向订餐系统 - 类似肯德基点餐模式，支持多门店 |
子项目
| 子项目 |
类型 |
技术栈 |
目录 |
| yshop-drink |
后端 API |
Spring Boot 3 + JDK 17 + MyBatis Plus + MySQL |
./yshop-drink/ |
| yshop-drink-vue |
管理后台 |
Vue 3 + Vite 5 + Element Plus + TypeScript |
./yshop-drink-vue/ |
| yshop-drink-uniapp |
用户端小程序 |
UniApp + Vue 3 + Vant UI |
./yshop-drink-uniapp/ |
系统架构
┌─────────────────────────────────────────────────────────────┐
│ 用户终端 │
├─────────────────────────────────────────────────────────────┤
│ 微信小程序 / H5 │ 后台管理系统 (Vue3) │
│ (UniApp) │ (Element Plus) │
└─────────┬───────────┴──────────────┬────────────────────────┘
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────┐
│ Spring Boot 3 后端 │
├─────────────────────────────────────────────────────────────┤
│ yshop-module-mall 商城核心 (商品/订单/门店) │
│ yshop-module-member 会员管理 │
│ yshop-module-pay 支付模块 (微信支付) │
│ yshop-module-mp 微信公众号 │
│ yshop-module-marketing 营销活动 (优惠券) │
│ yshop-module-score 积分系统 │
│ yshop-module-message 消息通知 │
│ yshop-module-express 物流/同城配送 │
│ yshop-module-merchant 商户管理 │
│ yshop-module-system 系统管理 (用户/权限) │
│ yshop-module-infra 基础设施 (文件/配置) │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ MySQL 数据库 │ Redis 缓存 │ 云小票打印机 │
└─────────────────────────────────────────────────────────────┘
核心功能模块
| 模块 |
功能 |
| 商品管理 |
多规格SKU、商品分类、库存管理 |
| 订单系统 |
堂食/外卖、订单状态流转、退款 |
| 门店管理 |
多门店、营业时间、桌号管理 |
| 支付系统 |
微信支付、余额支付、充值 |
| 会员系统 |
会员等级、积分、优惠券 |
| 营销活动 |
满减、优惠券、限时折扣 |
| 消息通知 |
订单通知、小票打印 |
开发命令
后端 (yshop-drink)
cd yshop-drink
mvn clean install # 安装依赖
mvn spring-boot:run # 启动开发服务
mvn package -DskipTests # 打包（跳过测试）
管理后台 (yshop-drink-vue)
cd yshop-drink-vue
pnpm install # 安装依赖
pnpm dev # 本地开发 (默认端口)
pnpm build:prod # 生产环境构建
pnpm lint:eslint # ESLint 检查
用户端 (yshop-drink-uniapp)
cd yshop-drink-uniapp
npm install # 安装依赖
# 使用 HBuilderX 运行/发布
数据库
| 文件 |
说明 |
sql/yixiang-drink.sql |
完整数据库脚本 (新用户) |
sql/updateV3.x.x.sql |
增量升级脚本 (老用户) |
后端模块结构
yshop-drink/
├── yshop-dependencies/ # 依赖版本管理
├── yshop-framework/ # 核心框架 (安全/缓存/通用)
├── yshop-server/ # 启动入口
├── yshop-module-system/ # 系统管理
├── yshop-module-infra/ # 基础设施
├── yshop-module-mall/ # 商城核心
├── yshop-module-member/ # 会员管理
├── yshop-module-pay/ # 支付模块
├── yshop-module-mp/ # 微信公众号
├── yshop-module-marketing/ # 营销活动
├── yshop-module-score/ # 积分系统
├── yshop-module-message/ # 消息通知
├── yshop-module-express/ # 物流配送
└── yshop-module-merchant/ # 商户管理
前端管理系统模块
yshop-drink-vue/src/views/
├── mall/
│ ├── product/ # 商品管理
│ ├── order/ # 订单管理
│ ├── store/ # 门店管理
│ ├── shop/ # 店铺设置
│ ├── desk/ # 桌号管理
│ ├── member/ # 会员管理
│ ├── coupon/ # 优惠券
│ ├── cashier/ # 收银台
│ └── statistics/ # 数据统计
├── pay/ # 支付管理
├── market/ # 营销管理
├── score/ # 积分管理
├── mp/ # 公众号管理
├── message/ # 消息管理
├── express/ # 物流管理
├── system/ # 系统设置
└── infra/ # 基础设施
用户端页面结构
yshop-drink-uniapp/pages/
├── index/ # 首页 (点餐)
├── menu/ # 菜单
├── order/ # 订单
└── mine/ # 我的
技术栈详情
后端技术
- Java 17 + Spring Boot 3.2.2
- Spring Security OAuth2 (JWT 认证)
- MyBatis Plus (ORM)
- Redis (缓存/Session)
- MySQL (数据库)
- MapStruct (对象映射)
管理后台技术
- Vue 3.4 + TypeScript 5.3
- Vite 5.1 (构建工具)
- Element Plus 2.6 (UI 组件)
- Pinia (状态管理)
- Vue Router 4 (路由)
- UnoCSS (原子化 CSS)
- ECharts (图表)
- BPMN.js (流程设计)
用户端技术
- UniApp (跨端框架)
- Vue 3 (响应式框架)
- Vant 4 (移动端 UI)
- Pinia (状态管理)
- 微信 JSSDK
核心文档
| 文档 |
位置 |
内容 |
| 系统架构 |
yshop/architecture.canvas |
整体架构图 |
| 后端模块 |
yshop/backend-modules.canvas |
后端模块关系 |
| 数据库设计 |
yshop/database.canvas |
核心表结构 |
| API 文档 |
Swagger UI |
接口文档 |
关联配置
Obsidian 文档路径
文档根目录: /Users/yibu/dev_workspace/vibe-coding-cn
项目文档: /Users/yibu/dev_workspace/vibe-coding-cn/yshop
Vibe Kanban 项目
| 项目 |
Kanban ID |
| yshop-drink |
待配置 |
| yshop-drink-vue |
待配置 |
| yshop-drink-uniapp |
待配置 |
