# 自助贩卖售货机

**Repository Path**: software_project_training/vending-machines

## Basic Information

- **Project Name**: 自助贩卖售货机
- **Description**: 软件工程实训项目，自助贩卖售货机业务管理系统，实现商品、库存、订单等基础业务功能。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-13
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 帝可得自动售货机管理系统

> 面向连锁自动售货机运营场景的一体化管理系统，覆盖点位管理、设备管理、货道商品配置、订单管理、运营工单全流程，并集成基于大模型的 AI 智能助手。

## 项目简介

传统售货机运营依赖 Excel 与人工沟通管理补货、维修与对账，存在效率低、过程不可追溯的问题。本系统将运营流程线上化：

- **基础数据**：区域点位、设备型号、售货机档案统一管理
- **货道配置**：支持单台设备批量配置货道与商品
- **订单中心**：用户端扫码选购、下单、支付结果展示
- **运营工单**：补货工单与维修工单的创建、领取、处理、复检、归档闭环
- **AI 智能助手**：基于通义千问大模型，支持自然语言查询业务数据，多轮连续会话

## 技术栈

| 层次 | 技术 |
|---|---|
| 前端 | Vue 3 + Vite + Element Plus + Pinia + Axios + ECharts |
| 后端 | Spring Boot + Spring MVC + MyBatis + Spring Security + JWT |
| AI | Spring AI + 阿里云百炼 DashScope（通义千问） |
| 数据库 | MySQL 8 + Druid 连接池 |
| 缓存 | Redis 7 |
| 构建 | Maven 多模块 |

## 目录结构

```
├── 前端代码/dkd-vue            # 前端工程（管理端 + 用户端）
├── 后端代码/dkd-parent         # 后端 Maven 多模块工程
│   ├── dkd-admin               # 启动模块
│   ├── dkd-manage              # 核心业务（点位/设备/货道/商品/订单/工单）
│   ├── dkd-ai                  # AI 智能助手模块
│   ├── dkd-system              # 用户/角色/权限/菜单
│   ├── dkd-framework           # 框架核心
│   ├── dkd-common              # 通用工具
│   ├── dkd-quartz              # 定时任务
│   └── dkd-generator           # 代码生成
├── 数据库代码/ry_drink.sql      # 建表与初始化脚本
├── usecase-diagram.png/.puml   # 高层用例图
└── 项目文档-*.docx / *.pptx     # 项目报告与答辩材料
```

## 快速开始

### 环境要求

- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Redis 7+
- Maven 3.8+

### 1. 导入数据库

```bash
mysql -u root -p < 数据库代码/ry_drink.sql
```

### 2. 修改后端配置

编辑 `后端代码/dkd-parent/dkd-admin/src/main/resources/` 下的配置：

- `application-druid.yml`：数据库连接地址、用户名、密码
- `application.yml`：Redis 地址、AI 大模型 API Key

> 提示：AI 功能需要填入你自己的 DashScope API Key，否则 `/ai/chat` 接口不可用。

### 3. 启动后端

```bash
cd 后端代码/dkd-parent
mvn clean package -DskipTests
java -jar dkd-admin/target/dkd-admin.jar
```

### 4. 启动前端

```bash
cd 前端代码/dkd-vue
npm install
npm run dev
```

默认访问 `http://localhost:80`（管理端）。

## 功能模块

| 模块 | 说明 |
|---|---|
| 点位管理 | 区域与点位信息维护 |
| 设备管理 | 设备型号、售货机档案、设备状态 |
| 货道管理 | 货道与商品绑定，支持批量配置 |
| 商品管理 | 商品分类与 SKU |
| 订单管理 | 销售订单查询与统计 |
| 工单管理 | 补货/维修工单全流程 |
| AI 智能助手 | 自然语言业务问答，多轮会话 |

## 项目文档

- `自助贩卖售货机系统大作业项目报告.docx`
- `项目文档-帝可得自动售货机管理系统.docx`
- `项目文档-项目概述与业务分析.pptx`
- `usecase-diagram.png` — 高层用例图

## 开发团队

| 姓名 | 学号 | 分工 |
|---|---|---|
| 宋泓德 | 23001020410 | 需求分析、系统设计、前后端开发、AI 模块 |
| 黄海晟 | 23001020708 | 图形资料绘制与文档校对 |

指导教师：付丽梅

## 说明

- 本项目为课程大作业，未接入真实硬件传感器与支付平台，订单支付为模拟流程。
- AI 助手仅提供**只读查询**能力，不执行任何写操作，避免大模型幻觉影响核心业务数据。