16-coding-standards.md 868 B
16. Coding Standards
为AI代理定义最小但关键的标准。专注于防止常见错误的项目特定规则。这些将被开发代理使用。
16.1 关键全栈规则
类型共享： 始终在packages/shared中定义类型并从那里导入 API调用： 永远不要直接进行HTTP调用 - 使用服务层 环境变量： 仅通过配置对象访问，永远不要直接使用process.env 错误处理： 所有API路由必须使用标准错误处理程序 状态更新： 永远不要直接改变状态 - 使用适当的状态管理模式
16.2 命名约定
| 元素 | 前端 | 后端 | 示例 |
|---|---|---|---|
| 组件 | PascalCase | - | UserProfile.tsx |
| Hooks | camelCase带'use' | - | useAuth.ts |
| API路由 | - | kebab-case | /api/user-profile |
| 数据库表 | - | snake_case | user_profiles |