全栈工程化实践：Monorepo 架构演进与构建权衡

my-fullstack-monorepo/
├── apps/
│   ├── web/               # 前端应用 (Next.js / Vite + React)
│   └── api/               # 后端应用 (NestJS / Hono / Fastify)
├── packages/
│   ├── contracts/         # 前后端共享协议 (Zod Schema / DTO)
│   ├── ui/                # 共享 UI 组件库
│   ├── tsconfig/          # 共享 TypeScript 配置
│   └── eslint-config/     # 共享代码规范
├── package.json
├── pnpm-workspace.yaml
└── turbo.json

packages:
  - 'apps/*'
  - 'packages/*'

import { z } from 'zod';

export const UserSchema = z.object({
  id: z.string().uuid(),
  name: z.string().min(2),
  email: z.string().email(),
  role: z.enum(['admin', 'member']),
});

export const CreateUserRequestSchema = UserSchema.omit({ id: true });

export type User = z.infer<typeof UserSchema>;
export type CreateUserRequest = z.infer<typeof CreateUserRequestSchema>;

import { CreateUserRequestSchema, CreateUserRequest } from '@repo/contracts';

export async function createUserHandler(req: Request) {
  const body = await req.json();
  // 运行时校验
  const result = CreateUserRequestSchema.safeParse(body);
  
  if (!result.success) {
    return new Response(JSON.stringify(result.error), { status: 400 });
  }

  const payload: CreateUserRequest = result.data;
  // 业务逻辑处理...
}

import { User, CreateUserRequestSchema } from '@repo/contracts';

export async function fetchUserProfile(userId: string): Promise<User> {
  const res = await fetch(`/api/users/${userId}`);
  return res.json();
}

{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
    },
    "test": {
      "dependsOn": ["build"],
      "inputs": ["src/**/*.tsx", "src/**/*.ts", "test/**/*.ts"]
    },
    "lint": {},
    "dev": {
      "cache": false,
      "persistent": true
    }
  }
}

# 仅对与 main 分支有差异的应用执行 build
pnpm turbo run build --filter=...[origin/main]