# hmdq-study

**Repository Path**: palop/hmdq-study

## Basic Information

- **Project Name**: hmdq-study
- **Description**: 黑马点评项目学习
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-27
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 黑马点评项目

## 1. 项目背景

本项目完成「黑马点评」系列课程开发中的实战篇。高级篇和原理篇未涉及。

### 1.1 项目简介

*   **项目定位**：本地生活服务类电商平台，覆盖餐饮、休闲娱乐、生活服务等场景，提供商户查询、用户评价、优惠领取、秒杀活动等核心功能。

*   **项目来源**：基于黑马程序员「黑马点评」系列课程开发。[视频链接](https://www.bilibili.com/video/BV1cr4y1671t)

### 1.2 核心业务模块

详情可以看网上一篇博客总结：[博客链接](https://blog.csdn.net/qq_66345100/article/details/131986713)

| 模块名称 | 核心功能      |
| -------- |---------------------------------------------------------|
| 用户模块 | **手机号登录 / 注册（短信验证码）**、**每日签到（前端未实现）**、**好友关注**、**共同好友** |
| 商户模块 | 商户列表展示、商户详情、商户分类筛选                                      |
| 点评模块 | 评价发布（文字 + 图片）、**点赞功能及排序** 、**Feed流**                        |
| 优惠模块 | 优惠券发放（满减 / 折扣）、领取限制、核销逻辑、**限时秒杀（防超卖）**                  |
| 搜索模块 | 商户关键词搜索、**距离筛选**|

### 1.3 项目组成

| 文件夹名称 | 模块   |
|-------|------|
| hm-dianping  | 后端代码 |
| nginx-1.18.0  | 前端代码 |



## 2. 项目快速启动

### 2.1 环境准备

*   JDK 1.8+（配置 `JAVA_HOME` 环境变量，验证：`java -version`）
*   MySQL 8.0.x（启动服务，开放 3306 端口，设置 root 密码：`你的 MySQL 密码`）
*   Redis 6.2.x（启动服务，开放 6379 端口，如需密码：在 `redis.conf` 中配置 `requirepass 你的 Redis 密码`）
*   Node.js 14+（前端依赖安装，验证：`node -v`，配套 npm 版本 6+）

同时，下载对应的课程资料，导入数据库等必要的信息。[课程资料]()

### 2.2 源码获取

```
git clone https://github.com/chuoer47/heimadianping.git
cd heimadianping
```

### 2.3 配置修改

需要修改配置文件，配置文件路径：hm-dianping/src/main/resources/application.yaml

### 2.4 项目启动

*  Java后端启动。（注意：Ngxin开启了负载均衡，需要开启两个端口的后端`8081`和`8082`）
*  启动 Nginx：`nginx`，端口号为`8080`
* 开启Redis

## LICENSE
除非另有说明，本仓库的内容采用 CC BY-NC-SA 4.0 许可协议。在遵守许可协议的前提下，您可以自由地分享、修改本文档的内容，但不得用于商业目的。

如果您认为文档的部分内容侵犯了您的合法权益，请联系项目维护者，我们会尽快删除相关内容。