# back-hmdp

**Repository Path**: Nan_mungui/back-hmdp

## Basic Information

- **Project Name**: back-hmdp
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-18
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 后端管理系统项目介绍

## 项目简介

本项目是一个基于Spring Boot框架开发的后端管理系统，主要用于管理商铺、用户、优惠券、订单、预约等信息。系统采用模块化设计，结构清晰，适用于中小企业进行后台业务管理。

## 功能模块

- **商铺管理**：支持商铺信息的增删改查，包括商铺类型、商圈、预算等信息。
- **用户管理**：提供用户登录、注册、签到、密码重置等功能，并支持基于Redis的用户信息缓存。
- **优惠券管理**：支持普通优惠券与秒杀优惠券的添加与查询。
- **订单管理**：支持秒杀优惠券订单的处理，包括订单创建与消息队列消费。
- **评论管理**：支持用户对商铺发布探店博文与点赞功能。
- **预约管理**：提供预约店铺、取消预约、搜索相关店铺等工具。
- **异常处理**：通过全局异常处理器捕获运行时异常并返回统一的错误结果。
- **文件上传**：支持图片上传与删除功能。
- **AI 对话**：通过DPAgent接口实现与AI助手的对话功能，支持流式响应。

## 技术栈

- **Spring Boot**：提供快速开发框架。
- **MyBatis Plus**：简化数据库操作。
- **Redis**：用于缓存用户信息、商铺信息等，提高系统性能。
- **Redisson**：用于分布式锁的实现。
- **MongoDB**：用于存储和管理会话信息。
- **RabbitMQ**：用于异步消息处理。
- **Spring WebFlux**：支持响应式编程模型，实现流式对话。
- **SpringDoc OpenAPI**：提供API文档支持。

## 安装与配置

1. **依赖安装**
   - JDK 1.8+
   - Maven
   - Redis
   - MongoDB
   - RabbitMQ

2. **项目构建**
   ```bash
   mvn clean install
   ```

3. **配置文件**
   - 修改 `application.properties` 或 `application.yaml` 文件配置数据库、Redis、MongoDB等连接信息。

4. **数据库初始化**
   - 执行 `src/main/resources/db/hmdp.sql` 文件初始化数据库结构。

## 使用说明

1. **启动项目**
   ```bash
   java -jar hm-dp.jar
   ```

2. **访问接口文档**
   - 项目启动后，访问 `/swagger-ui.html` 或 `/v3/api-docs` 查看API文档。

3. **主要接口**
   - `/user/login`：用户验证码登录。
   - `/user/loginByWD`：用户密码登录。
   - `/shop/{id}`：根据ID查询商铺信息。
   - `/voucher/seckill`：新增秒杀优惠券。
   - `/xiaozhi/chat`：与AI助手进行对话。

## 项目结构说明

- **Controller层**：提供REST API接口，处理用户请求。
- **Service层**：封装业务逻辑，处理具体业务操作。
- **Mapper层**：与数据库交互，进行CRUD操作。
- **DTO/VO**：用于数据传输和返回格式统一。
- **Utils**：封装工具类，如Redis操作、验证码生成、分布式锁等。

## 扩展与定制

- 可通过添加新的Controller、Service、Mapper实现新的业务模块。
- 通过修改`DPAgent`接口与实现类，可扩展AI助手的功能。

## 开源协议

该项目采用 Apache 2.0 协议，详情请参阅 [LICENSE](LICENSE) 文件。

## 贡献指南

欢迎贡献代码，请提交PR或Issue至 [项目地址](https://gitee.com/Nan_mungui/back-hmdp)。贡献前请确保通过测试并遵循代码规范。