SKILL.md
참조 프로젝트 구조
아래는 이 프로젝트에서 사용하는 clean architecture 레이아웃입니다. 새 Go 프로젝트를 생성할 때 이 구조를 따르세요.
!tree project-layout/go-clean-arch-v2 -I vendor -L 3
레이어별 역할
cmd/
- 애플리케이션 진입점 (
main.go) - DI 컨테이너 설정, 서버 시작
domain/
- 핵심 비즈니스 엔티티 (struct)
- 리포지토리/유스케이스 인터페이스 정의
- 에러 타입 정의 (
errors.go) - mock 파일은
domain/mocks/에 위치
{도메인명}/ (예: article/, author/)
handler.go: HTTP 핸들러 (Echo 라우팅)usecase.go: 비즈니스 로직 구현repository.go: 데이터 접근 구현*_test.go: 각 파일의 테스트
pkg/
config/: Viper 기반 설정 관리database/: DB 연결 설정middleware/: CORS, 인증 등 공통 미들웨어
의존성 방향
cmd/ → {도메인}/ → domain/
↓
pkg/- domain 패키지는 외부 의존성 없음 (순수 Go)
- 도메인별 패키지는 domain 인터페이스를 구현
- cmd/는 모든 패키지를 조립하는 역할