# 🏗️ 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 프로젝트 방에 온보딩할 때 이 템플릿을 채워서 사용

---

## 사용법

1. 새 프로젝트 온보딩 시 이 템플릿을 복사
2. 각 섹션의 `{placeholder}`를 실제 값으로 채움
3. 완성된 문서를 KHub에 등록 + Claude 프로젝트 파일에 추가
4. 필요 시 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가 코드 리뷰/생성 시 자동 참조
```

## FAQ


---
출처: https://bizspring.ai/kb/ref/khub/common-ddd-확장-템플릿-java-php-프로젝트-온보딩용 · 최종 갱신 2026-08-24T11:53:44.5731+00:00