kt-event-marketing/develop/test/test-event-fields-integration.md

Event 필드 추가 및 API 통합 테스트 결과서

테스트 개요

• 테스트 일시: 2025-10-29
• 테스트 목적: Event 엔티티에 participants, targetParticipants, roi 필드 추가 및 Frontend-Backend 통합 검증
• 테스트 환경:
  • Backend: Spring Boot 3.x, PostgreSQL
  • Frontend: Next.js 14+, TypeScript
  • Port: Backend(8080), Frontend(3000)

테스트 범위

1. Backend 수정 사항

1.1 Event 엔티티 필드 추가

파일: event-service/src/main/java/com/kt/event/eventservice/domain/entity/Event.java

추가된 필드:

@Column(name = "participants")
@Builder.Default
private Integer participants = 0;

@Column(name = "target_participants")
private Integer targetParticipants;

@Column(name = "roi")
@Builder.Default
private Double roi = 0.0;

추가된 비즈니스 메서드:

• updateTargetParticipants(Integer targetParticipants): 목표 참여자 수 설정
• incrementParticipants(): 참여자 수 1 증가
• updateParticipants(Integer participants): 참여자 수 직접 설정 및 ROI 자동 계산
• updateRoi(): ROI 자동 계산 (private)
• updateRoi(Double roi): ROI 직접 설정

1.2 EventDetailResponse DTO 수정

파일: event-service/src/main/java/com/kt/event/eventservice/dto/response/EventDetailResponse.java

추가된 필드:

private Integer participants;
private Integer targetParticipants;
private Double roi;

1.3 EventService 매퍼 수정

파일: event-service/src/main/java/com/kt/event/eventservice/service/EventService.java

mapToDetailResponse() 메서드에 필드 매핑 추가:

.participants(event.getParticipants())
.targetParticipants(event.getTargetParticipants())
.roi(event.getRoi())

2. CORS 설정 추가

2.1 SecurityConfig 수정

파일: event-service/src/main/java/com/kt/event/eventservice/config/SecurityConfig.java

변경 전:

.cors(AbstractHttpConfigurer::disable)

변경 후:

.cors(cors -> cors.configurationSource(corsConfigurationSource()))

추가된 CORS 설정:

@Bean
public CorsConfigurationSource corsConfigurationSource() {
    CorsConfiguration configuration = new CorsConfiguration();

    // 허용할 Origin
    configuration.setAllowedOrigins(Arrays.asList(
        "http://localhost:3000",
        "http://127.0.0.1:3000"
    ));

    // 허용할 HTTP 메서드
    configuration.setAllowedMethods(Arrays.asList(
        "GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"
    ));

    // 허용할 헤더
    configuration.setAllowedHeaders(Arrays.asList(
        "Authorization", "Content-Type", "X-Requested-With",
        "Accept", "Origin", "Access-Control-Request-Method",
        "Access-Control-Request-Headers"
    ));

    // 인증 정보 포함 허용
    configuration.setAllowCredentials(true);

    // Preflight 요청 캐시 시간 (초)
    configuration.setMaxAge(3600L);

    // 노출할 응답 헤더
    configuration.setExposedHeaders(Arrays.asList(
        "Authorization", "Content-Type"
    ));

    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    source.registerCorsConfiguration("/**", configuration);

    return source;
}

3. Frontend 수정 사항

3.1 TypeScript 타입 정의 수정

파일: kt-event-marketing-fe/src/entities/event/model/types.ts

EventDetail 인터페이스에 추가된 필드:

participants: number | null;
targetParticipants: number | null;
roi: number | null;

3.2 Events 페이지 수정

파일: kt-event-marketing-fe/src/app/(main)/events/page.tsx

변경 전 (Mock 데이터 사용):

participants: 152,
targetParticipants: 200,
roi: 320,
isPopular: Math.random() > 0.5,
isHighROI: Math.random() > 0.7,

변경 후 (실제 API 데이터 사용):

participants: event.participants || 0,
targetParticipants: event.targetParticipants || 0,
roi: event.roi || 0,
isPopular: event.participants && event.targetParticipants
  ? (event.participants / event.targetParticipants) >= 0.8
  : false,
isHighROI: event.roi ? event.roi >= 300 : false,

테스트 시나리오 및 결과

시나리오 1: Backend 컴파일 및 빌드

실행 명령:

./gradlew event-service:compileJava

결과: ✅ 성공

• 빌드 시간: ~7초
• 컴파일 에러 없음

시나리오 2: 데이터베이스 스키마 업데이트

실행: event-service 재시작

결과: ✅ 성공

• JPA ddl-auto: update 설정으로 자동 컬럼 추가
• 추가된 컬럼:
  • participants (INTEGER, DEFAULT 0)
  • target_participants (INTEGER, NULL)
  • roi (DOUBLE PRECISION, DEFAULT 0.0)

시나리오 3: API 응답 검증

요청:

