Files
blog-writer/dashboard/backend/api_novels.py
sinmb79 213f57b52d feat: v3.1 대시보드 추가 (React + FastAPI)
Media Engine Control Panel — 6탭 웹 대시보드

[백엔드] FastAPI (dashboard/backend/)
- server.py: 포트 8080, CORS, React SPA 서빙
- api_overview.py: KPI 카드 + 파이프라인 상태 + 활동 로그
- api_content.py: 칸반 보드 + 승인/거부 + 수동 트리거
- api_analytics.py: 방문자 추이 + 플랫폼/코너별 성과
- api_novels.py: 소설 목록/생성/에피소드 관리
- api_settings.py: engine.json CRUD
- api_connections.py: AI 서비스 연결 관리 + 키 저장
- api_tools.py: 기능별 AI 도구 선택
- api_cost.py: 구독 현황 + API 사용량 추적
- api_logs.py: 시스템 로그 필터/검색

[프론트엔드] React + Vite + Tailwind + Recharts (dashboard/frontend/)
- Overview: KPI 카드 + 파이프라인 + 코너별 바차트 + 활동 로그
- Content: 4열 칸반 보드 + 상세 모달 + 승인/거부
- Analytics: LineChart 방문자 추이 + 플랫폼별 성과
- Novel: 소설 목록 + 에피소드 테이블 + 새 소설 생성 폼
- Settings: 5개 서브탭 (AI연결/도구선택/배포채널/품질/비용관리)
- Logs: 필터/검색 시스템 로그 뷰어

[디자인] CNN 다크+골드 테마
- 배경 #0a0a0d + 액센트 #c8a84e
- 모바일 반응형 (Tailscale 외부 접속 대응)

[실행]
- dashboard/start.bat 더블클릭 → http://localhost:8080

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-26 13:17:53 +09:00

171 lines
5.7 KiB
Python

"""
dashboard/backend/api_novels.py
Novel 탭 API — 소설 목록, 새 소설 생성, 에피소드 생성
"""
import json
import sys
from datetime import datetime
from pathlib import Path
from fastapi import APIRouter, HTTPException
from pydantic import BaseModel
BASE_DIR = Path(__file__).parent.parent.parent
NOVELS_CONFIG_DIR = BASE_DIR / "config" / "novels"
NOVELS_DATA_DIR = BASE_DIR / "data" / "novels"
router = APIRouter()
class NewNovelRequest(BaseModel):
novel_id: str
title: str
title_ko: str
genre: str
setting: str
characters: str
base_story: str
publish_schedule: str = "매주 월/목 09:00"
episode_count_target: int = 50
@router.get("/novels")
async def get_novels():
"""config/novels/*.json 읽어 반환"""
NOVELS_CONFIG_DIR.mkdir(parents=True, exist_ok=True)
novels = []
for path in sorted(NOVELS_CONFIG_DIR.glob("*.json")):
try:
data = json.loads(path.read_text(encoding="utf-8"))
# 에피소드 수 계산
ep_dir = NOVELS_DATA_DIR / data.get("novel_id", path.stem) / "episodes"
ep_files = list(ep_dir.glob("ep*.json")) if ep_dir.exists() else []
ep_files = [
f for f in ep_files
if "_summary" not in f.name and "_blog" not in f.name
]
data["episode_files"] = len(ep_files)
# 에피소드 목록 로드
episodes = []
for ef in sorted(ep_files, key=lambda x: x.name)[-10:]: # 최근 10개
try:
ep_data = json.loads(ef.read_text(encoding="utf-8"))
episodes.append({
"episode_num": ep_data.get("episode_num", 0),
"title": ep_data.get("title", ""),
"generated_at": ep_data.get("generated_at", "")[:10],
"word_count": ep_data.get("word_count", 0),
})
except Exception:
pass
data["episodes"] = episodes
# 진행률
target = data.get("episode_count_target", 0)
current = data.get("current_episode", len(ep_files))
data["progress"] = round(current / target * 100) if target else 0
novels.append(data)
except Exception:
pass
return {"novels": novels}
@router.post("/novels")
async def create_novel(req: NewNovelRequest):
"""새 소설 config 생성"""
NOVELS_CONFIG_DIR.mkdir(parents=True, exist_ok=True)
config_path = NOVELS_CONFIG_DIR / f"{req.novel_id}.json"
if config_path.exists():
raise HTTPException(status_code=409, detail="이미 존재하는 소설 ID입니다.")
novel_config = {
"novel_id": req.novel_id,
"title": req.title,
"title_ko": req.title_ko,
"genre": req.genre,
"setting": req.setting,
"characters": req.characters,
"base_story": req.base_story,
"publish_schedule": req.publish_schedule,
"episode_count_target": req.episode_count_target,
"current_episode": 0,
"status": "active",
"created_at": datetime.now().isoformat(),
"episode_log": [],
}
config_path.write_text(
json.dumps(novel_config, ensure_ascii=False, indent=2),
encoding="utf-8"
)
# 데이터 디렉터리 생성
novel_data_dir = NOVELS_DATA_DIR / req.novel_id
for sub in ["episodes", "shorts", "images"]:
(novel_data_dir / sub).mkdir(parents=True, exist_ok=True)
return {"success": True, "novel_id": req.novel_id, "message": f"소설 '{req.title_ko}' 생성 완료"}
@router.post("/novels/{novel_id}/generate")
async def generate_episode(novel_id: str):
"""다음 에피소드 생성 — NovelManager.run_episode_pipeline() 호출"""
config_path = NOVELS_CONFIG_DIR / f"{novel_id}.json"
if not config_path.exists():
raise HTTPException(status_code=404, detail="소설을 찾을 수 없습니다.")
try:
sys.path.insert(0, str(BASE_DIR / "bots"))
sys.path.insert(0, str(BASE_DIR / "bots" / "novel"))
from bots.novel.novel_manager import NovelManager
manager = NovelManager()
ok = manager.run_episode_pipeline(novel_id, telegram_notify=False)
if ok:
status = manager.get_novel_status(novel_id)
return {
"success": True,
"episode_num": status.get("current_episode", 0),
"message": f"에피소드 생성 완료",
}
else:
raise HTTPException(status_code=500, detail="에피소드 생성 실패 — 로그 확인")
except ImportError as e:
raise HTTPException(status_code=500, detail=f"모듈 로드 실패: {e}")
except HTTPException:
raise
except Exception as e:
raise HTTPException(status_code=500, detail=str(e))
@router.get("/novels/{novel_id}/episodes")
async def get_episodes(novel_id: str):
"""소설 에피소드 전체 목록"""
ep_dir = NOVELS_DATA_DIR / novel_id / "episodes"
if not ep_dir.exists():
return {"episodes": []}
episodes = []
for ef in sorted(ep_dir.glob("ep*.json"), key=lambda x: x.name):
if "_summary" in ef.name or "_blog" in ef.name:
continue
try:
ep_data = json.loads(ef.read_text(encoding="utf-8"))
episodes.append({
"episode_num": ep_data.get("episode_num", 0),
"title": ep_data.get("title", ""),
"generated_at": ep_data.get("generated_at", "")[:10],
"word_count": ep_data.get("word_count", 0),
"published": ep_data.get("published", False),
})
except Exception:
pass
return {"episodes": episodes}