✨ Feat: ad.picke.store 제휴 광고(쿠팡 파트너스·애드픽) 연동

[Roy-wonji]

#️⃣ 연관된 이슈

• ✨ Feat: ad.picke.store 제휴 광고(쿠팡 파트너스·애드픽) 연동 #441

📝 작업 내용

✨ Feat

내용	파일
소재·클릭 로그·일별 노출 집계 엔티티	AdCreative.java, AdClickLog.java, AdImpressionDaily.java
지면별 광고 조회(가중 로테이션)·노출 집계	AdController.java, AdQueryService.java
클릭 리다이렉트와 매체별 추적 파라미터 병합	AdClickController.java, AdClickService.java, AffiliateLinks.java
매체별 링크 빌더 (쿠팡 subId / 애드픽 pass-through)	CoupangLinkBuilder.java, AdpickLinkBuilder.java
관리자 소재 CRUD·노출/클릭/CTR·클릭 내역	AdminAdController.java, AdminAdService.java
ad.picke.store 루트 공개 지면	AdLandingController.java, templates/ad/landing.html
광고 API Swagger 그룹 분리	SwaggerConfig.java

🐛 Fix

내용	파일
정확 일치 화이트리스트 분리로 루트·/error 401 해소	JwtFilter.java, SecurityConfig.java

📌 공유 사항

1. 이 PR은 🐛 Fix: BattleVoteServiceImplTest 시간대 불일치로 15시(UTC) 이후 CI 실패 #442(fix/#440) 위에 쌓았습니다. 그쪽이 머지되면 base가 dev로 자동 전환됩니다. 먼저 #442를 봐주세요.
2. 배포 전 별도 작업 없습니다. ddl-auto=update라 테이블은 자동 생성됩니다. docs/db/의 SQL은 수동 관리·사후 검증용입니다.
3. COUPANG_PARTNERS_ID 환경변수 주입이 필요합니다. 다른 시크릿과 같이 기본값을 두지 않았습니다. 값은 AF6830373입니다.
4. 지면(AdSlotCode)은 iOS Presentation 모듈 실제 화면 기준으로 5개 잡았습니다. 앱팀 확정 후 실제로 붙이는 지면에만 소재를 등록하면 되고, 소재 없는 지면은 빈 배열이라 앱이 알아서 숨깁니다.
5. 애드픽은 서브아이디 파라미터 규격 확인 전이라 pass-through입니다. 확인되면 ADPICK_SUB_ID_PARAM 환경변수만 채우면 배포 없이 지면별 성과 분리가 켜집니다.

✅ 체크리스트

• 컨벤션에 맞는 Type을 선택했나요?
• Development에 이슈를 연동했나요?
• Merge 하려는 브랜치가 올바르게 설정되어 있나요?
• 로컬에서 실행했을 때 에러가 발생하지 않나요?

📸 스크린샷

@Check 제약이 실제 DDL에 나가는지 스키마 생성으로 확인했습니다.

create table ad_creatives (..., 
  constraint ck_ad_creatives_network check (network in ('COUPANG', 'ADPICK')),
  constraint ck_ad_creatives_slot check (slot in ('HOME_FEED', 'BATTLE_RESULT_BOTTOM', 'CHAT_ROOM_INLINE', 'ATTENDANCE_COMPLETE', 'PROFILE_BOTTOM')),
  constraint ck_ad_creatives_status check (status in ('DRAFT', 'ACTIVE', 'PAUSED')));

💬 리뷰 요구사항

1. CHECK 제약이 enum과 어긋나는 것이 #378의 본질이라 봤습니다. 제약 문자열과 enum 상수를 대조하는 AdCheckConstraintTest를 넣어, 값을 추가하고 제약 갱신을 잊으면 운영이 아니라 CI에서 먼저 깨지게 했습니다. 다만 ddl-auto=update는 기존 제약을 갱신하지 않으므로 실제 ALTER는 여전히 수동입니다. 이 조합이 적절한지 의견 부탁드립니다.
2. 클릭 로그를 익명(ip_hash + user_agent)으로 뒀습니다. /c/{code}가 외부 브라우저에서 열려 Authorization 헤더가 없고, 공개 URL에 사용자 식별자를 실으면 열거 문제가 생겨서입니다. 지면별 CTR과 정산 대조에는 userId가 필요 없다고 판단했는데, 본인 클릭 어뷰징 탐지가 필요하면 다시 논의하면 좋겠습니다.
3. ad_click_logs.creative_id, ad_impression_daily.creative_id에 FK를 걸지 않았습니다. 소재를 지워도 집계 이력은 남기려는 의도인데, 팀 컨벤션과 맞는지 봐주세요.

[Roy-wonji]

CI 관련 참고입니다.

deploy.yml이 dev/main 대상 PR에만 걸려 있어서, base가 fix/#440인 지금은 체크가 돌지 않습니다.

#442를 먼저 머지하면 이 PR의 base가 dev로 자동 전환되면서 CI가 돕니다.

지금 base를 dev로 바꾸면 CI는 돌지만, #442에서 고친 BattleVoteServiceImplTest 2건이 15시(UTC) 이후 실행에서 그대로 실패합니다. 그래서 순서를 지키는 쪽으로 뒀습니다.

로컬 검증 결과입니다.

TZ=UTC ./gradlew test
204 tests completed, 2 failed

실패 2건은 ScenarioAudioPipelineServiceTest, ScenarioServiceImplTest로 로컬에 ffmpeg가 없어 나는 것이며 CI에서는 통과합니다.