1. 테스트 이벤트 생성

   POST http://localhost:8080/api/v1/events/objectives
   Body: { "objective": "CUSTOMER_ACQUISITION" }
   

2. 이벤트 상세 조회

   GET http://localhost:8080/api/v1/events/{eventId}
   

응답 결과: ✅ 성공

{
  "success": true,
  "data": {
    "eventId": "f34d8f2e-...",
    "participants": 0,
    "targetParticipants": null,
    "roi": 0.0,
    // ... 기타 필드
  },
  "timestamp": "2025-10-29T11:25:23.123456"
}

검증 항목:

• ✅ participants 필드 존재 (기본값 0)
• ✅ targetParticipants 필드 존재 (null)
• ✅ roi 필드 존재 (기본값 0.0)
• ✅ 응답 형식 정상

시나리오 4: CORS 설정 검증

테스트 전 상태:

• ❌ CORS 에러 발생
• 브라우저 콘솔:

  Access to XMLHttpRequest at 'http://localhost:8080/api/v1/events'
  from origin 'http://localhost:3000' has been blocked by CORS policy:
  Response to preflight request doesn't pass access control check:
  No 'Access-Control-Allow-Origin' header is present on the requested resource.
  

CORS 설정 적용 후:

• ✅ CORS 에러 해결
• Preflight OPTIONS 요청 성공
• 실제 API 요청 성공 (HTTP 200)

검증 항목:

• ✅ Access-Control-Allow-Origin 헤더 포함
• ✅ Access-Control-Allow-Methods 헤더 포함
• ✅ Access-Control-Allow-Credentials: true
• ✅ Preflight 캐시 시간: 3600초

시나리오 5: Frontend-Backend 통합 테스트

테스트 URL: http://localhost:3000/events

브라우저 콘솔 로그:

✅ Event API Response: {status: 200, url: /api/v1/events, data: Object}
✅ Events fetched: {success: true, data: Object, timestamp: 2025-10-29T11:33:43.8082712}

화면 표시 결과: ✅ 성공

• 통계 카드:

  • 전체 이벤트: 1개
  • 활성 이벤트: 0개
  • 총 참여자: 0명
  • 평균 ROI: 0%

• 이벤트 목록:

  • 이벤트 1개 표시
  • 상태: "예정 | D+0"
  • 참여자: 0/0
  • ROI: 0%

검증 항목:

• ✅ API 호출 성공 (CORS 문제 없음)
• ✅ 실제 API 데이터 사용 (Mock 데이터 제거)
• ✅ 새로운 필드 정상 표시
• ✅ 통계 계산 정상 작동
• ✅ UI 렌더링 정상

성능 측정

Backend

• 컴파일 시간: ~7초
• 서비스 시작 시간: ~9.5초
• API 응답 시간: <100ms

Frontend

• API 호출 시간: ~50ms
• 페이지 로딩 시간: ~200ms

발견된 이슈 및 해결

이슈 1: CORS 정책 위반

증상:

• Frontend에서 Backend API 호출 시 CORS 에러 발생
• Preflight OPTIONS 요청 실패

원인:

• Spring Security의 CORS 설정이 비활성화되어 있음
• .cors(AbstractHttpConfigurer::disable)

해결:

1. SecurityConfig에 CORS 설정 추가
2. corsConfigurationSource() Bean 구현
3. 허용 Origin, Method, Header 설정
4. 서비스 재시작

결과: ✅ 해결 완료

테스트 결론

성공 항목

• ✅ Backend Event 엔티티 필드 추가
• ✅ Backend DTO 및 Service 매퍼 업데이트
• ✅ Database 스키마 자동 업데이트
• ✅ CORS 설정 추가 및 검증
• ✅ Frontend TypeScript 타입 정의 업데이트
• ✅ Frontend 실제 API 데이터 연동
• ✅ 브라우저 통합 테스트 성공
• ✅ API 응답 형식 검증

남은 작업

해당 없음 - 모든 테스트 통과

다음 단계 제안

1. 참여자 데이터 추가 기능 구현

   • 이벤트 참여 API 개발
   • 참여자 수 증가 로직 테스트
   • ROI 자동 계산 검증

2. 목표 참여자 설정 기능

   • 이벤트 생성/수정 시 목표 참여자 입력
   • 목표 달성률 계산 및 표시

3. ROI 계산 로직 고도화

   • 실제 비용 데이터 연동
   • 수익 데이터 연동
   • ROI 계산식 검증

4. 통계 대시보드 개선

   • 실시간 참여자 수 업데이트
   • ROI 트렌드 그래프
   • 이벤트별 성과 비교

첨부 파일

• 테스트 스크린샷: 브라우저 테스트 결과 화면
• API 응답 로그: event-service.log
• CORS 설정 로그: event-service-cors.log

작성자

• 작성일: 2025-10-29
• 테스트 담당: Backend Developer, Frontend Developer
• 검토자: QA Engineer