# 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` |