04-技术规范

零、技术栈总览

分层模块	技术	版本要求	说明
前端基础框架	React	19.x	构建前端应用
前端 UI 组件	Ant Design	最新稳定版（6.x）	页面组件与交互控件
前端状态管理	Redux Toolkit	最新稳定版	管理全局状态
前端路由管理	React Router	最新稳定版（v7）	页面路由与导航
前端工程化构建	Vite	最新稳定版	前端开发与打包构建
前端接口通信	Axios	最新稳定版	调用后端 API
后端基础框架	Spring Boot	最新稳定版（4.0.x，当前 4.0.6）	构建后端服务；基于 Spring Framework 7 + Jakarta EE 11
后端数据访问	MyBatis-Plus	3.5.15+（最新稳定版）	数据库访问与 ORM 增强；Spring Boot 4 必须用 mybatis-plus-spring-boot4-starter（boot3 starter 不兼容 Boot 4）
工作流引擎	Flowable	最新稳定版（8.x）	审批流、流程流转；Flowable 8 基于 Spring Framework 7 / Spring Boot 4（7.x 不兼容 Boot 4），用 Jackson 3，需 Jakarta EE 11+ 容器（Tomcat 11+）
缓存服务	Redis	最新稳定版（8.x）	缓存、会话、分布式能力
报表打印	JXLS	最新稳定版（3.x）	基于 Excel 模板生成报表
Excel 导入导出	FastExcel	最新稳定版（1.3.x）	Excel 数据导入导出（EasyExcel 已归档，FastExcel 为原作者维护的继任分支，坐标 cn.idev.excel:fastexcel）
关系型数据库	MySQL	8.x	核心业务数据存储
数据库 schema 迁移	Flyway (flyway-core + flyway-mysql)	最新稳定版（由 Spring Boot BOM 管理，当前 11.x）	sql/migrations/V_n__*.sql 顺序 apply；Spring Boot 启动时自动应用
接口风格	RESTful API	统一规范	前后端接口设计规范
权限认证	Spring Security / JWT	最新稳定版	登录认证、权限控制
API 文档	OpenAPI / Swagger	最新稳定版	接口文档与调试
项目构建管理	Gradle (Kotlin DSL)	最新稳定版（8.x / 9.x）	Java 项目依赖与构建；统一用 Gradle Wrapper (./gradlew)，构建脚本 build.gradle.kts
JDK 运行环境	Java	21 LTS	Spring Boot 4 基线 Java 17+；选 21 LTS 以覆盖全栈组件官方支持区间（FastExcel/POI 文档支持至 21）
部署容器	Docker	最新稳定版	容器化部署
Web 服务器 / 反向代理	Nginx	最新稳定版	前端托管、反向代理、负载分发
日志管理	Logback	默认集成 / 最新稳定版	应用日志输出
对象映射工具	MapStruct	最新稳定版	DTO / VO / Entity 转换
工具类库	Hutool / Apache Commons	最新稳定版	常用工具方法支持

本表由 scope-lock 锁定。后续所有规范基于此表推导。