← 서비스로 돌아가기

ADMIN GUIDE

NewsLetterPlatform 관리자 가이드

뉴스레터 발송, 구독자 관리, 스케줄 모니터링을 위한 관리자 안내

1. 관리 기능 개요

NewsLetterPlatform 관리자 대시보드는 멀티테넌트 뉴스레터 서비스의 전체 운영 현황을 한눈에 파악하고, 구독자 관리, 수동 발송, 발송 이력 조회 등 핵심 관리 기능을 제공합니다.

대상 사용자

2. 주요 기능

3. 권한 및 인증

1. 관리자 로그인
   /admin/login 페이지에서 관리자 비밀번호 또는 Google Sign-In으로 로그인합니다.
2. 세션 유지
   로그인 후 세션 쿠키가 발급됩니다. 브라우저를 닫거나 로그아웃하면 세션이 종료됩니다.
3. 관리 페이지 접근
   모든 /admin/* 경로는 인증이 필요합니다. 미인증 시 자동으로 로그인 페이지로 이동합니다.

4. 주요 화면 안내

대시보드 (/admin)

전체 테넌트의 현황을 요약합니다. 테넌트별 구독자 수, 오늘 발송 건수, 성공률, 최근 오류 목록을 확인할 수 있습니다.

구독자 관리 (/admin/{tenant}/subscribers)

테넌트별 구독자 목록을 조회합니다. 이메일/이름 검색, 활성/전체 필터, 신규 구독자 추가, 활성/비활성 토글, CSV 내보내기 기능을 제공합니다.

수동 발송 (/admin/{tenant}/send)

일일/주간/월간 뉴스레터 미리보기와 테스트 발송을 실행합니다. 데이터 수집(Collect)과 전체 발송(Send) 버튼으로 수동 운영이 가능합니다.

발송 이력 (/admin/{tenant}/history)

테넌트별 발송 결과를 날짜, 성공/실패 상태로 필터링합니다. 최근 7일 요약 테이블이 상단에 표시됩니다.

통합 발송 이력 (/admin/history)

전체 테넌트의 발송 이력을 하나의 화면에서 통합 조회합니다. 테넌트 드롭다운으로 필터링할 수 있습니다.

스케줄러 (/admin/scheduler)

일일, 주간, 월간 뉴스레터 발송 스케줄 구성과 현재 동작 상태를 모니터링합니다.

5. 테넌트별 데이터 수집

AllergyInsight - 뉴스 수집

AllergyInsight 일일 뉴스레터의 [오늘의 주요 뉴스] 섹션은 AllergyInsight Backend의 공개 API를 통해 최신 뉴스만 수집합니다.

항목	설명
API 엔드포인트	/api/public/analytics/news/recent (공개, 인증 불필요)
필터링	LLM 분석 완료(is_processed) + 관련성 확인(is_relevant) 뉴스만 포함
신선도	max_age_days=2 — 발행일 기준 2일 이내 뉴스만 수집
정렬	발행일 최신순(published_at DESC), 중요도는 2차 정렬
최대 건수	10건 (템플릿에서 상위 3건 표시)
뉴스 없는 날	"오늘은 새로운 알러지 관련 뉴스가 없습니다" 안내 표시

EduFit - 뉴스 수집

EduFit 일일 뉴스레터는 EduFit Backend API에서 사전 렌더링된 HTML을 직접 수신하여 발송합니다.

6. 주의사항

7. 자주 묻는 질문