[FEAT] 신고 및 제재 시스템 데이터 레이어 구현

[DDINGJOO]

Summary

신고 및 제재 시스템의 데이터 레이어를 구현했습니다. 엔티티 설계 시 상속 구조와 속성 추가 방식을 비교 검토한 결과, 현재 비즈니스 요구사항에는 속성 추가 방식이 더 적합하다고 판단하여 이를 채택했습니다.

주요 구현 사항

1. 엔티티 설계

• Report: 신고 정보를 관리하는 핵심 엔티티
• ReportCategory: 신고 대상 타입별 카테고리 관리 (복합키 설계)
• ReportHistory: 신고 처리 이력 추적
• Sanction: 제재 정보 관리
• SanctionRule: 자동 제재 규칙 설정
• ReportStatistics: 신고 통계 집계 (성능 최적화용)

2. 엔티티 설계 고민사항

상속 vs 속성 추가 검토

초기에는 Report 엔티티를 ProfileReport, ArticleReport 등으로 상속 구조로 설계할지 고민했습니다.

상속 구조의 장점:

• 각 신고 타입별 특화된 속성 추가 가능
• 타입 안정성 확보
• 명확한 도메인 분리

상속 구조의 단점:

• 테이블 구조 복잡도 증가 (JOINED, SINGLE_TABLE, TABLE_PER_CLASS 전략 선택 필요)
• 새로운 신고 대상 타입 추가 시 엔티티 클래스 추가 필요
• 통합 조회 쿼리의 복잡도 증가

최종 결정: 속성 추가 방식 채택

현재 비즈니스 요구사항을 분석한 결과 다음과 같은 이유로 속성 추가 방식을 선택했습니다:

1. 확장성: 프로필, 게시글, 업체 등 다양한 대상에 대한 신고가 예정되어 있으나, 핵심 신고 데이터 구조는 동일
2. 단순성: referenceType과 reportedId를 통해 다형성 구현 가능
3. 유연성: 새로운 신고 타입 추가 시 ENUM만 추가하면 되어 유지보수 용이
4. 성능: 단일 테이블 구조로 조회 성능 최적화
5. 통계 처리: 신고 통계 집계 시 단일 테이블 스캔으로 처리 가능

@Enumerated(EnumType.STRING)
@Column(name = "reference_type", nullable = false, length = 20)
private ReferenceType referenceType; // PROFILE, ARTICLE, BUSINESS 등

@Column(nullable = false, length = 100)
private String reportedId; // 신고 대상의 실제 ID

3. 주요 기술적 특징

• 복합키(@EmbeddedId) 활용으로 카테고리 관리 최적화
• 양방향 연관관계 설정 및 편의 메서드 제공
• 비즈니스 로직 메서드를 엔티티 내부에 캡슐화
• 인덱스 전략 수립으로 조회 성능 최적화

4. 리포지토리 계층

• ReportRepository: 신고 조회 및 통계 쿼리
• ReportCategoryRepository: 카테고리 관리
• ReportHistoryRepository: 이력 관리
• SanctionRepository: 제재 조회 및 관리
• ReportStatisticsRepository: 통계 데이터 집계

5. 테스트 커버리지

단위 테스트 (100% 커버리지)

• 모든 엔티티의 핵심 비즈니스 로직에 대한 단위 테스트 작성
• Report 엔티티: 상태 변경, 제재 적용/거부/철회 로직 테스트
• Sanction 엔티티: 제재 활성화/만료/취소 로직 및 남은 기간 계산 테스트
• ReportHistory 팩토리 메서드 테스트
• ReportStatistics 집계 로직 테스트

통합 테스트 (리포지토리 레이어)

• 모든 리포지토리의 CRUD 및 커스텀 쿼리 테스트
• ReportRepository: 복잡한 통계 쿼리 및 다중 조건 조회 검증
• ReportCategoryRepository: 복합키 기반 CRUD 검증
• ReportHistoryRepository: 이력 조회 및 저장 검증
• SanctionRepository: 제재 조회 및 만료 처리 검증
• ReportStatisticsRepository: 집계 데이터 정합성 검증

테스트 환경

• H2 인메모리 DB를 활용한 독립적인 테스트 환경 구축
• application-test.yaml을 통한 테스트 전용 설정 분리
• 테스트 격리 및 빠른 실행 속도 확보

Test Plan

• 엔티티 설계 및 구현
• 리포지토리 인터페이스 구현
• 단위 테스트 작성 (엔티티)
• 통합 테스트 작성 (리포지토리)
• DB 스키마 작성 및 검증
• 테스트 환경 설정

Closes #14

[DDINGJOO]

#15 , #16