# 帝可得运营管理APP

**Repository Path**: progman66/dkd-app

## Basic Information

- **Project Name**: 帝可得运营管理APP
- **Description**: 运营管理App的java后端技术栈：SpringBoot+MybatisPlus+阿里云短信
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-06
- **Last Updated**: 2025-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: dkd

## README

# 帝可得运营管理APP后端

帝可得运营管理APP后端是为支持帝可得智能售货机系统的运营与维护而开发的服务端应用。该项目提供用户认证、工单管理、设备状态监控等功能，旨在提升设备运维效率与用户体验。

<table>
    <tr>
        <td><img src="./assets/image-20250606030430589.png" alt="image-20250606030430589" style="zoom:60%;" /></td>
        <td><img src="./assets/image-20250606030327758.png" alt="image-20250606030327758" style="zoom:60%;" /></td>
    </tr>
</table>

## 项目概述

项目名称：帝可得运营管理APP后端

技术栈：

- Java 11
- Spring Boot 2.7.3
- MyBatis Plus 3.5.1
- Redis
- JWT
- 阿里云短信服务（Aliyun SMS）
- Druid 连接池
- Knife4j Swagger UI 文档工具

数据库：MySQL

部署环境：Tomcat / Docker

构建工具：Maven

## 项目结构

<img src="./assets/image-20250606030810197.png" alt="image-20250606030810197"  />

## 核心功能模块

### 用户认证与权限控制

- 支持用户登录与短信验证码验证。
- 使用 JWT 实现无状态令牌认证。
- 权限控制基于角色代码 (roleCode)，如管理员 (1001)、运营人员 (1002) 和运维人员 (1003)。

### 工单管理

- 工单类型包括投放工单、补货工单、维修工单和撤机工单。
- 工单状态支持创建、进行中、取消和完成。
- 提供工单详情记录，如货道编号、商品信息等。

### 设备管理

- 管理售货机的基本信息，如设备编号、设备型号、区域归属等。
- 支持售货机状态变更（未投放、运营、撤机）。

### 数据持久化

- 使用 MyBatis Plus 实现数据库操作。
- 使用 Redis 缓存验证码、工单统计等高频访问数据。

### 日志与异常处理

- 自定义全局异常处理器 (GlobalExceptionHandler) 统一处理异常并返回友好的错误信息。
- 使用日志框架记录系统运行时的关键信息。

### 第三方服务集成

- 阿里云短信服务：用于发送登录验证码。
- 微信支付 SDK：支持订单支付功能。
- FastJSON：用于 JSON 数据解析与序列化。
- Hutool 工具包：简化日常开发任务，如日期处理、字符串操作等。