server-architecture
Installation
SKILL.md
SvelteKit Server Layer Architecture
추천 기술 스택
| 영역 | 추천 | 이유 |
|---|---|---|
| ORM | Drizzle ORM | 경량, 타입 안전, SQL-like API로 직관적 |
| 인증 | better-auth | 세션 관리, OTP, 소셜 로그인 등 내장 |
프로젝트 상황에 따라 다른 도구를 선택할 수 있다. 아래 아키텍처 패턴은 ORM에 무관하게 적용된다.
왜 Active Record인가
SvelteKit은 DI 컨테이너를 제공하지 않는다. Active Record 패턴으로 도메인 로직을 모델에 캡슐화하면:
- 모델이 자체적으로 ORM을 import하므로 DI 없이도 응집도 높은 코드가 된다.
+server.ts에서는 도메인 모델의 메서드만 호출한다. SQL/ORM 코드가 라우트 파일에 노출되지 않는다.- 테이블 단위로 책임이 분리되어 변경 영향 범위가 명확하다.