# base-demo-01

**Repository Path**: zdp666/base-demo-01

## Basic Information

- **Project Name**: base-demo-01
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mloongbld_hwzjl_web

海外电商后台管理系统后端服务，基于 Spring Boot 3 + MyBatis-Plus + Sa-Token 构建。

## 技术栈

| 组件 | 版本 |
|------|------|
| Java | 21 |
| Spring Boot | 3.5.13 |
| MyBatis-Plus | 3.5.15 |
| Sa-Token (JWT Simple) | 1.40.0 |
| MySQL | 8.0.33 |
| Druid | 1.2.23 |
| Redisson | 3.40.2 |
| SpringDoc OpenAPI | 2.8.17 |

**工具库:** Lombok, Hutool 5.8.34, fastjson2, Guava 33.4.0, Commons Lang3/Collections4, TTL 2.14.5

## 项目结构

```
src/main/java/com/mloongbld/hwzjl/
├── aspect/          # 请求日志、防重提交切面
├── common/
│   ├── annotation/  # @RepeatSubmit
│   ├── base/        # R、BaseEntity、Query、ParamConvert
│   ├── constant/    # 常量、错误码
│   ├── exception/   # 业务异常 + 全局异常处理
│   └── utils/       # Redis/JSON/断言/Servlet/Spring/字符串/TTL/国际化
├── config/          # 线程池、MyBatis-Plus、Redisson、i18n、OpenAPI、Sa-Token、Jackson
├── controller/      # 控制器
├── dao/             # Mapper 接口
├── entity/          # 实体、DTO、VO
├── handler/         # 自动填充、缓存模板
└── service/         # 服务接口及实现
```

## 快速开始

```bash
git clone git@114.116.239.68:/data/git/hwzjl/shop-java-front.git
# 修改 src/main/resources/application-dev.yml 中数据库/Redis 连接信息
mvn spring-boot:run    # 默认 dev 环境，启动后访问 http://localhost:8080
```

## 多环境

| Profile | 端口 | 数据库 | Redis DB |
|---------|------|--------|----------|
| dev（默认） | 8080 | mloongbld_hwzjl | 10 |
| test | 8081 | mloongbld_hwzjl_test | 11 |
| prod | 8080 | mloongbld_hwzjl | 10 |

接口文档: `http://localhost:8080/swagger-ui/index.html`

## 主要特性

- **Sa-Token JWT 认证**: JWT Simple 模式，token 状态由 Redis 维护，支持强制注销；路径拦截 + 注解鉴权（`@SaCheckLogin`/`@SaCheckRole`/`@SaCheckPermission`），异常统一由 GlobalExceptionHandler 兜底
- **认证接口**: 账号密码/邮箱验证码注册与登录，邮箱验证码 Redis 缓存（5 分钟有效）
- **统一响应**: `R<T>` 封装，`R.ok(data)` / `R.failed(msg)`
- **全局异常处理**: 业务异常（i18n）、参数校验、数据库异常、Sa-Token 鉴权异常统一拦截
- **MyBatis-Plus**: 分页 + 乐观锁，逻辑删除字段 `delFlag`，驼峰自动映射
- **Druid**: 连接池 + SQL 监控
- **Redisson**: 分布式锁 + Redis 操作封装（`RedisUtils`）
- **线程池**: Spring 托管 + TTL 包装，`@Async` 可透传上下文
- **防重提交**: `@RepeatSubmit` 注解，基于 Redis + AOP，支持 i18n 消息
- **多语言国际化**: 覆盖东南亚市场（简体中文、英文、泰语、越南语），请求头 `lang` 或参数 `?lang=en_US` 切换