[#200] feat. 알림 삭제 API (단건·전체)

[howudong]

Closes #200

FE 요청서: https://github.com/ditto-develop/ditto-fe/wiki/BE-Request-Delete-And-Profile-Edit (1번)

배경

알림 API에 삭제가 없어 FE가 localStorage(ditto.hiddenNotificationIds)로 기기 로컬 숨김을 붙여 우회 배포한 상태다. 다른 기기·재설치에서는 숨긴 알림이 다시 보인다.

추가한 API

DELETE /api/v1/notifications/{id}
  → 내 알림 하나. 남의 알림·이미 지운 알림은 404

DELETE /api/v1/notifications?category=MATCHING|CHAT|SYSTEM
  → 화면에 보이는 내 알림 전체 (category 생략 시 전부)

응답은 둘 다 { deletedCount }. 단건은 항상 1이지만 FE가 응답 처리를 하나로 쓸 수 있게 형식을 맞췄다.

소프트 삭제인 이유

처음엔 하드 삭제로 만들었다가 리뷰에서 막혔다. 같은 사건을 두 번 알리지 않는 판단이 알림 행의 존재 하나에 걸려 있어서(existsByMemberIdAndTypeAndTargetId), 행을 지우면 수렴 루프를 도는 스케줄러가 같은 대상을 다시 집어와 알림과 푸시를 다시 내보낸다. ChatRoomLifecycleScheduler.sweep()이 1분 주기라 지운 지 60초 안에 돌아온다.

deleted_at을 찍고 행은 남긴다. 존재 검사는 지운 행도 세므로 재발송이 막히고, 목록·미읽음 수·전체 읽음·단건 조회는 조건으로 걸러낸다. 30일이 지나면 기존 purge 배치가 다른 행과 함께 지우므로 보관 기간은 그대로다.

함께 고친 것 — 미성사 그룹 안내 재발송

같은 구조의 문제가 main에 이미 있었다. findUnformedUntil에 기간 하한이 없어 과거 미성사 그룹을 매 분 다시 집는데, 알림 행이 purge되면(30일) 존재 검사가 다시 통과해 안내와 푸시가 또 나간다. 새 행도 30일 뒤 지워져 그때부터 30일 주기로 반복된다. 사용자가 알림을 지우지 않아도 모든 대상자에게 일어난다.

스캔을 최근 2주 주차로 자른다(findUnformedBetween). purge 전에 대상에서 빠지고, 스케줄러가 한두 주 멈췄다 돌아와도 놓친 주차를 따라잡는다. 대신 2주보다 오래된 그룹은 안내가 나가지 않는다 — 마감 직후 안내라 지난 주차를 다시 집을 이유가 없고, 배포 시점(#192)에 과거분은 이미 소진됐다.

다른 ONCE_PER_TARGET 유형은 스캔 범위가 짧아 같은 문제가 없다(CHAT_ENDING_SOON은 종료 6시간 창, REVIEW_REQUEST·MATCH_RESULT는 이번 주기 처리분만).

마이그레이션

V20260919224428_알림 삭제 표시 컬럼 추가.sql

• notification.deleted_at DATETIME(6) NULL 추가
• notification_index_1을 (member_id, id) → (member_id, deleted_at, id)로 재생성. 목록 조회가 member_id = ? AND deleted_at IS NULL을 동등 조건으로 쓰므로 세 번째 컬럼 id로 정렬·커서를 그대로 태운다

검증

./gradlew :domain:test :api:test — 1233건 통과, 실패 0 (Jacoco 커버리지 게이트 포함).

회귀 테스트를 넣었다.

• NotificationAppenderTest — "사용자가 지운 알림은 다시 적재되지 않는다"
• UnformedGroupNotifierTest — 3주 전 주차는 제외, 지난주 주차는 포함
• NotificationRepositoryTest — 지운 알림이 목록·미읽음 수에서 빠지되 행은 남고 중복 검사에 잡히는 것

문서

• docs/domains/notification.md — 엔드포인트 2줄, "사용자 삭제는 행을 남긴다"·"중복 검사는 보관 기간까지만 유효하다" 불변식
• docs/domains/match.md — 미성사 안내 멱등의 한계와 2주 창

🤖 Generated with Claude Code

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
82.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud