🚀[기능개선][관리자][물품관리][채팅] 관리자 삭제 물품에 대한 채팅방 UX 및 알림 고도화

[Cassiiopeia]

📝 현재 문제점

• 이슈 ❗[버그][관리자][물품관리] 물품 삭제 시 trade_request_history FK 제약조건 위반으로 500 에러 발생 #627(Phase 1)에서 관리자 물품 삭제를 Hard Delete → Soft Delete로 전환하여 FK 제약 위반 문제를 해결하고, 고정 문구("관리자에 의해 물품이 삭제되었습니다") 형태의 임시 알림만 발송하도록 구현됨
• 이에 따라 다음과 같은 후속 작업이 필요함
  • 삭제된 물품이 연결된 채팅방에 진입했을 때, 기존 대화는 보존되지만 물품 정보 영역이 어떻게 표시되어야 하는지 UX가 정의되지 않음
  • 삭제된 물품의 채팅방에서 여전히 메시지 전송이 가능하여, 사용자가 삭제 사실을 인지하지 못한 채 대화를 이어갈 수 있음
  • 알림 본문이 고정 문구라 사용자가 삭제 사유를 알 수 없어 CS 문의 발생 우려
  • 중고거래 플랫폼 특성상 거래/채팅 기록은 전자상거래법/개인정보보호법에 따른 보존 의무가 있으나, 현재 데이터 보존 정책이 문서화되어 있지 않음

🛠️ 해결 방안 / 제안 기능

• 채팅방 내부 UX 개선

  • 삭제된 물품이 연결된 채팅방 진입 시, 상단 물품 정보 영역에 "관리자에 의해 삭제된 물품입니다" 플레이스홀더 표시
  • 기존 대화 내용은 그대로 보존 (사용자가 맥락 확인 가능)
  • Phase 1에서 Response DTO에 노출된 item.isDeleted 플래그를 기반으로 프론트에서 UI 분기 처리

• 채팅방 메시지 전송 차단

  • 메시지 전송 시 연결된 물품의 삭제 여부를 체크하여, 삭제된 경우 전송 차단
  • 차단 시 "삭제된 물품이라 더 이상 대화할 수 없습니다" 안내 반환

• 알림 고도화

  • 고정 문구 알림을 카테고리 기반 사유 표시로 교체
  • 삭제 사유 카테고리 도입 (거래 금지 품목, 사기 의심, 부적절한 콘텐츠, 저작권 침해, 신고 누적, 기타)
  • Admin 삭제 API에 삭제 사유(필수) 및 상세 사유(선택) 파라미터 추가
  • 알림 본문 예: "회원님의 물품 '{물품명}'이(가) '{카테고리}' 사유로 삭제되었습니다."
  • 상세 사유는 관리자 이력 조회에서만 노출, 사용자에게는 비공개 (민감 정보 보호)

• 데이터 보존 정책 수립

  • 전자상거래법 기준 거래/계약 기록 5년 보존 정책 문서화
  • 개인정보처리방침 반영 검토
  • 보존 기간 경과 데이터의 익명화 및 파기 배치 스케줄러 설계
  • MongoDB 채팅 메시지 TTL 또는 배치 기반 만료 처리 방식 설계

⚙️ 작업 내용

• 채팅방 Response DTO에 삭제 물품 표시를 위한 필드 점검 및 보강
• 채팅방 메시지 전송 API/WebSocket 엔드포인트에서 물품 삭제 여부 검증 로직 추가
• 삭제 사유 카테고리 enum 신규 도입 및 Item 엔티티에 삭제 사유/상세 사유 필드 추가
• Flyway 마이그레이션: item 테이블에 삭제 사유 관련 컬럼 추가
• Admin 물품 삭제 API에 삭제 사유/상세 사유 파라미터 추가 (AdminRequest 확장)
• AdminControllerDocs에 @ApiChangeLog 추가 및 @Operation description 업데이트
• 알림 발송 로직을 카테고리 기반 동적 본문 생성 방식으로 교체
• 데이터 보존 정책 문서 신규 작성 (docs/ 하위)

🔗 관련 이슈

• ❗[버그][관리자][물품관리] 물품 삭제 시 trade_request_history FK 제약조건 위반으로 500 에러 발생 #627 (Phase 1 - 선행 작업: Soft Delete 전환 및 FK 에러 해결)

🙋‍♂️ 담당자

• 백엔드: @Chuseok22
• 프론트엔드: 이름
• 디자인: 이름

[github-actions]

Chuseok22 Issue Helper

브랜치명

20260406_#629_관리자_삭제_물품에_대한_채팅방_UX_및_알림_고도화

커밋 메시지

관리자_삭제_물품에_대한_채팅방_UX_및_알림_고도화 : feat : {변경 사항에 대한 설명} https://github.com/TEAM-ROMROM/RomRom-BE/issues/629

[Chuseok22]

확인했습니다