Vibe Coding 后端指南

// contracts.ts
interface CreateUserRequest {
  email: string
  name: string
  role: 'admin' | 'member'
}

interface CreateUserResponse {
  id: string
  email: string
  name: string
  role: 'admin' | 'member'
  createdAt: string  // ISO 8601
}

interface ApiError {
  code: string        // 'USER_EXISTS' not 'error'
  message: string     // human-readable
  field?: string      // which input field caused it
}

-- migrations/001_create_users.sql
CREATE TABLE users (
  id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  email       TEXT NOT NULL UNIQUE,
  name        TEXT NOT NULL,
  role        TEXT NOT NULL DEFAULT 'member'
              CHECK (role IN ('admin', 'member')),
  created_at  TIMESTAMPTZ NOT NULL DEFAULT now(),
  updated_at  TIMESTAMPTZ NOT NULL DEFAULT now()
);

-- 按创建时间排序的查询最多 -> 索引
CREATE INDEX idx_users_created_at ON users (created_at DESC);

Prompt 示例:

实现 POST /api/users 端点:
- 入参: CreateUserRequest (见 contracts.ts)
- 返回: 201 + CreateUserResponse
- 错误: 409 if email exists (code='USER_EXISTS')
- 用 Hono 框架, Zod 校验入参
- 参数化查询, 不要拼 SQL
- 返回时不要暴露内部字段 (如 updated_at)
- 加 structured log: method, path, status, duration_ms, request_id

// app.ts - 人工组装，AI 辅助
import { Hono } from 'hono'
import { logger } from 'hono/logger'
import { cors } from 'hono/cors'
import { authMiddleware } from './middleware/auth'
import { errorHandler } from './middleware/error'
import { usersRoute } from './routes/users'

const app = new Hono()

app.use('*', logger())
app.use('*', cors(corsConfig))
app.use('*', errorHandler)
app.use('/api/*', authMiddleware)

app.route('/api/users', usersRoute)

必须测试的场景:
✅ 正常路径: 创建用户 -> 201 + 正确响应
✅ 重复 email -> 409 + error code
✅ 缺少必填字段 -> 400 + field 指向缺失字段
✅ 无认证 -> 401
✅ 无权限 (member 创建 admin) -> 403
✅ 超长 name -> 400 (如果有限制)
❌ 不要测框架本身 (Hono 的路由)
❌ 不要测第三方库 (Zod 的校验)