feat: 키워드 알림 기능 (관심 키워드 상품 근처 등록 시 알림)

[chaeyoungeee]

개요

관심 키워드를 미리 등록해두면, 해당 키워드와 일치하는 상품이 내 주변에 새로 등록될 때 인앱 알림을 받는 기능입니다.

Closes #17

변경 사항

1. 키워드 구독 CRUD

• KeywordNotification 엔티티 (member + keyword, (member_id, keyword) 유니크 제약)
• 신규 API (MemberController)
  • POST /api/v1/member/me/keywords — 키워드 등록
  • GET /api/v1/member/me/keywords — 내 키워드 목록 조회
  • DELETE /api/v1/member/me/keywords/{id} — 키워드 삭제
• 검증: 공백 불가 / 중복 불가 / 회원당 최대 20개 / 본인 소유만 삭제
• 기존 UseCase 애플리케이션 레이어 패턴, 에러코드 패턴 그대로 따름

2. 신규 상품 등록 시 매칭 알림

• SaveGoodsUseCase에서 상품 저장 후 KeywordNotificationService.notifyForNewGoods(goods) 호출
• 상품명과 일치하는 키워드(LIKE %keyword%) 구독자 조회
• Redis GEO(MEMBER_KEY)로 상품 반경 내 회원만 필터 → RedisUtil.getNearByMemberIds 추가
• 판매자 본인 제외 / 회원 중복 제거(회원당 1건)
• 매칭 회원에게 Notification + NotificationHistory 생성 → 기존 알림 조회 API(/me/notifications)에 그대로 노출
• 알림 생성 실패가 상품 등록 흐름을 막지 않도록 방어 처리(try/catch + 로깅, Redis 좌표 없으면 skip)

3. 부수 수정 (별도 이슈성)

• ProductService.java가 main에서 메서드 시그니처 누락으로 컴파일 불가 상태였습니다(acca813에서 유입). 빌드를 위해 findByKeyword(String) 시그니처를 최소 복구했습니다. 본 기능과 무관하나 빌드 차단 요소라 함께 포함했습니다.

설계 노트 / 향후 확장

• 현재 Member에 fcmToken이 없고 FCM 발송 인프라가 없어 인앱 알림으로 우선 구현했습니다. 추후 FCM 푸시 연동 시 notifyForNewGoods 내에서 발송 로직만 추가하면 됩니다.
• 알림 발송은 현재 상품 등록 트랜잭션 내 동기 호출입니다. 추후 트래픽 증가 시 @TransactionalEventListener(AFTER_COMMIT) 또는 비동기로 분리 가능합니다.
• 매칭은 상품명 부분일치 기준이며, 추후 카테고리/가격 조건 필터로 확장 가능합니다.

테스트

• ./gradlew build -x test 통과 (전 모듈 컴파일/패키징 성공)

🤖 Generated with Claude Code