레이어드 · 헥사고날 · 클린 아키텍처

// ━━━ 나쁜 예: 모든 계층이 섞임 ━━━
// app/api/users/route.ts
export async function POST(req: Request) {
  const data = await req.json();
  if (!data.email.includes("@")) return new Response("bad", { status: 400 });
  const { rows } = await pg.query("INSERT INTO users ...", [data.email]);
  await sendWelcomeEmail(data.email);    // SMTP 호출
  return Response.json(rows[0]);
}
// → HTTP·검증·DB·이메일이 한 함수. 테스트 불가능, 재사용 불가.

// ━━━ 좋은 예: 계층 분리 ━━━

// domain/user.ts  (순수 도메인 — 어떤 DB·HTTP도 모름)
export class User {
  constructor(public email: string, public name: string) {
    if (!email.includes("@")) throw new Error("invalid email");
  }
}

// application/use-cases/register-user.ts
export async function registerUser(
  email: string, name: string,
  repo: UserRepository,
  notifier: Notifier,
): Promise<User> {
  const user = new User(email, name);
  await repo.save(user);
  await notifier.welcome(user);
  return user;
}

// infrastructure/db/postgres-user-repo.ts
export class PgUserRepository implements UserRepository {
  async save(u: User) { await pg.query("INSERT ...", [u.email, u.name]); }
}

// app/api/users/route.ts (얇은 HTTP 어댑터)
export async function POST(req: Request) {
  const body = await req.json();
  const user = await registerUser(body.email, body.name, pgRepo, smtpNotifier);
  return Response.json(user);
}