feat: 중복 신고 추적 시스템 구현 - 신고자 인지도 및 대응 속도 분석

🔄 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
 부서별/개인별 신고 패턴 분석 기반 마련
This commit is contained in:
Hyungi Ahn
2025-10-25 13:48:21 +09:00
parent 11692b4a91
commit f6ed6bd574
8 changed files with 304 additions and 7 deletions

View File

@@ -115,10 +115,15 @@ class Issue(Base):
original_data = Column(JSONB) # 원본 데이터 보존
modification_log = Column(JSONB, default=lambda: []) # 수정 이력
# 중복 신고 추적 시스템
duplicate_of_issue_id = Column(Integer, ForeignKey("issues.id")) # 중복 대상 이슈 ID
duplicate_reporters = Column(JSONB, default=lambda: []) # 중복 신고자 목록
# Relationships
reporter = relationship("User", back_populates="issues", foreign_keys=[reporter_id])
reviewer = relationship("User", foreign_keys=[reviewed_by_id])
reviewer = relationship("User", foreign_keys=[reviewed_by_id], overlaps="reviewed_issues")
project = relationship("Project", back_populates="issues")
duplicate_of = relationship("Issue", remote_side=[id], foreign_keys=[duplicate_of_issue_id])
class Project(Base):
__tablename__ = "projects"

View File

@@ -124,6 +124,10 @@ class Issue(IssueBase):
original_data: Optional[Dict[str, Any]] = None
modification_log: Optional[List[Dict[str, Any]]] = None
# 중복 신고 추적 시스템
duplicate_of_issue_id: Optional[int] = None
duplicate_reporters: Optional[List[Dict[str, Any]]] = None
class Config:
from_attributes = True
@@ -132,6 +136,7 @@ class IssueDisposalRequest(BaseModel):
"""부적합 폐기 요청"""
disposal_reason: DisposalReasonType = DisposalReasonType.duplicate
custom_disposal_reason: Optional[str] = None
duplicate_of_issue_id: Optional[int] = None # 중복 대상 이슈 ID
class IssueReviewRequest(BaseModel):
"""부적합 검토 및 수정 요청"""

View File

@@ -0,0 +1,100 @@
-- 015_add_duplicate_tracking.sql
-- 중복 신고 추적 시스템 추가
BEGIN;
-- migration_log 테이블 생성 (멱등성)
CREATE TABLE IF NOT EXISTS migration_log (
id SERIAL PRIMARY KEY,
migration_file VARCHAR(255) NOT NULL UNIQUE,
executed_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
status VARCHAR(50),
notes TEXT,
created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);
-- 마이그레이션 파일 이름
DO $$
DECLARE
migration_name VARCHAR(255) := '015_add_duplicate_tracking.sql';
migration_notes TEXT := '중복 신고 추적 시스템: duplicate_of_issue_id, duplicate_reporters 컬럼 추가';
current_status VARCHAR(50);
BEGIN
SELECT status INTO current_status FROM migration_log WHERE migration_file = migration_name;
IF current_status IS NULL THEN
RAISE NOTICE '--- 마이그레이션 % 시작 ---', migration_name;
-- issues 테이블에 중복 추적 컬럼 추가
-- 중복 대상 이슈 ID
IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'issues' AND column_name = 'duplicate_of_issue_id') THEN
ALTER TABLE issues ADD COLUMN duplicate_of_issue_id INTEGER;
RAISE NOTICE '✅ issues.duplicate_of_issue_id 컬럼이 추가되었습니다.';
ELSE
RAISE NOTICE ' issues.duplicate_of_issue_id 컬럼이 이미 존재합니다.';
END IF;
-- 중복 신고자 목록 (JSONB 배열)
IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'issues' AND column_name = 'duplicate_reporters') THEN
ALTER TABLE issues ADD COLUMN duplicate_reporters JSONB DEFAULT '[]'::jsonb;
RAISE NOTICE '✅ issues.duplicate_reporters 컬럼이 추가되었습니다.';
ELSE
RAISE NOTICE ' issues.duplicate_reporters 컬럼이 이미 존재합니다.';
END IF;
-- 외래 키 제약 조건 추가 (duplicate_of_issue_id)
IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'issues_duplicate_of_issue_id_fkey') THEN
ALTER TABLE issues ADD CONSTRAINT issues_duplicate_of_issue_id_fkey
FOREIGN KEY (duplicate_of_issue_id) REFERENCES issues(id);
RAISE NOTICE '✅ issues_duplicate_of_issue_id_fkey 외래 키 제약 조건이 추가되었습니다.';
ELSE
RAISE NOTICE ' issues_duplicate_of_issue_id_fkey 외래 키 제약 조건이 이미 존재합니다.';
END IF;
-- 인덱스 추가
IF NOT EXISTS (SELECT 1 FROM pg_indexes WHERE tablename = 'issues' AND indexname = 'idx_issues_duplicate_of') THEN
CREATE INDEX idx_issues_duplicate_of ON issues (duplicate_of_issue_id) WHERE duplicate_of_issue_id IS NOT NULL;
RAISE NOTICE '✅ idx_issues_duplicate_of 인덱스가 생성되었습니다.';
ELSE
RAISE NOTICE ' idx_issues_duplicate_of 인덱스가 이미 존재합니다.';
END IF;
-- JSONB 인덱스 추가 (중복 신고자 검색 성능 향상)
IF NOT EXISTS (SELECT 1 FROM pg_indexes WHERE tablename = 'issues' AND indexname = 'idx_issues_duplicate_reporters_gin') THEN
CREATE INDEX idx_issues_duplicate_reporters_gin ON issues USING GIN (duplicate_reporters);
RAISE NOTICE '✅ idx_issues_duplicate_reporters_gin 인덱스가 생성되었습니다.';
ELSE
RAISE NOTICE ' idx_issues_duplicate_reporters_gin 인덱스가 이미 존재합니다.';
END IF;
-- 마이그레이션 검증
DECLARE
col_count INTEGER;
idx_count INTEGER;
fk_count INTEGER;
BEGIN
SELECT COUNT(*) INTO col_count FROM information_schema.columns WHERE table_name = 'issues' AND column_name IN ('duplicate_of_issue_id', 'duplicate_reporters');
SELECT COUNT(*) INTO idx_count FROM pg_indexes WHERE tablename = 'issues' AND indexname IN ('idx_issues_duplicate_of', 'idx_issues_duplicate_reporters_gin');
SELECT COUNT(*) INTO fk_count FROM pg_constraint WHERE conname = 'issues_duplicate_of_issue_id_fkey';
RAISE NOTICE '=== 마이그레이션 검증 결과 ===';
RAISE NOTICE '추가된 컬럼: %/2개', col_count;
RAISE NOTICE '생성된 인덱스: %/2개', idx_count;
RAISE NOTICE '생성된 FK: %/1개', fk_count;
IF col_count = 2 AND idx_count = 2 AND fk_count = 1 THEN
RAISE NOTICE '✅ 마이그레이션이 성공적으로 완료되었습니다!';
INSERT INTO migration_log (migration_file, status, notes) VALUES (migration_name, 'SUCCESS', migration_notes);
ELSE
RAISE EXCEPTION '❌ 마이그레이션 검증 실패!';
END IF;
END;
ELSIF current_status = 'SUCCESS' THEN
RAISE NOTICE ' 마이그레이션 %는 이미 성공적으로 실행되었습니다. 스킵합니다.', migration_name;
ELSE
RAISE NOTICE '⚠️ 마이그레이션 %는 이전에 실패했습니다. 수동 확인이 필요합니다.', migration_name;
END IF;
END $$;
COMMIT;

