콘텐츠 마케팅 자동화 관리 시스템
사용자별 화면 설계 및 시나리오

[화면 개요 및 목적]

콘텐츠 담당자가 관리하는 전체 키워드를 한 화면에서 확인하는 중앙 허브입니다. 상단의 4개 KPI 카드로 전체 현황을 즉시 파악하고, 키워드별 상태(미작성/작성중/완료/예약중)를 필터링하여 업무 우선순위를 정할 수 있습니다.

[핵심 기능 로직]

키워드 상태는 원고 에디터 저장 시 자동 업데이트됩니다. 업로드 예약 시 Celery 작업 큐에 등록되며, 발행 시간까지 실시간 카운트다운이 표시됩니다. 예약 상태의 '예약중' 배지는 WebSocket으로 업로드 완료 시 자동 '완료'로 전환됩니다.

• Supabase Realtime — 상태 변경 즉시 동기화
• Celery Beat — 예약 업로드 스케줄 관리

[화면 개요 및 목적]

키워드 전용 원고 에디터입니다. 좌측에서 원고를 작성하고, 우측 패널에서 즉시 업로드 플랫폼과 예약 일시를 설정할 수 있습니다. 단일 화면에서 작성→예약이 완결되어 업무 전환 비용을 최소화합니다.

[핵심 기능 로직]

업로드 예약 버튼 클릭 시, FastAPI가 Celery 작업 큐에 태스크를 등록합니다. 예약 시간에 Celery Worker가 Playwright(블로그) 또는 Naver Cafe API(카페)를 통해 자동 게시합니다. 블로그 업로드 경고 배너는 일일 업로드 건수를 DB에서 실시간 조회하여 표시됩니다.

• FastAPI + Celery — 예약 태스크 큐 등록
• Playwright — 블로그 Human-like 자동화

[화면 개요 및 목적]

담당자가 자신이 예약한 업로드의 결과를 실시간으로 확인하는 화면입니다. 성공/실패/예약대기 건수를 상단에서 즉시 파악하고, 실패 건에 대해 오류 원인과 원클릭 재시도 버튼을 제공하여 빠른 복구가 가능합니다.

[핵심 기능 로직]

Celery Worker가 업로드 완료/실패 시 Supabase DB에 결과를 기록합니다. WebSocket 채널을 통해 담당자 브라우저로 실시간 알림이 전송됩니다. 실패 시 오류 코드(토큰 만료, 네트워크 오류, 탐지 등)를 분류하여 원클릭 재시도 또는 수동 조치 안내를 제공합니다.

• WebSocket (FastAPI) — 실시간 업로드 알림
• Celery Retry Logic — 자동 재시도 큐 관리

[화면 개요 및 목적]

관리자가 팀 전체의 콘텐츠 생산 현황을 한눈에 파악하는 실시간 대시보드입니다. KPI 카드로 전체 목표 달성률을 확인하고, 팀원별 진행률과 실패 건수를 통해 즉각적인 지원이 필요한 상황을 식별합니다.

[핵심 기능 로직]

Supabase의 집계 쿼리로 팀원별 키워드 작성 건수, 업로드 성공률, 실패 건수를 계산합니다. '실패 미처리' KPI 카드는 3건 이상 시 빨간색으로 강조되며, 관리자에게 Slack/이메일 알림도 발송됩니다.

• Supabase RLS — 팀원별 데이터 권한 분리
• Aggregated API — 팀 단위 KPI 실시간 집계

[화면 개요 및 목적]

관리자가 팀 전체의 업로드 이력을 담당자·플랫폼·결과·기간으로 필터링하여 조회하는 화면입니다. 실패 건을 빠르게 식별하고 직접 재시도를 트리거할 수 있으며, 담당자별 책임 소재 확인도 가능합니다.

[핵심 기능 로직]

