🔧 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 설계 준수
✅ 관리자 권한 기반 보안 적용
3cf485f3f2