后端开发入口

本篇是 Forge 后端开发的起点，帮助你建立全局认知并选择正确的学习路径。

技术栈

技术	版本	用途
Java	17	编程语言
Spring Boot	3.2	应用框架
MyBatis-Plus	3.5	ORM 框架
Sa-Token	1.38	认证授权
Flowable	7.0	工作流引擎
MySQL	8.0+	数据库
Redis	6.0+	缓存
Maven	—	构建工具

开发环境要求

工具	版本要求
JDK	17+
Maven	3.8+
MySQL	8.0+
Redis	6.0+
IDEA	2023.2+（推荐）

推荐学习顺序

1. 创建基础业务模块 — 新建模块和依赖配置
2. Entity、DTO、VO 边界 — 理解三层对象模型
3. Mapper XML 查询规范 — 数据访问层写法
4. Service 编排与事务边界 — 业务层和事务管理
5. Controller 校验与统一响应 — 接口层和参数校验
6. 分页查询完整链路 — 前后端分页协议
7. 业务异常与全局异常处理 — 异常体系
8. 后端单元测试基础 — 测试编写

快速启动

# 构建全项目
cd forge-server && mvn clean install -DskipTests

# 启动 admin 服务（默认 localhost:8580）
cd forge-admin-server && mvn spring-boot:run

# 指定环境
mvn spring-boot:run -Dspring-boot.run.profiles=dev

默认登录凭证：admin / 123456

标准分层架构

Controller  → 接收请求、参数校验、返回 RespInfo
    ↓
Service     → 业务编排、事务边界
    ↓
Manager     → [可选] 领域能力封装
    ↓
Mapper      → 数据访问（MyBatis-Plus + XML）

核心约定

• 统一响应：RespInfo.success(data) / RespInfo.error(msg)
• SQL 写在 XML 中：禁止 Service 层用 LambdaQueryWrapper 构建查询
• 租户 ID：业务数据 tenant_id 必须为 1
• 逻辑删除：del_flag = 0 未删除，删除时写主键值
• 循环依赖：Service 间禁止互相注入

参考文档

文档	说明
开发规范	Java 命名与格式化
API 协议	统一响应与分页
数据库规范	表设计与字段类型
安全红线	SQL 注入与日志安全