# 编码标准和测试策略

## 版本信息
| 版本 | 日期 | 描述 | 作者 |
|------|------|------|------|
| 2.4 | 2025-09-20 | 与主架构文档版本一致 | Winston |
| 2.5 | 2025-09-24 | 更新技术栈信息，修正数据库类型 | Winston |
| 2.6 | 2025-09-28 | 添加.roo/rules规范文件引用 | Claude Code |

## 详细开发规范

本项目遵循详细的开发规范，所有规范文件位于 `.roo/rules/` 目录中。详细规范请参考：[开发规范文档](./development-standards.md)

### 主要规范类别
- **基础规范**: 项目结构、技术栈、模块化组织
- **API开发规范**: DTO定义、数据库操作、依赖注入
- **高级开发规范**: OpenAPI、RPC调用、日志管理
- **实体和CRUD规范**: 实体定义、前端开发、CRUD实现

## 现有标准合规性
- **代码风格**: TypeScript严格模式，一致的缩进和命名
- **linting规则**: 已配置ESLint，支持TypeScript和React
- **测试模式**: 完整的测试框架已配置（Vitest + Testing Library + Playwright）
- **文档风格**: 代码注释良好，测试策略文档完整

## 增强特定标准
- **测试框架**: 使用Vitest + Testing Library + hono/testing + Playwright
- **测试位置**: `__tests__` 文件夹与源码并列
- **覆盖率目标**: 核心业务逻辑 > 80%
- **测试类型**: 单元测试、集成测试、E2E测试

## 关键集成规则
- **现有API兼容性**: 确保测试不破坏现有API契约
- **数据库集成**: 使用测试数据库，避免污染生产数据
- **错误处理**: 测试各种错误场景和边界条件
- **日志一致性**: 测试日志格式和错误信息