# 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)
```bash
cd yshop-drink
mvn clean install           # 安装依赖
mvn spring-boot:run         # 启动开发服务
mvn package -DskipTests     # 打包（跳过测试）
```

### 管理后台 (yshop-drink-vue)
```bash
cd yshop-drink-vue
pnpm install                # 安装依赖
pnpm dev                    # 本地开发 (默认端口)
pnpm build:prod             # 生产环境构建
pnpm lint:eslint            # ESLint 检查
```

### 用户端 (yshop-drink-uniapp)
```bash
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 | `待配置` |