🔄 Duplicate Tracking System:
- 중복 신고 시 원본 이슈에 신고자 정보 자동 추가
- 신고 인지도 및 대응 속도 분석을 위한 데이터 수집
- 뒷북치는 신고자 파악 및 집계 기능
📊 Database Schema Updates:
- duplicate_of_issue_id: 중복 대상 이슈 ID (FK)
- duplicate_reporters: 중복 신고자 목록 (JSONB 배열)
- 015_add_duplicate_tracking.sql 마이그레이션 실행
- GIN 인덱스로 JSONB 검색 성능 최적화
🔧 Backend Enhancements:
- 중복 폐기 시 대상 이슈에 신고자 정보 자동 추가
- 신고자 중복 체크 로직 (동일 사용자 재추가 방지)
- /api/inbox/management-issues API 추가 (중복 선택용)
- 프로젝트별 관리함 이슈 목록 조회 지원
🎨 Frontend UI Improvements:
- 중복 선택 시 관리함 이슈 목록 표시
- 프로젝트별 필터링된 이슈 목록 제공
- 간단한 이슈 정보 표시 (제목, 카테고리, 신고자, 중복 건수)
- 직관적인 선택 UI (클릭으로 선택, 시각적 피드백)
📋 Duplicate Selection Process:
1. 폐기 사유로 '중복' 선택
2. 동일 프로젝트의 관리함 이슈 목록 자동 로드
3. 중복 대상 이슈 선택 (필수)
4. 확인 시 신고자 정보가 원본 이슈에 추가
💾 Data Structure:
- duplicate_reporters: [
{
user_id: 123,
username: 'reporter1',
full_name: '신고자1',
report_date: '2024-10-25T14:30:00',
added_at: '2024-10-25T15:00:00'
}
]
🔍 Analytics Features:
- 중복 신고 건수 표시
- 신고자별 신고 시점 추적
- 원본 이슈 대비 지연 신고 분석 가능
- 부서별/사용자별 인지도 분석 데이터 제공
🚀 User Experience:
- 중복 처리 시 명확한 안내 메시지
- 관리함 이슈 목록 실시간 로드
- 선택 필수 검증 (중복 대상 미선택 시 경고)
- 처리 완료 후 자동 목록 새로고침
Expected Result:
✅ 중복 신고 시 신고자 정보 자동 추적
✅ 신고 인지도 및 대응 속도 분석 데이터 수집
✅ 직관적인 중복 대상 선택 UI
✅ 부서별/개인별 신고 패턴 분석 기반 마련
🔧 Backend Fix:
- 수신함 라우터 prefix 수정: /inbox → /api/inbox
- 다른 API들과 일관성 있는 경로 구조 적용
- FastAPI 라우터 등록 정상화
🎨 Frontend Fix:
- 공통 헤더 초기화 로그 추가
- currentUser undefined 문제 디버깅 준비
- API 연동 상태 확인 로그 강화
🔍 Issue Analysis:
- 수신함 API 404 에러 → 경로 문제로 확인
- 공통 헤더 안보임 → currentUser 초기화 문제로 추정
- 백엔드 재시작으로 API 정상화 확인
Result:
✅ 수신함 API 엔드포인트 정상화 (/api/inbox/)
✅ 인증 필요 응답 확인 (API 작동 중)
🔄 공통 헤더 디버깅 로그 추가 (다음 테스트 대기)
🔧 Models & Schemas:
- 새로운 ENUM 클래스 추가:
* ReviewStatus: pending_review, in_progress, completed, disposed
* DisposalReasonType: duplicate, invalid_report, not_applicable, spam, custom
- Issue 모델 확장 (8개 새 필드):
* review_status: 수신함 워크플로우 상태 (기본값: pending_review)
* disposal_reason: 폐기 사유 ENUM
* custom_disposal_reason: 사용자 정의 폐기 사유
* disposed_at: 폐기 처리 시간
* reviewed_by_id: 검토자 FK (users.id)
* reviewed_at: 검토 완료 시간
* original_data: 원본 데이터 보존 (JSONB)
* modification_log: 수정 이력 추적 (JSONB)
- User 모델 관계 수정:
* issues: 신고한 부적합 (foreign_keys 명시)
* reviewed_issues: 검토한 부적합 (새로 추가)
🎯 Pydantic Schemas:
- 기존 Issue 스키마에 워크플로우 필드 추가
- 수신함 전용 스키마들:
* IssueDisposalRequest: 폐기 요청
* IssueReviewRequest: 검토/수정 요청
* IssueStatusUpdateRequest: 상태 변경 요청
* InboxIssue: 수신함용 간소화 모델
* ModificationLogEntry: 수정 이력 항목
🚀 API Endpoints (/api/inbox):
- GET /: 수신함 부적합 목록 (프로젝트 필터링, 페이징)
- POST /{id}/dispose: 부적합 폐기 처리 (관리자 전용)
- POST /{id}/review: 부적합 검토/수정 (관리자 전용)
- POST /{id}/status: 최종 상태 결정 (관리자 전용)
- GET /{id}/history: 수정 이력 조회
- GET /statistics: 수신함 통계
🔒 Security & Validation:
- 관리자 전용 액션 (폐기, 검토, 상태변경)
- 사용자 정의 폐기 사유 검증
- 프로젝트 존재 여부 확인
- 상태 변경 로직 검증
📊 Data Preservation:
- 원본 데이터 자동 보존 (최초 1회)
- 모든 수정사항 이력 추적
- 검토자 및 시간 기록
- 폐기 사유 및 시간 기록
🎯 Workflow Logic:
업로드(pending_review) → 수신함 검토 → [폐기→폐기함] or [승인→관리함]
- 폐기: disposed 상태, 폐기함으로
- 승인: in_progress/completed 상태, 관리함으로
- 모든 변경사항 추적 및 보존
Result:
✅ 수신함 워크플로우 백엔드 100% 완성
✅ DB 스키마와 완벽 동기화
✅ 데이터 무결성 및 추적성 보장
✅ RESTful API 설계 준수
✅ 관리자 권한 기반 보안 적용
