"""DA-11 + DA-21: 슬라이드 조합 렌더러.
블록 배치 명세(JSON)를 받아 Jinja2로 HTML을 생성한다.
- 다중 페이지 지원
- 카테고리 경로 지원 (blocks/{category}/{name}.html)
- _legacy fallback (기존 경로 호환)
- 같은 area 블록 그룹핑 (겹침 방지)
"""
from __future__ import annotations
import logging
from collections import OrderedDict
from pathlib import Path
from typing import Any
import yaml
from jinja2 import Environment, FileSystemLoader
logger = logging.getLogger(__name__)
TEMPLATES_DIR = Path(__file__).parent.parent / "templates"
STATIC_DIR = Path(__file__).parent.parent / "static"
CATALOG_PATH = TEMPLATES_DIR / "catalog.yaml"
# 카테고리 검색 순서
BLOCK_CATEGORIES = ["headers", "cards", "tables", "visuals", "emphasis", "media"]
# catalog.yaml에서 id → template 경로 매핑 로드 (BF-10: mtime 체크로 자동 갱신)
_CATALOG_MAP: dict[str, str] | None = None
_CATALOG_MTIME: float = 0.0
def _load_catalog_map() -> dict[str, str]:
"""catalog.yaml에서 블록 id → template 경로 매핑을 로드한다.
파일 수정시간(mtime)을 확인하여, 변경 시에만 재로드한다.
"""
global _CATALOG_MAP, _CATALOG_MTIME
current_mtime = CATALOG_PATH.stat().st_mtime if CATALOG_PATH.exists() else 0.0
if _CATALOG_MAP is not None and _CATALOG_MTIME == current_mtime:
return _CATALOG_MAP # 파일 변경 없음 → 캐시 재사용
# 변경 감지 또는 첫 로드 → 새로 읽기
_CATALOG_MTIME = current_mtime
_CATALOG_MAP = {}
if CATALOG_PATH.exists():
try:
with open(CATALOG_PATH, encoding="utf-8") as f:
catalog = yaml.safe_load(f)
for block in catalog.get("blocks", []):
block_id = block.get("id", "")
template = block.get("template", "")
if block_id and template:
_CATALOG_MAP[block_id] = template
logger.info(f"catalog.yaml 로드: {len(_CATALOG_MAP)}개 블록 매핑")
except Exception as e:
logger.warning(f"catalog.yaml 로드 실패: {e}")
else:
logger.warning(f"catalog.yaml 미발견: {CATALOG_PATH}")
return _CATALOG_MAP
def create_jinja_env() -> Environment:
"""Jinja2 환경 생성."""
return Environment(
loader=FileSystemLoader(str(TEMPLATES_DIR)),
autoescape=False,
)
def _resolve_template_path(env: Environment, block_type: str) -> str | None:
"""블록 타입으로 템플릿 경로를 찾는다.
검색 순서:
0. catalog.yaml 매핑 (id → template 경로, 최우선)
1. 정확한 경로 (blocks/cards/card-icon-desc.html 등 — 팀장이 카테고리 포함 지정)
2. 카테고리 폴더 검색 (blocks/{category}/{block_type}.html)
3. _legacy fallback (blocks/_legacy/{block_type}.html)
4. 루트 fallback (blocks/{block_type}.html)
"""
candidates = []
# 0. catalog.yaml에서 id → template 매핑 조회 (최우선)
catalog_map = _load_catalog_map()
if block_type in catalog_map:
catalog_path = catalog_map[block_type]
candidates.append(catalog_path)
# .html 확장자 없는 경우 대비
if not catalog_path.endswith(".html"):
candidates.append(f"{catalog_path}.html")
# 1. 이미 카테고리 경로가 포함된 경우 (예: "cards/card-icon-desc")
if "/" in block_type:
candidates.append(f"blocks/{block_type}.html")
candidates.append(f"blocks/{block_type}") # .html 이미 포함된 경우
# 2. 카테고리 폴더 검색
for category in BLOCK_CATEGORIES:
candidates.append(f"blocks/{category}/{block_type}.html")
# 3. _legacy fallback
candidates.append(f"blocks/_legacy/{block_type}.html")
# 4. 루트 fallback
candidates.append(f"blocks/{block_type}.html")
for path in candidates:
try:
env.get_template(path)
return path
except Exception:
continue
return None
def _preprocess_svg_data(block_type: str, block_data: dict[str, Any]) -> dict[str, Any]:
"""P2-B: SVG 시각화 블록의 좌표를 사전 계산한다.
venn-diagram: items[]에 cx, cy, r 좌표 추가 + outer_r 등 레이아웃 데이터
다른 블록: 변경 없이 그대로 반환
"""
SVG_BLOCKS = {"venn-diagram", "relationship"}
if block_type not in SVG_BLOCKS:
return block_data
items = block_data.get("items", [])
if not items:
return block_data
# items에 이미 cx가 있으면 (수동 지정) 그대로 사용
if items[0].get("cx") is not None:
return block_data
try:
from src.svg_calculator import prepare_venn_data
prepared = prepare_venn_data(
items=items,
center_label=block_data.get("center_label", ""),
center_sub=block_data.get("center_sub", ""),
description=block_data.get("description", ""),
)
# 기존 block_data에 계산 결과 병합
block_data.update(prepared)
logger.info(
f"SVG 좌표 계산 완료: {block_type}, "
f"{len(items)}개 원소, outer_r={prepared.get('outer_r')}"
)
except Exception as e:
logger.warning(f"SVG 좌표 계산 실패 ({block_type}): {e}. Phase 1 fallback.")
# fallback: 좌표 없이 Jinja2에 전달 → Phase 1 고정 SVG
return block_data
def _group_blocks_by_area(
blocks: list[dict[str, Any]],
container_specs: dict | None = None,
) -> list[dict[str, Any]]:
"""Phase O: 같은 area의 블록들을 비중 기반 컨테이너로 그룹핑한다.
container_specs가 있으면 body zone 안에 역할별 고정 높이 컨테이너를 생성.
"""
grouped = OrderedDict()
for block in blocks:
area = block["area"]
if area not in grouped:
grouped[area] = {"area": area, "blocks": []}
grouped[area]["blocks"].append(block)
result = []
for area, data in grouped.items():
block_list = data["blocks"]
# Phase O: body zone에 컨테이너 스펙 적용
if container_specs and area in ("body", "left", "right", "hero", "detail"):
container_htmls = []
assigned_ids = set()
role_order = ["배경", "본심"]
for role in role_order:
spec = container_specs.get(role)
if not spec or spec.zone != area:
continue
# 이 역할에 속하는 블록 찾기 (topic_id로 매칭)
role_blocks = [
b for b in block_list
if b.get("_topic_id") in spec.topic_ids
and id(b) not in assigned_ids
]
# topic_id 매칭 안 되면 순서로 매칭
if not role_blocks:
for b in block_list:
if id(b) not in assigned_ids:
role_blocks.append(b)
if len(role_blocks) >= len(spec.topic_ids):
break
for b in role_blocks:
assigned_ids.add(id(b))
if not role_blocks:
continue
inner_html = "\n".join(b["html"] for b in role_blocks)
font_size = spec.block_constraints.get("font_size_px", 15.2)
padding = spec.block_constraints.get("padding_px", 20)
container_htmls.append(
f'
\n'
f'{inner_html}\n
'
)
# 미배정 블록
for b in block_list:
if id(b) not in assigned_ids:
container_htmls.append(b["html"])
html = "\n".join(container_htmls)
elif len(block_list) == 1:
html = block_list[0]["html"]
else:
inner = "\n".join(b["html"] for b in block_list)
html = (
f'
\n'
f'{inner}\n
'
)
result.append({"area": area, "html": html})
return result
def render_multi_page(layout_concept: dict[str, Any]) -> str:
"""다중 페이지 레이아웃 컨셉으로 완성 HTML을 생성한다."""
env = create_jinja_env()
title = layout_concept.get("title", "슬라이드")
pages = layout_concept.get("pages", [])
if not pages:
logger.warning("페이지가 없습니다. 빈 HTML 반환.")
return "
페이지가 없습니다.
"
pages_rendered = []
for page_idx, page in enumerate(pages):
blocks_raw = []
for block in page.get("blocks", []):
block_type = block.get("type", "")
block_data = block.get("data", {})
# 높이 자동 조치: _strip_sub_text 플래그 처리
if block_data.get("_strip_sub_text"):
block_data.pop("sub_text", None)
block_data.pop("_strip_sub_text", None)
# P2-B: SVG 시각화 블록은 좌표 사전 계산
block_data = _preprocess_svg_data(block_type, block_data)
# DA-21: 카테고리 경로 검색
template_path = _resolve_template_path(env, block_type)
if template_path:
try:
block_template = env.get_template(template_path)
rendered_html = block_template.render(**block_data)
except Exception as e:
logger.warning(f"블록 렌더링 실패 ({block_type}): {e}")
rendered_html = (
f'