# 开发规范

> 适用范围: 所有产研开发项目 | 维护人: 梁思筑（architect）

## 一、命名约定
- 文件: kebab-case（user-service.ts）
- 变量/函数: camelCase（getUserById）
- 类/接口: PascalCase（UserService）
- 常量: UPPER_SNAKE_CASE（MAX_RETRY_COUNT）

## 二、提交规范
```
<type>(<scope>): <subject>
```
Type: feat | fix | docs | style | refactor | test | chore

## 三、测试规范
- 单元测试覆盖率 ≥ 80%
- 关键路径 100% 覆盖
- 每个 PR 必须附带测试

## 四、Code Review 检查清单
| 检查项 | 说明 |
|--------|------|
| 命名清晰 | 变量/函数名能自解释 |
| 无重复代码 | DRY 原则 |
| 无硬编码 | 配置项外置 |
| 错误处理 | 异常路径已覆盖 |
| 安全 | 无 SQL 注入/XSS/敏感信息泄露 |
| 性能 | 无 N+1 查询/不必要的循环 |

## 五、技术栈推荐
| 类别 | 推荐 |
|------|------|
| 前端 | React/Next.js (TS) |
| 后端 | Node.js/Python |
| 数据库 | PostgreSQL |
| 缓存 | Redis |
| CI/CD | GitHub Actions |

> 引入新技术栈需 architect 评估后方可使用。