기부자 뉴스 수집 & AI 판별 대시보드

수집된 뉴스 건수, 판별 대기 건수, 오늘의 골든 타이밍 기부자 현황을 한눈에 파악할 수 있는 메인 화면입니다.

• React 18 + TypeScript 컴포넌트 기반 위젯 레이아웃
• Recharts 도넛·바 차트로 타이밍 점수 분포 시각화
• FastAPI WebSocket / 폴링으로 실시간 수집 상태 반영

FastAPI 비동기 엔드포인트와 React Query를 결합해 30초 주기 자동 갱신을 구현하고, 대규모 기부자 집계 데이터를 서버 사이드 집계 후 전달하는 구조를 설계합니다.

기부자별로 수집된 뉴스 목록과 LLM이 판별한 동명이인 여부, 기사 요약을 확인하고 담당자가 검토·승인할 수 있는 화면입니다.

• Celery Beat + Redis로 매일 정기 크롤링 스케줄 관리
• Claude API (claude-3-haiku) 프롬프트로 동명이인 판별 + 요약 생성
• PostgreSQL JSONB 컬럼으로 LLM 응답 원본 보존 및 재처리 지원

LLM 호출 비용을 최소화하기 위해 기부자 프로필(생년월일·직함·소속)을 컨텍스트로 주입하는 구조화 프롬프트를 설계하고, 판별 신뢰도 점수를 함께 반환해 담당자 검토 우선순위를 자동 정렬합니다.

기부자별 최근 뉴스 감성·빈도·이슈 유형을 종합해 기부 제안 적합 시점 점수를 산출하고, 고점수 기부자를 우선 노출합니다.

• Python 규칙 엔진 + LLM 감성 분류 결합으로 스코어 산출 파이프라인 구현
• Jinja2 템플릿 + Claude API로 기부자별 맞춤 접촉 메일 초안 자동 생성
• FastAPI Background Task로 스코어 갱신을 메인 요청과 비동기 분리

감성 분류·이슈 유형·접촉 이력을 가중 합산하는 스코어 산출 규칙을 YAML 설정 파일로 외부화하여, 담당자가 코드 수정 없이 가중치를 조정할 수 있는 구조를 설계합니다.

내부 DB 기부자 레코드와 수집 뉴스 매핑 오류, 중복 항목, LLM 판별 실패 건을 추적하고 관리자가 수동 수정할 수 있는 화면입니다.

• PostgreSQL audit_log 테이블 + 트리거로 모든 수집·판별 이력 자동 기록
• React 필터 테이블로 오류 유형·날짜·기부자별 로그 빠른 조회 구현
• 중복 기부자 감지 알고리즘(이름+소속 유사도) Python difflib 기반 구현

모든 LLM 판별 요청·응답을 JSON으로 audit_log에 보존하여, 판별 오류 발생 시 프롬프트 재설계 없이 기존 데이터로 재처리할 수 있는 멱등 파이프라인을 설계합니다.