백엔드 명령은 backend/, 프론트엔드 명령은 frontend/에서 실행한다.
| 목적 | 명령 |
|---|---|
| 백엔드 빌드 + 전체 테스트 (CI와 동일) | ./gradlew build |
| 백엔드 테스트만 | ./gradlew test |
| 특정 테스트 | ./gradlew test --tests 'com.restless.drop.*' |
| 프론트엔드 빌드 (CI와 동일) | npm run build |
| 아키텍처 검사 (모듈 경계) | ./gradlew test --tests 'com.restless.architecture.*' |
| 드롭 수용 테스트 (블랙박스) | ./gradlew test --tests 'com.restless.drop.acceptance.*' |
| 동시성 테스트 (드롭·결제) | ./gradlew test --tests 'com.restless.drop.*' --tests 'com.restless.payment.*' (재고 1개에 100명, 같은 키 동시 요청, 입장 작업 동시 실행, 승인 동시 요청 등) |
| 부하 테스트 시드 (perf DB) | 레포 루트에서 perf/seed/seed.sh --scale base --profile perf (perf/seed) |
| 부하 테스트 | TBD |
JUnit 5, Spring Boot Test, MySQL Testcontainers, Mockito, k6. 필요하면 Redis Testcontainers.
| 유형 | 목적 |
|---|---|
| Concurrency | 재고, 주문 경쟁 조건 검증 |
| Load | 목표 부하에서 지속 성능 |
| Stress | 한계와 병목 탐색 |
| Spike | 판매 시작 순간 대량 유입 |
| Fault Injection | 장애 중 거래 정합성 |
| Soak | 장시간 자원, 성능 안정성 |
- 재고 1개에 100명 동시 예약
- 재고 1,000개에 2,000명 동시 예약
- 같은 사용자가 여러 탭에서 구매
- 같은 멱등성 키 중복 전송
- SKU별 재고 경쟁
- 예약 만료와 PG 승인 시작 경합
- 환불 완료와 신규 구매 경합
- 다중 서버에서 중복 입장, 중복 작업
각 테스트는 관련 불변식 ID(invariants.md)를 명시한다.
backend/src/test/java/com/restless/drop/acceptance/는 드롭 API 계약(drop.md)의 완료 기준이다.
- 블랙박스: 드롭 구현 클래스를 import하지 않고 실제 HTTP 서버(임의 포트)와 DB만 보고 판정한다. 구현이 바뀌어도 테스트는 바뀌지 않는다.
- 매 테스트가 끝나면
backend/src/test/resources/harness/drop-invariants.sql의 불변식(초과 판매, 재고 합계, 중복 주문 등)을 전부 검사한다. 위반이 1건이라도 있으면 실패다. - 시간에 따라 도는 작업(만료, 입장)은 빈 이름으로 직접 실행한다:
dropReservationExpiryJob.runOnce(),dropQueueAdmissionJob.runOnce(). - 테스트가 계약과 다르면 테스트를 고치지 말고 계약과 테스트를 함께 바꾸는 PR을 따로 연다.
backend/build.gradle의 test 작업이 정하는 JVM 설정이다. 모든 테스트에 적용된다.
| 설정 | 값 | 이유 |
|---|---|---|
restless.auction.scheduler.enabled, restless.payment.reconcile.enabled, restless.drop.expiry.enabled, restless.drop.queue.scheduler.enabled, restless.fanmeeting.worker.enabled |
false |
주기 작업이 다른 테스트의 데이터 준비와 겹치지 않게 한다. 작업 빈은 남아 있으므로 해당 테스트가 직접 호출하거나 @SpringBootTest(properties)로 다시 켠다 |
user.timezone |
UTC |
JDBC Timestamp로 넣은 테스트 데이터와 JPA TIMESTAMP_UTC 컬럼이 호스트 시간대와 상관없이 같은 시각을 가리키게 한다 |
spring.test.context.cache.maxSize |
4 |
캐시된 Spring 컨텍스트마다 DB 연결이 남는다. 전체 실행 중 MySQL 컨테이너가 메모리 부족(OOMKilled, exit 137)으로 죽은 적이 있어 개수를 제한한다 |
테스트 작성 시 주의:
- 드롭 대기열은 기본으로 켜져 있다(
restless.drop.queue.required=true). 대기열을 검증하지 않는 드롭 테스트는restless.drop.queue.required=false를 명시한다. - 결제 흐름 테스트가 가짜 결제 결과 Handler를 쓸 때는 실제 Handler와 같은 빈 이름(예:
dropPaymentResultHandler)으로 등록하고 그 테스트 클래스에만spring.main.allow-bean-definition-overriding=true를 준다. 같은 결제 대상에 Handler가 둘이면 운영 코드의 중복 검사가 컨텍스트를 실패시킨다.
- 최신
dev를 합친 상태에서./gradlew build를 돌린다. CI는 PR 브랜치가 아니라 "dev에 합친 결과"를 빌드한다. 각자 통과한 두 변경이 합쳐서 깨질 수 있다 (예: enum 끝의;, 기본값이 바뀐 설정). - 다른 PR 위에 쌓은 PR은 앞 PR이 머지되면 dev를 다시 합치고 빌드한다.
- PG 대량 부하 테스트에는 실제 토스 API가 아니라 Fake/Mock PG를 쓴다.
- 테스트를 끄거나 단언을 약하게 해서 빌드를 통과시키지 않는다.
- 실행하지 않은 테스트를 통과했다고 보고하지 않는다.