View File

@@ -70,6 +70,32 @@ async def dispose_issue(
"preserved_at": datetime.now().isoformat()
}
# 중복 처리 로직
if disposal_request.disposal_reason == DisposalReasonType.duplicate and disposal_request.duplicate_of_issue_id:
# 중복 대상 이슈 확인
target_issue = db.query(Issue).filter(Issue.id == disposal_request.duplicate_of_issue_id).first()
if not target_issue:
raise HTTPException(status_code=404, detail="중복 대상 이슈를 찾을 수 없습니다.")
# 중복 신고자를 대상 이슈에 추가
current_reporters = target_issue.duplicate_reporters or []
new_reporter = {
"user_id": issue.reporter_id,
"username": issue.reporter.username,
"full_name": issue.reporter.full_name,
"report_date": issue.report_date.isoformat() if issue.report_date else None,
"added_at": datetime.now().isoformat()
}
# 중복 체크 (이미 추가된 신고자인지 확인)
existing_reporter = next((r for r in current_reporters if r.get("user_id") == issue.reporter_id), None)
if not existing_reporter:
current_reporters.append(new_reporter)
target_issue.duplicate_reporters = current_reporters
# 현재 이슈에 중복 대상 설정
issue.duplicate_of_issue_id = disposal_request.duplicate_of_issue_id
# 폐기 처리
issue.review_status = ReviewStatus.disposed
issue.disposal_reason = disposal_request.disposal_reason
@@ -303,3 +329,38 @@ async def get_inbox_statistics(
"total_in_management": management_count,
"total_issues": db.query(Issue).count()
}
@router.get("/management-issues")
async def get_management_issues(
project_id: Optional[int] = None,
current_user: User = Depends(get_current_user),
db: Session = Depends(get_db)
):
"""관리함 이슈 목록 조회 (중복 선택용)"""
try:
query = db.query(Issue).filter(
Issue.review_status.in_([ReviewStatus.in_progress, ReviewStatus.completed])
)
# 프로젝트 필터 적용
if project_id:
query = query.filter(Issue.project_id == project_id)
issues = query.order_by(Issue.reviewed_at.desc()).limit(50).all()
# 간단한 형태로 반환 (제목과 ID만)
result = []
for issue in issues:
result.append({
"id": issue.id,
"description": issue.description[:100] + "..." if len(issue.description) > 100 else issue.description,
"category": issue.category.value,
"reporter_name": issue.reporter.full_name or issue.reporter.username,
"reviewed_at": issue.reviewed_at.isoformat() if issue.reviewed_at else None,
"duplicate_count": len(issue.duplicate_reporters) if issue.duplicate_reporters else 0
})
return result
except Exception as e:
raise HTTPException(status_code=500, detail=f"관리함 이슈 조회 중 오류가 발생했습니다: {str(e)}")