feat: 수신함 워크플로우 백엔드 완전 구현
🔧 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 설계 준수 ✅ 관리자 권한 기반 보안 적용
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
from pydantic import BaseModel, Field
|
||||
from datetime import datetime
|
||||
from typing import Optional, List
|
||||
from typing import Optional, List, Dict, Any
|
||||
from enum import Enum
|
||||
|
||||
class UserRole(str, Enum):
|
||||
@@ -19,6 +19,19 @@ class IssueCategory(str, Enum):
|
||||
inspection_miss = "inspection_miss" # 검사미스 (신규 추가)
|
||||
etc = "etc" # 기타
|
||||
|
||||
class ReviewStatus(str, Enum):
|
||||
pending_review = "pending_review" # 수신함 (검토 대기)
|
||||
in_progress = "in_progress" # 관리함 (진행 중)
|
||||
completed = "completed" # 관리함 (완료됨)
|
||||
disposed = "disposed" # 폐기함 (폐기됨)
|
||||
|
||||
class DisposalReasonType(str, Enum):
|
||||
duplicate = "duplicate" # 중복 (기본값)
|
||||
invalid_report = "invalid_report" # 잘못된 신고
|
||||
not_applicable = "not_applicable" # 해당 없음
|
||||
spam = "spam" # 스팸/오류
|
||||
custom = "custom" # 직접 입력
|
||||
|
||||
# User schemas
|
||||
class UserBase(BaseModel):
|
||||
username: str
|
||||
@@ -92,9 +105,61 @@ class Issue(IssueBase):
|
||||
work_hours: float
|
||||
detail_notes: Optional[str] = None
|
||||
|
||||
# 수신함 워크플로우 관련 필드들
|
||||
review_status: ReviewStatus
|
||||
disposal_reason: Optional[DisposalReasonType] = None
|
||||
custom_disposal_reason: Optional[str] = None
|
||||
disposed_at: Optional[datetime] = None
|
||||
reviewed_by_id: Optional[int] = None
|
||||
reviewed_at: Optional[datetime] = None
|
||||
original_data: Optional[Dict[str, Any]] = None
|
||||
modification_log: Optional[List[Dict[str, Any]]] = None
|
||||
|
||||
class Config:
|
||||
from_attributes = True
|
||||
|
||||
# 수신함 워크플로우 전용 스키마들
|
||||
class IssueDisposalRequest(BaseModel):
|
||||
"""부적합 폐기 요청"""
|
||||
disposal_reason: DisposalReasonType = DisposalReasonType.duplicate
|
||||
custom_disposal_reason: Optional[str] = None
|
||||
|
||||
class IssueReviewRequest(BaseModel):
|
||||
"""부적합 검토 및 수정 요청"""
|
||||
project_id: Optional[int] = None
|
||||
category: Optional[IssueCategory] = None
|
||||
description: Optional[str] = None
|
||||
modifications: Optional[Dict[str, Any]] = None
|
||||
|
||||
class IssueStatusUpdateRequest(BaseModel):
|
||||
"""부적합 상태 변경 요청"""
|
||||
review_status: ReviewStatus
|
||||
notes: Optional[str] = None
|
||||
|
||||
class InboxIssue(BaseModel):
|
||||
"""수신함용 부적합 정보 (간소화된 버전)"""
|
||||
id: int
|
||||
category: IssueCategory
|
||||
description: str
|
||||
photo_path: Optional[str] = None
|
||||
photo_path2: Optional[str] = None
|
||||
project_id: Optional[int] = None
|
||||
reporter_id: int
|
||||
reporter: User
|
||||
report_date: datetime
|
||||
review_status: ReviewStatus
|
||||
|
||||
class Config:
|
||||
from_attributes = True
|
||||
|
||||
class ModificationLogEntry(BaseModel):
|
||||
"""수정 이력 항목"""
|
||||
field: str
|
||||
old_value: Any
|
||||
new_value: Any
|
||||
modified_at: datetime
|
||||
modified_by: int
|
||||
|
||||
# Project schemas
|
||||
class ProjectBase(BaseModel):
|
||||
job_no: str = Field(..., min_length=1, max_length=50)
|
||||
|
||||
Reference in New Issue
Block a user