| name | test |
| description | 테스트 대상 코드를 분석하고 프로젝트 테스트 컨벤션에 맞는 테스트 코드를 작성하거나 수정한다. Use when the user asks for tests for a domain entity, service, facade, validator, or calculator, including requests like `/test BookingService.cancel`, `/test Booking 엔티티`, `SeatConflictValidator 테스트 작성`, or similar natural-language asks. |
Test Writer
Workflow
- 대상 클래스, 대상 메서드, 관련 예외와 의존 객체를 읽는다.
- 기존 테스트 파일이 있으면 먼저 읽고 패턴을 따른다.
- 패키지 위치로 테스트 유형을 결정한다.
domain/, application/calculator/: 도메인 단위 테스트application/service/, application/facade/, application/validator/: 서비스 통합 테스트
- 테스트 케이스를 도출한다.
- 코드 작성 전 테스트 케이스 목록을 먼저 짧게 제시한다.
- 프로젝트 컨벤션에 맞춰 테스트 코드를 작성한다.
./gradlew test --tests "<FQCN>" 를 실행하고, 실패하면 수정 후 재실행한다.
Scope
- 사용자가 메서드를 지정하면 그 메서드와 직접 연결된 분기를 우선 테스트한다.
- 사용자가 클래스만 지정하면 모든 public 메서드를 대상으로 본다.
- 메서드 본문뿐 아니라 Repository, Validator, Domain 객체 호출에서 발생하는 예외 분기도 함께 본다.
Conventions
- 파일명은
{ClassName}Test.java 를 사용한다.
- 도메인 테스트는 Fixture만 사용하고 DB를 사용하지 않는다.
- 서비스 통합 테스트는
@ServiceTest 를 사용한다.
- 서비스 통합 테스트의 공통 데이터는
@BeforeEach 에서 준비한다.
- Member는
memberRepository.save(MemberFixture.create()) 방식으로 저장한다.
- Train, Schedule, Booking, Order 등은 TestHelper가 있으면 우선 사용한다.
- 모든 테스트에
// given, // when, // then 주석을 넣는다.
@DisplayName 은 한글 완전한 문장으로 상황 + 기대 결과를 쓴다.- 테스트 메서드명은 영어 스네이크 스타일로 작성한다.
- 테스트 메서드에
@Transactional 을 사용하지 않는다.
- BigDecimal 비교는
isEqualByComparingTo 를 사용한다.
- 예외 검증은 예외 타입과 메시지 또는 에러코드를 함께 확인한다.
- 기존 테스트가 더 강한 로컬 컨벤션을 보여주면 그 패턴을 우선 따른다.
Service Test Setup
서비스 통합 테스트의 기본 공통 셋업은 다음 흐름을 따른다.
member = memberRepository.save(MemberFixture.create())train = trainTestHelper.createKTX()scheduleResult = trainScheduleTestHelper.createDefault(train)- 각 테스트에서 필요한 예매나 주문은
bookingTestHelper, orderTestHelper 등으로 생성한다.
Output
코드 작성 전에는 테스트 케이스 목록을 먼저 제시한다.
- 성공 케이스
- 실패 케이스
- 필요한 경우 경계 케이스
코드 작성 후에는 다음을 함께 보고한다.
- 생성 또는 수정한 테스트 파일 경로
- 추가하거나 수정한 테스트 수
- 실행한 Gradle 명령
- 테스트 통과 여부
References
- docs/testing-guide.md — TrainTestHelper / TrainScheduleTestHelper / BookingTestHelper / OrderTestHelper의 빌더 사용 예제, Fixture 목록,
@ServiceTest가 제공하는 Extension 상세. Helper 사용 패턴이 모호할 때 이 문서를 먼저 읽는다.
- 루트 AGENTS.md의 Layer Rules, Exception 3종, Transaction 규칙은 테스트 대상 코드를 이해할 때 함께 참고한다.
