지식센터 / 레퍼런스

🏗️ DDD 확장 템플릿 — Java/PHP 프로젝트 온보딩용

# DDD 확장 템플릿 — Java/PHP 프로젝트용 > 템플릿 v1.0 | 2026-02-23 > 용도: 사내 Java/PHP 프로젝트를 Claude 프로젝트 방에 온보딩할 때 이 템플릿을 채워서 사용 --- ## 사용법 1. 새 프로젝트 온보딩 시 이 템플릿을 복사 2. 각

핵심 요약

# DDD 확장 템플릿 — Java/PHP 프로젝트용

> 템플릿 v1.0 | 2026-02-23

> 용도: 사내 Java/PHP 프로젝트를 Claude 프로젝트 방에 온보딩할 때 이 템플릿을 채워서 사용

---

사용법

새 프로젝트 온보딩 시 이 템플릿을 복사
각 섹션의 {placeholder}를 실제 값으로 채움
완성된 문서를 KHub에 등록 + Claude 프로젝트 파일에 추가
필요 시 COMMON 용어 사전에 새 용어 추가

---

📖 용어 사전 — {프로젝트명}

> COMMON 용어 사전과 병합하여 사용. 프로젝트 고유 용어만 여기에 등록.

DB 테이블

정규 이름	스키마	용도	DB 위치
{테이블명}	{스키마}	{설명}	{MySQL/PostgreSQL/Oracle 등}

패키지/모듈 구조

패키지 경로	역할	비고
{com.bizspring.xxx.controller}	{API 컨트롤러}
{com.bizspring.xxx.service}	{비즈니스 로직}
{com.bizspring.xxx.repository}	{데이터 접근}
{com.bizspring.xxx.dto}	{데이터 전송 객체}

API 엔드포인트

Method	Path	용도	담당 컨트롤러
{GET}	{/api/v1/xxx}	{설명}	{XxxController}

인프라 별칭

정규 이름	역할	접속 정보
{db-production}	운영 DB	{host:port/dbname}
{db-staging}	스테이징 DB	{host:port/dbname}
{redis-cache}	캐시 서버	{host:port}

외부 연동

서비스명	용도	인증 방식	키 위치
{Naver API}	{검색 연동}	{API Key}	{vault/환경변수/DB}

---

🎯 도메인 트리거 — {프로젝트명}

> 키워드 감지 시 Claude가 자동으로 참조할 문서/코드 매핑

키워드	도메인	자동 조회	참조 대상
{결제, 정산}	{payment}	khub_search("{결제 모듈}", "{PROJECT_CODE}")	{PaymentService, 결제 플로우 문서}
{회원, 인증, 로그인}	{auth}	khub_search("{인증 모듈}", "{PROJECT_CODE}")	{AuthService, JWT 설정}
{로그, 추적, 트래킹}	{tracking}	khub_search("{추적 모듈}", "{PROJECT_CODE}")	{TrackingController, SDK 가이드}
{리포트, 통계, 대시보드}	{report}	khub_search("{리포트 모듈}", "{PROJECT_CODE}")	{ReportService, 집계 쿼리}
{배치, 스케줄, cron}	{batch}	khub_search("{배치 처리}", "{PROJECT_CODE}")	{BatchConfig, 스케줄러 설정}
{배포, CI/CD, 릴리즈}	{deploy}	khub_search("{배포 가이드}", "{PROJECT_CODE}")	{Jenkinsfile, deploy 스크립트}
{설정, config, properties}	{config}	khub_search("{환경 설정}", "{PROJECT_CODE}")	{application.yml, .env}

---

🏆 골든 패턴 — {프로젝트명}

> 새 코드 작성 시 참조할 표준 구조. 기존 코드 중 가장 잘 된 것을 골든으로 지정.

Java 골든 패턴

패턴 유형	골든 파일/클래스	위치	참조 이유
REST Controller	{XxxController.java}	{경로}	{표준 에러 핸들링, Swagger 어노테이션}
Service Layer	{XxxServiceImpl.java}	{경로}	{트랜잭션 관리, 로깅 패턴}
Repository/DAO	{XxxRepository.java}	{경로}	{QueryDSL/JPA 사용 패턴}
DTO/Mapper	{XxxDto.java + XxxMapper.java}	{경로}	{Validation, MapStruct 사용}
Batch Job	{XxxBatchConfig.java}	{경로}	{Spring Batch 표준 구조}
Test	{XxxServiceTest.java}	{경로}	{Mockito + 통합테스트 패턴}

PHP 골든 패턴

패턴 유형	골든 파일	위치	참조 이유
Controller	{XxxController.php}	{경로}	{미들웨어, 에러 핸들링}
Model	{Xxx.php}	{경로}	{Eloquent 관계, 스코프}
Service	{XxxService.php}	{경로}	{비즈니스 로직 분리}
Migration	{create_xxx_table.php}	{경로}	{인덱스, FK 설정 표준}

공통 코딩 컨벤션

항목	규칙
네이밍	{camelCase/snake_case/PascalCase 기준}
에러 핸들링	{GlobalExceptionHandler / try-catch 패턴}
로깅	{SLF4J + Logback / Monolog 기준}
인증	{JWT / Session / OAuth2 기준}
DB 접근	{JPA / MyBatis / Eloquent 기준}

---

⛔ 안티패턴 — {프로젝트명}

> 프로젝트 고유 안티패턴. COMMON AP-01~11과 병행 적용.

ID	규칙	위반 시
{JP-01}	{SQL 직접 작성 금지 → ORM/QueryDSL 사용}	{즉시 중단}
{JP-02}	{운영 DB 직접 접속 금지 → 스테이징에서 검증}	{즉시 중단}
{JP-03}	{하드코딩 설정 금지 → application.yml/환경변수}	{즉시 중단}
{JP-04}	{public 필드 금지 → getter/setter 또는 record}	{코드 리뷰}
{JP-05}	{테스트 없는 배포 금지 → 최소 단위테스트 필수}	{배포 차단}

---

📋 온보딩 체크리스트

프로젝트를 Claude 방에 가져올 때:

- [ ] 프로젝트 개요 문서 작성 (목적, 스택, 팀)
- [ ] 📖 용어 사전 채우기 (DB 테이블, 패키지, API)
- [ ] 🎯 도메인 트리거 매핑 (키워드 → 문서/코드)
- [ ] 🏆 골든 패턴 지정 (각 레이어별 모범 코드)
- [ ] ⛔ 안티패턴 정리 (프로젝트 고유 금기사항)
- [ ] KHub에 등록 (project_code 새로 생성)
- [ ] Claude 프로젝트 파일에 Instructions 추가
- [ ] 메모리 등록 (DDD 핵심 + 프로젝트 고유 규칙)

---

💡 팁: 빠른 온보딩 순서

1일차: 프로젝트 개요 + DB 테이블 목록 → 용어 사전 초안
2일차: 주요 코드 파일 파악 → 골든 패턴 지정
3일차: 팀 컨벤션 + 금기사항 → 안티패턴 정리
4일차: 키워드-문서 매핑 → 도메인 트리거 완성
→ 이후 Claude가 코드 리뷰/생성 시 자동 참조

이 문서를 참조하는 문서 (역링크)

없음

다른 표현: Markdown · JSON · 최종 갱신 2026-08-24