구조 경계 점검 루프

프로젝트 구조 응집도

client, server, shared를 나누는 기준은 폴더 이름보다 의존성 방향과 배포 단위입니다.

1 domain

기능 경계 우선 결정

auth, user, product처럼 함께 바뀌는 모델과 규칙을 같은 모듈에 둡니다.

2 shared

공유 패키지는 계약만 노출

DTO, 상수, 순수 유틸만 두고 브라우저나 서버 런타임 의존성은 넣지 않습니다.

3 deploy

빌드와 배포 단위를 분리

client와 server는 독립적으로 테스트, 빌드, 컨테이너화할 수 있어야 합니다.

client화면, 훅, API 호출 래퍼
server컨트롤러, 서비스, 저장소
shared런타임 중립 타입과 상수
root워크스페이스와 공통 스크립트