# campsite

**Repository Path**: ryan91/campsite

## Basic Information

- **Project Name**: campsite
- **Description**: 露营
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-02
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 森屿湖露营基地预约管理系统

后端工程（SpringBoot 3.2 + MySQL + Redis + MyBatis-Plus），支撑管理后台与小程序接口。

## 技术栈

- JDK 17
- Spring Boot 3.2.x
- MySQL 8.0（utf8mb4）
- MyBatis-Plus 3.5.x（Spring Boot 3）
- Redis 7.x、Redisson（分布式锁）
- Hutool、Lombok

## 快速开始

1. **环境**：JDK 17、Maven 3.6+、MySQL 8.0、Redis 7.x。
2. 创建数据库并执行建表脚本：
   ```bash
   mysql -u root -p -e "CREATE DATABASE senyuhu DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;"
   mysql -u root -p senyuhu < src/main/resources/schema.sql
   ```
3. 修改 `src/main/resources/application.yml` 中数据源、Redis、文件上传路径等配置。
4. 启动：
   ```bash
   mvn spring-boot:run
   ```
   若编译报错「无效的标记: --release」，请确保使用 JDK 17（`JAVA_HOME` 指向 JDK 17 再执行 `mvn compile`）。
5. 接口前缀：`http://localhost:8080/api`
   - 后台：`/api/admin/**`（需登录后 Header 带 `token`，登录接口除外）  
   - 小程序：`/api/mini/**`（预留）

## 主要接口

| 模块     | 说明 |
|----------|------|
| 员工     | `/admin/employee/login` 登录；`/admin/employee/list`、add、edit、delete |
| 会员     | `/admin/member/list`、detail、update-status（手机号脱敏） |
| 订单     | `/admin/order/list`、detail、verify（核销）、add-invite |
| 预约     | `/admin/appointment/add`、add-invite（防重复+分布式锁防超卖） |
| 退款     | `/admin/refund-order/list`、audit |
| 价格模版 | `/admin/price-template/list`、add、edit、delete |
| 商品     | `/admin/product/calc-price` |
| 场地     | `/admin/venue-category/list`、add |
| 场景     | `/admin/scene-category/list`；`/admin/scene-config/upload`、delete、list |
| 轮播图   | `/admin/carousel/list`、add、sort、delete |
| 文件     | `/admin/file/upload` |
| 运营数据 | `/admin/dashboard/today-trade`、trade-trend、appointment-calendar、appointment-detail |

## 包结构

- `com.senyuhu.admin`：controller、service、mapper
- `com.senyuhu.entity`：DO 数据库实体
- `com.senyuhu.entity.dto`：请求参数（DTO）
- `com.senyuhu.entity.vo`：返回对象（VO）
- `com.senyuhu.framework.config`：Web、MyBatis-Plus、Redis、Security（Token 拦截）
- `com.senyuhu.framework.common`：Result、异常处理、MD5、核销码、脱敏、订单状态工具
- `com.senyuhu.framework.constant`：状态码、路径、订单常量
- `com.senyuhu.mini`：小程序预留