写规范

## 错误处理

在代码库中使用正确的错误处理。

## 错误处理

所有 API 接口返回错误时用这个格式：

```json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "邮箱不能为空"
  }
}
```

使用 `src/lib/errors.ts` 里的 `AppError` 类。不要直接 throw Error 对象。

例子：

```typescript
// 错误
throw new Error('用户不存在');

// 正确
throw new AppError('USER_NOT_FOUND', '用户不存在', 404);
```

.trellis/spec/
├── frontend/
│   ├── index.md        # 前端主要规范
│   ├── components.md   # 组件模式
│   └── state.md        # 状态管理
├── backend/
│   ├── index.md        # 后端主要规范
│   ├── api.md          # API 设计
│   └── database.md     # 数据库规范
└── guides/
    └── index.md        # 通用思维指南

## 数据库查询

用 `src/db/query.ts` 的查询构建器，别写原生 SQL。
ORM 模型在 `src/db/models/`。

## 组件结构

按这个模式（来自 `src/components/UserCard.tsx`）：

```tsx
interface UserCardProps {
  user: User;
  onEdit?: () => void;
}

export function UserCard({ user, onEdit }: UserCardProps) {
  // 组件逻辑
}
```

Props 接口写在前面，然后是命名导出。组件不用默认导出。

// 弱
你可以用 Redux 或 Zustand 做状态管理。

// 强
用 Zustand 做状态管理。Store 定义放 `src/stores/`。
这个项目不用 Redux。

## API 路由

必须用 Zod schema 验证输入。

```typescript
// 错误 - 没验证
app.post('/users', (req, res) => {
  const user = req.body; // 没验证！
  db.users.create(user);
});

// 正确 - 先验证
app.post('/users', (req, res) => {
  const result = CreateUserSchema.safeParse(req.body);
  if (!result.success) {
    throw new ValidationError(result.error);
  }
  db.users.create(result.data);
});
```