---
description: 编码规范约定
globs: src/**/*.java
alwaysApply: false
---

# 编码规范

## 命名规范

- 类名：UpperCamelCase（如 `BaseDBService`）
- 方法名/变量名：lowerCamelCase（如 `getUserById`）
- 常量：UPPER_SNAKE_CASE（如 `ORDER_STATUS_PENDING`）
- 包名：全小写（如 `com.example.project`）

## RESTful API 接口规范

- 不带参数的查询请求用 `GET` 方法，带参数的查询请求用 `POST` 方法
- 非查询请求全部使用 `POST` 方法
- 所有 HTTP 请求的响应数据都用 `JSON` 格式返回
- 统一响应格式 `ResponseRes<T>`：

```json
{"rescode":"","resmsg":"","resdata":"","timestamp":0}
```

## 其他注意事项

1. **参数校验**：使用 Hibernate Validator + 自定义 `IntInitOrRange` / `StrNullOrSize` 等注解