FastAPI의 업로드 이력 조회 엔드포인트는 Supabase의 upload_logs 테이블을 다중 조건 필터로 쿼리합니다. Row Level Security(RLS)로 관리자 역할만 전체 데이터 조회가 가능합니다. 관리자가 재시도 버튼 클릭 시 해당 태스크가 Celery 큐에 우선순위로 재등록됩니다.

• Supabase RLS — 역할 기반 데이터 접근 제어
• Celery Priority Queue — 실패 건 우선 재시도

[화면 개요 및 목적]

관리자가 플랫폼별·카테고리별 업로드 성과를 시각화된 차트로 확인하고, 데이터 기반 콘텐츠 전략을 수립하는 분석 화면입니다. 기간 필터를 통해 월간/분기 비교가 가능하며 CSV 내보내기로 보고서 작성에도 활용됩니다.

[핵심 기능 로직]

FastAPI의 분석 엔드포인트가 Supabase의 upload_logs 테이블을 집계하여 플랫폼·카테고리·담당자별 통계를 반환합니다. 차트 데이터는 5분 캐싱을 적용하여 DB 부하를 최소화합니다. CSV 내보내기는 스트리밍 응답으로 제공됩니다.

• FastAPI StreamingResponse — CSV 내보내기
• Redis Cache — 집계 데이터 5분 캐싱

[화면 개요 및 목적]

어드민이 Celery 작업 큐의 실시간 상태를 감시하는 관제 화면입니다. 현재 처리 중인 업로드, 대기 건수, 실패 건수를 한눈에 보여주며, 개별 작업의 진행률도 실시간으로 표시됩니다. 이상 상황 시 즉각적인 개입이 가능합니다.

[핵심 기능 로직]

WebSocket 연결로 Celery Worker의 작업 상태 이벤트를 실시간 수신합니다. 작업 진행률은 Worker가 Supabase에 단계별로 기록하며, 브라우저는 0.5초 간격으로 폴링합니다. 실패 건 발생 시 어드민에게 즉시 브라우저 알림과 이메일이 발송됩니다.

• WebSocket + Celery Events — 실시간 큐 상태 동기화
• Celery Flower (내부) — 워커 프로세스 상태 모니터링

[화면 개요 및 목적]

네이버 자동화의 안전성을 관리하는 핵심 어드민 화면입니다. 블로그 업로드의 Rate Limit, Human-like 딜레이, 세션 관리 설정을 조정하고, 연동된 네이버 계정의 상태를 실시간으로 모니터링합니다. '안전도' 지표로 현재 설정의 위험 수준을 즉시 확인합니다.

[핵심 기능 로직]

안전 설정 값은 Supabase의 system_config 테이블에 저장되며 Celery Worker가 업로드 실행 시 이 값을 참조합니다. '재인증 필요' 상태의 계정은 Playwright가 세션 쿠키 만료를 감지하면 자동으로 플래그됩니다. 계정 재인증은 어드민의 수동 로그인 절차를 거칩니다.

• Playwright Session Manager — 쿠키 만료 자동 감지
• Supabase system_config — 안전 설정 중앙 관리

[화면 개요 및 목적]

업로드 실패 로그를 오류 유형별로 분류하여 보여주는 어드민 전용 화면입니다. 토큰 만료·네트워크 오류·탐지 경고 등 원인을 명확히 표시하고, 각 원인에 최적화된 대응 액션(재인증, 자동 재시도, 쿨다운)을 제안합니다.

[핵심 기능 로직]

Playwright Worker가 업로드 실패 시 예외 타입(AuthTokenExpired, ConnectionTimeout, BotDetectionRisk)을 Supabase error_logs 테이블에 기록합니다. 탐지 경고 발생 시 해당 계정의 모든 작업이 자동으로 일시 중단되며, 쿨다운(30분) 후 재개됩니다. 이를 통해 계정 정지를 사전에 예방합니다.

• Playwright Exception Handler — 오류 분류 자동화
• Celery Cooldown Task — 탐지 경고 시 자동 일시정지