# 项目开发约定

## 概述

此技能定义了本项目的开发模式和约定。

## 技术栈

- **主要语言**: Java (JDK 25+)
- **架构**: Spring Boot + MyBatis
- **测试位置**: `src/test/java`

## 提交约定

遵循约定式提交格式：

### 使用的前缀

- `feat` - 新功能
- `fix` - 错误修复
- `docs` - 文档变更
- `test` - 测试添加或更新
- `refactor` - 代码重构
- `style` - 代码风格变更（格式化、分号等）
- `chore` - 构建过程或辅助工具变更

### 消息规范

- 保持第一行简洁且有描述性（少于 70 个字符）
- 使用祈使语气（"添加功能"而非"添加了功能"）
- 相关时包含范围：`feat(范围): 描述`

## 代码风格

- 遵循 Java 命名约定
- 使用有意义的变量和方法名
- 为公共 API 添加 Javadoc
- 保持方法专注且单一职责

## 测试

- 为业务逻辑编写单元测试
- 为数据库操作使用集成测试
- 保持测试覆盖率在 80% 以上

## 合并请求规范

- 保持合并请求专注且小
- 为新功能包含测试
- 根据需要更新文档
- 合并前审查代码