Admin Dashboard
서버 상태
🟢 API 서버 상태
서버 상태 확인 중…
DB 연결 확인 중…
응답 시간 —
환경 —
마지막 체크: —
📊 Admin Overview
데이터 로딩 중…
전체 Overview JSON 보기 →
API 빠른 링크
📖 문서
📘
Swagger UI
/api/docs
↗
📗
ReDoc
/api/redoc
↗
🗂️
OpenAPI JSON
/api/openapi.json
↗
🔍 헬스 & 모니터링
❤️
헬스체크
/api/health
↗
⚡
빠른 Ping
/api/healthz
↗
🗃️
Admin Overview
/api/admin/overview
↗
🔗 데이터 엔드포인트
🗺️
Roadmap Graph
/api/roadmap/graph
↗
📰
뉴스 Ticker
/api/news/ticker
↗
📈
Roadmap Summary
/api/admin/roadmap/summary
↗
환경변수 체크리스트 (값 없음 — 이름만 표시)
🔑 DATABASE_URL PostgreSQL 연결 문자열 (필수) 필수
🔐 SECRET_KEY JWT 서명용 시크릿 키 필수
🛡️ ADMIN_INTERNAL_KEY 관리자 API 인증 키 (X-Admin-Key 헤더) 필수
🤖 OPENAI_API_KEY LLM Wiki 분석 엔진용 OpenAI 키 필수
🌐 ALLOWED_ORIGINS CORS 허용 도메인 (쉼표 구분, Vercel URL 포함) 권장
📧 SMTP_HOST / SMTP_PORT / SMTP_USER / SMTP_PASS 이메일 발송 (알림/인증) 선택
🗓️ VWORLD_API_KEY VWorld 공간정보 API 선택
Vercel 프론트엔드 환경변수 설정 가이드
▲ Vercel Project Settings → Environment Variables
BACKEND_URL
서버사이드에서 FastAPI 백엔드를 직접 호출할 때 사용 (Next.js API Routes, SSR)
예: https://your-backend.replit.app
NEXT_PUBLIC_API_BASE_URL
클라이언트(브라우저)에서 공개 API를 호출할 때 사용
예: https://your-backend.replit.app/api
NEXT_PUBLIC_ADMIN_API_URL
관리자 전용 API 호출용 기본 URL (클라이언트)
예: https://your-backend.replit.app/api/admin
ADMIN_INTERNAL_KEY
백엔드 관리자 엔드포인트 호출 시 X-Admin-Key 헤더 값
⚠️ 절대 NEXT_PUBLIC_ 접두사 사용 금지 (서버 전용)
📋 설정 체크포인트
✅ CORS 확인
백엔드 ALLOWED_ORIGINS에 Vercel 도메인이 포함되어 있어야 합니다.
예: https://your-app.vercel.app
✅ ADMIN_INTERNAL_KEY 보안
NEXT_PUBLIC_ 접두사 없이 서버 환경변수로만 설정해야 합니다. 클라이언트에 노출되면 관리자 API가 공개됩니다.
⚠️ 배포 환경별 URL
Preview/Production 환경에서 BACKEND_URL 값이 다를 수 있습니다. Vercel에서 환경별 값을 따로 설정하세요.
ℹ️ 현재 이 백엔드 URL
아래 주소를 복사해서 Vercel에 붙여넣으세요.
—