# 时光共享智能售货机系统

**Repository Path**: sui888/vending-machine-system

## Basic Information

- **Project Name**: 时光共享智能售货机系统
- **Description**: No description available
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-23
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 时光共享智能售货机系统

基于 LikeAdmin 框架二次开发的 AI 智能售货机管理系统，支持多商户入驻、YOLO 图像识别结算、全端覆盖。商户端功能已集成至 UniApp 小程序的“商户中心”分包。
官网 http://shou.cocgw.cn
## 系统预览

| 管理后台 · 工作台 | 数据报表 · 数据概览 |
|:---:|:---:|
| ![管理后台工作台](./image/2.png) | ![数据概览](./image/1.png) |

## 系统架构

```
├── admin/                 # 管理后台前端 (Vue 3 + Element Plus)
├── server/                # 后端服务     (ThinkPHP 8 + PHP 8)
│   ├── app/
│   │   ├── adminapi/      # 管理后台 API
│   │   ├── api/           # 用户端 & 商户端 API
│   │   └── common/        # 共享层 (模型/枚举/服务)
│   ├── ai_service/        # AI 图像识别微服务 (Flask + YOLOv8)
│   ├── config/            # 配置文件
│   ├── route/             # 路由定义
│   ├── public/            # Web 入口及静态资源
│   └── sql/               # SQL 升级脚本
└── uniapp/                # 移动端 (UniApp，客户端 + 商户中心，支持小程序/App/H5)
```

## 技术栈

### 后端
| 组件 | 技术 | 版本 |
|------|------|------|
| 框架 | ThinkPHP | 8.0 |
| 语言 | PHP | >= 8.0 |
| 数据库 | MySQL | 5.7+ / 8.0 |
| 缓存 | Redis | 5.0+ (可选) |
| 微信 SDK | EasyWeChat | ^6.8 |
| 支付 | 支付宝 EasySDK | ^2.2 |

### 管理后台 / 商户端
| 组件 | 技术 |
|------|------|
| 框架 | Vue 3 (Composition API) |
| 构建 | Vite 6 |
| UI | Element Plus |
| 状态管理 | Pinia |
| 路由 | Vue Router 4 |
| 图表 | ECharts |
| CSS | Tailwind CSS + SCSS |

### 移动端
| 组件 | 技术 |
|------|------|
| 框架 | UniApp 3 (Vue 3) |
| UI | vk-uview-ui |
| 支持平台 | H5 / 微信小程序 / 支付宝小程序 / App / QQ小程序 / 百度小程序 / 头条小程序 / 快手小程序 |

### AI 服务
| 组件 | 技术 |
|------|------|
| 框架 | Flask 2.3 |
| AI 模型 | YOLOv8 (Ultralytics) |
| 深度学习 | PyTorch 2.0 |

## 功能模块

### 管理后台 — 平台管理员

| 模块 | 功能 |
|------|------|
| 工作台 | 数据概览、订单趋势、商户排行、商品排行 |
| 设备管理 | 设备列表/详情/编辑、远程开门/关门 |
| 商品管理 | 商品列表/编辑/详情、分类管理、上下架 |
| 商户管理 | 商户入驻审核、商户列表/详情/编辑 |
| 订单管理 | 订单列表/详情、异常订单审核、订单统计 |
| 结算管理 | 结算列表、结算明细、提现审核 |
| 财务管理 | 充值记录、余额明细、退款记录 |
| 用户管理 | 用户列表、余额调整 |
| 系统设置 | 网站信息、存储配置、支付配置、字典管理、缓存管理、定时任务、操作日志 |
| 售货机设置 | AI 服务配置、结算周期、佣金比例、最低提现金额 |
| 权限管理 | 管理员管理、角色管理、菜单权限 |
| 组织架构 | 部门管理、岗位管理 |
| 渠道管理 | H5 配置、微信小程序、公众号 |
| 装修管理 | PC 端装修、移动端装修 |
| 素材中心 | 文件管理 |
| 代码生成器 | 数据表管理、代码生成 |

### 商户端 — 入驻商户

| 模块 | 功能 |
|------|------|
| 工作台 | 数据概览、销售统计 |
| 设备管理 | 设备列表/添加/编辑/详情 |
| 商品管理 | 商品列表/创建/编辑、分类管理 |
| 订单管理 | 订单列表/详情/统计 |
| 结算管理 | 结算列表/明细 |
| 提现管理 | 余额查询、申请提现、提现记录 |

### 移动端 — 消费者

| 模块 | 功能 |
|------|------|
| 首页 | 首页、搜索、设备列表 |
| 购物 | 设备详情、商品浏览、扫码开门、AI 取货 |
| 结算 | 商品确认、支付（微信/支付宝/余额） |
| 订单 | 订单列表/详情、支付结果 |
| 个人中心 | 用户信息、余额、收藏、消息、设置 |

## AI 识别流程

```
扫码开门 → 设备拍摄开门前照片 → 创建识别记录
    ↓
用户取货（180 秒倒计时）
    ↓
关门 → 设备拍摄关门后照片 → 触发 AI 识别
    ↓
YOLOv8 对比前后图片 → 检测取走的商品 → 更新订单
    ↓
用户确认 → 支付 → 订单完成
```

AI 服务为独立的 Python 微服务，部署于 `server/ai_service/`，通过 Flask 提供 REST API，使用 YOLOv8 模型进行目标检测。

## 快速部署

### 环境要求
- PHP 8.0+
- MySQL 5.7+ / 8.0
- Nginx
- Node.js 18+
- Redis 5.0+ (可选)
- Python 3.8+ (AI 服务)
- Composer / npm / pip

### 传统部署

1. **导入数据库**
   ```bash
   mysql -u root -p db_name < shou_cocgw_cn.sql
   ```

2. **后端部署**
   ```bash
   cd server
   cp .example.env .env   # 编辑 .env 配置数据库连接
   composer install
   php think run -p 80    # 开发启动
   ```

3. **管理后台部署**
   ```bash
   cd admin
   npm install
   npm run dev            # 开发启动（需配置代理）
   npm run build          # 生产构建，产物输出到 server/public/admin/
   ```

4. **移动端部署 (H5)**
   ```bash
   cd uniapp
   npm install
   npm run build:h5       # 产物输出到 server/public/mobile/
   ```
   > 商户端功能已作为“商户中心”分包集成在 UniApp 小程序内，无需单独部署。

5. **AI 服务部署**
   ```bash
   cd server/ai_service
   pip install -r requirements.txt
   python app.py          # 默认监听 8000 端口
   ```

6. **Nginx 配置**
   将 `server/public/` 设为 Web 根目录，配置 URL 重写指向 `index.php`。

### Docker 部署

```bash
docker-compose up -d
```

包含服务：MySQL 8.0、Redis 7、PHP 8.2 + Nginx、AI 服务、管理后台静态资源、移动端静态资源、统一反向代理入口。

## API 文档

详见 [API_DOC.md](./API_DOC.md)

### 接口分类

| 前缀 | 说明 |
|------|------|
| `/api/*` | 用户端 & 商户端 API（用户/设备/商品/订单/支付/识别；商户登录/设备/商品/订单/结算/提现） |
| `/adminapi/*` | 管理端 API（管理员/商户/设备/商品/订单/结算/设置） |

统一响应格式：`{"code": 0, "msg": "操作成功", "data": {}, "time": 时间戳}`

## 部署文档

详见 [DEPLOYMENT.md](./DEPLOYMENT.md)

## 开发说明

详见 [AI_PROMPT.md](./AI_PROMPT.md)