后端服务概览
MootingBackend 是基于 Spring Boot 4.0.2 的用户系统后端，提供认证、用户管理、设备绑定、转写记录和行为分析等服务。
项目信息
| 属性 | 值 |
|---|---|
| 项目路径 | app-dev/MootingBackend |
| 框架版本 | Spring Boot 4.0.2 |
| Java 版本 | 17 |
| 数据库 | SQL Server 2022 |
| 默认端口 | 8080 |
核心功能
🔐 用户认证
- 手机号/邮箱注册
- 验证码登录（短信/邮件）
- 密码登录
- JWT Token 管理
📱 设备管理
- 设备注册与绑定
- 多设备支持
- 设备信息查询
📝 转写服务
- 转写记录存储
- 使用量统计（按日/累计）
- 记录查询
📊 行为分析
- 登录事件追踪
- 功能使用统计
- 自定义事件记录
项目结构
MootingBackend/
├── src/main/java/com/mooting/usersystembackend/
│ ├── UserSystemBackendApplication.java # 启动类
│ │
│ ├── config/
│ │ └── SecurityConfig.java # Spring Security 配置
│ │
│ ├── controller/ # REST 控制器
│ │ ├── AuthController.java # 认证接口
│ │ ├── VerifyCodeController.java # 验证码接口
│ │ ├── UserController.java # 用户接口
│ │ ├── DeviceController.java # 设备接口
│ │ ├── TranscriptionController.java # 转写接口
│ │ └── BehaviorController.java # 行为接口
│ │
│ ├── service/ # 业务逻辑层
│ │ ├── AuthService.java # 认证服务
│ │ ├── UserService.java # 用户服务
│ │ ├── UserDeviceService.java # 设备服务
│ │ ├── TranscriptionService.java # 转写服务
│ │ ├── UserBehaviorService.java # 行为服务
│ │ ├── VerifyCodeService.java # 验证码服务
│ │ ├── VerifyCodeStore.java # 验证码存储
│ │ ├── VerifyCodeEmailSender.java # 邮件发送
│ │ └── VerifyCodeSmsSender.java # 短信发送
│ │
│ ├── entity/ # JPA 实体
│ │ ├── User.java
│ │ ├── UserDevice.java
│ │ ├── TranscriptionRecord.java
│ │ ├── TranscriptionUsage.java
│ │ └── UserBehaviorEvent.java
│ │
│ ├── repository/ # 数据访问层
│ │ ├── UserRepository.java
│ │ ├── UserDeviceRepository.java
│ │ ├── TranscriptionRecordRepository.java
│ │ ├── TranscriptionUsageRepository.java
│ │ └── UserBehaviorEventRepository.java
│ │
│ ├── dto/ # 数据传输对象
│ │ ├── auth/
│ │ ├── behavior/
│ │ ├── common/
│ │ ├── device/
│ │ ├── transcription/
│ │ ├── user/
│ │ └── verifycode/
│ │
│ ├── security/ # 安全组件
│ │ ├── JwtUtil.java # JWT 工具类
│ │ └── JwtAuthFilter.java # JWT 过滤器
│ │
│ └── exception/
│ └── GlobalExceptionHandler.java # 全局异常处理
│
├── src/main/resources/
│ └── application.properties # 配置文件
│
└── docs/
├── API测试指南.md # API 测试文档
├── 数据库设计.md # 数据库设计文档
└── apifox-openapi.json # OpenAPI 规范请求处理流程
HTTP Request
│
▼
┌─────────────────────────────────────┐
│ Spring Security │
│ ┌─────────────────────────────┐ │
│ │ JwtAuthFilter │ │
│ │ • 提取 Authorization Header │ │
│ │ • 验证 JWT 签名 │ │
│ │ • 设置 SecurityContext │ │
│ └─────────────────────────────┘ │
└─────────────────┬───────────────────┘
│
▼
┌─────────────────────────────────────┐
│ REST Controller │
│ • 参数验证 │
│ • 调用 Service 层 │
│ • 返回 DTO 响应 │
└─────────────────┬───────────────────┘
│
▼
┌─────────────────────────────────────┐
│ Service Layer │
│ • 业务逻辑处理 │
│ • 事务管理 │
│ • 调用 Repository │
└─────────────────┬───────────────────┘
│
▼
┌─────────────────────────────────────┐
│ Repository (JPA) │
│ • 数据库操作 │
│ • ORM 映射 │
└─────────────────┬───────────────────┘
│
▼
┌─────────────────────────────────────┐
│ SQL Server │
└─────────────────────────────────────┘快速启动
bash
# 进入项目目录
cd MootingBackend
# 编译项目
mvn clean compile
# 启动服务
mvn spring-boot:run
# 或打包后运行
mvn clean package
java -jar target/user-system-backend-0.0.1-SNAPSHOT.jarAPI 端点概览
| 模块 | 路径前缀 | 说明 |
|---|---|---|
| 认证 | /api/auth | 注册、登录、登出 |
| 验证码 | /api/verify-code | 发送和验证 |
| 用户 | /api/users | 用户信息 |
| 设备 | /api/devices | 设备管理 |
| 转写 | /api/transcriptions | 转写记录 |
| 行为 | /api/behavior | 行为统计 |
详细接口文档请查看 API 接口。