# 项目概述
这是一个基于 Spring Boot 3.2 + Java 21 的电商订单管理系统。

# 技术栈
- 框架: Spring Boot 3.2
- 语言: Java 21
- 构建工具: Maven 3.9
- 数据库: MySQL 8.0 + MyBatis-Plus
- 缓存: Redis (Lettuce)
- 消息队列: RocketMQ
- 测试: JUnit 5 + Mockito

# 项目结构 (标准分层架构)
- src/main/java/com/acme/order/
  - controller/   - REST 接口层
  - service/      - 业务逻辑层
  - service/impl/ - 业务逻辑实现
  - mapper/       - MyBatis 数据访问层
  - model/
    - entity/     - 数据库实体
    - dto/        - 数据传输对象
    - vo/         - 视图对象
  - config/       - 配置类
  - common/       - 公共工具和常量

# 设计决策
- 使用 MyBatis-Plus 而非 JPA/Hibernate
  原因：团队更熟悉 SQL 优化，MyBatis-Plus 提供灵活的 SQL 控制能力
- 所有接口返回统一响应体 Result<T>，不直接返回实体
  原因：前后端约定统一的数据格式，便于全局异常处理
- 分布式 ID 使用雪花算法 (Snowflake)，不使用数据库自增
  原因：分库分表场景下保证 ID 全局唯一且有序

# 常用命令
- 编译打包: `mvn clean package -DskipTests`
- 运行全部测试: `mvn test`
- 运行单个测试类: `mvn test -Dtest=OrderServiceTest`
- 本地启动: `mvn spring-boot:run -Dspring-boot.run.profiles=dev`
- 代码格式化: `mvn spotless:apply`

# 代码规范
- Controller 层只做参数校验和结果封装，不写业务逻辑
- Service 接口和实现分离
- 所有数据库实体继承 BaseEntity
- 方法命名: findXxx / saveXxx / updateXxx / removeXxx
- 提交信息遵循 Conventional Commits 规范

# Git 工作流
- 分支命名: feature/xxx, fix/xxx, chore/xxx
- 提交前必须通过编译和 checkstyle 检查

# 项目指南
@README.md
@docs/architecture.md
@docs/database-design.md
@docs/api-conventions.md

# 代码风格
代码提交前会自动运行 `mvn spotless:apply`，无需手动关注格式问题。

IMPORTANT: 所有数据库操作必须通过 MyBatis-Plus 的 Mapper 接口，禁止在 Service 层拼接 SQL 字符串。

IMPORTANT: 不要修改 generated/ 目录下的任何文件，这些是自动生成的代码。

# 注意事项
- 权限校验通过自定义注解 @RequirePermission 在 AOP 中统一处理
  如果要新增需要权限的接口，只需在 Controller 方法上加注解即可
- 测试环境使用 H2 内存数据库，运行测试前不需要启动外部数据库
- legacy/ 包下的代码正在迁移中，新功能不要引用这个包

# 项目概述
这是 Acme 公司的内部订单管理系统，基于 Spring Boot 3.2 + Java 21。

# 技术栈
- Spring Boot 3.2, Java 21, Maven 3.9
- 数据库: MySQL 8.0 + MyBatis-Plus 3.5
- 缓存: Redis (Spring Data Redis + Lettuce)
- 消息: RocketMQ 5.x
- 测试: JUnit 5 + Mockito + H2

# 常用命令
- 编译: `mvn clean compile`
- 打包: `mvn clean package -DskipTests`
- 全部测试: `mvn test`
- 本地运行: `mvn spring-boot:run -Dspring-boot.run.profiles=dev`
- 格式化: `mvn spotless:apply`

# 项目结构 (com.acme.order)
- controller/   - REST 接口，只做参数校验和结果封装
- service/      - 业务接口定义
- service/impl/ - 业务逻辑实现
- mapper/       - MyBatis 数据访问层
- model/entity/ - 数据库实体 (继承 BaseEntity)
- model/dto/    - 请求/响应数据传输对象
- model/vo/     - 视图对象

# 代码规范
- Controller 不写业务逻辑，Service 接口与实现分离
- 所有接口返回 Result<T> 统一响应体
- 方法命名: findXxx / saveXxx / updateXxx / removeXxx
- 提交信息遵循 Conventional Commits

# 详细文档
@docs/architecture.md
@docs/database-design.md
@docs/deployment.md

# Git 工作流
- 分支: feature/xxx, fix/xxx, chore/xxx
- PR 必须通过 CI 检查后才能合并

# 注意事项
IMPORTANT: 数据库操作通过 MyBatis-Plus Mapper，禁止拼接 SQL 字符串
IMPORTANT: generated/ 包是自动生成的，不要手动修改
- legacy/ 包下的代码正在迁移，新功能不要依赖
- 分布式 ID 使用雪花算法，不要用数据库自增 ID