검증 가능한 기관 PDF 프레젠테이션 및 데이터 시각화 시스템
이 스킬은 verifiable-pdf-pipeline(데이터 무결성) 및 editorial-page-layout-guidelines(그리드 지오메트리)와 함께 사용되어 맥킨지, 스트라이프 프레스, 세계경제포럼, 이코노미스트 스타일의 16:9 다크 임원용 슬라이드 데크 및 레터 라이트 스위스 아이보리 기관 보고서를 제작합니다.
1. 핵심 불변 규칙: 미학보다 내용이 우선이다
이 스킬로 제작되는 모든 프레젠테이션 및 보고서는 verifiable-pdf-pipeline/SKILL.md에 정의된 10가지 안티치트 하드 규칙을 준수해야 합니다:
- 제로 수기 데이터 에어갭 —
data/raw/폴더의 변경 불가능한 원시 파일에서 모든 숫자를 구문 분석합니다. - 현실 및 불변 컴파일러 — Pydantic 도메인 경계 및 회계 항등식을 적용합니다.
- 비순환 검증 — 독립적인 원시 파일 재계산 + 하드코딩된 리터럴 어설션을 금지하는 Python AST 검사를 수행합니다.
- 원자적 출처 원장 — 게시된 모든 스칼라는
data/provenance_ledger.json에 1:1로 매핑됩니다. - 네거티브 역량 및 신성한 'N/A' — 진정한 상류 널값은 가짜 프록시 대신
[N/A]로 명시적으로 렌더링됩니다. - 컴파일 래치 — PDF 컴파일러는
verify_integrity.py를 호출하며 0이 아닌 종료 코드가 반환되면 중단됩니다. - 범주 및 단위 가드 — 측정할 수 없는 범위나 테스트 방법을 절대 혼합하지 않습니다.
- 법정 증명 — 규제/관세 주장에는 공식 관보 ID가 필요합니다.
- 과학적 분류 및 레지스트리 검증 — 이명법, 권위자, 계통, IUCN 상태를 라이브 GBIF/OpenTree/iNaturalist 레지스트리와 대조하여 정확히 일치시킵니다.
- 렌더링 후 산문 접지 (
vedit prose) — 최종 PDF의 모든 렌더링된 숫자는provenance_ledger.json,summary_metrics.json, 또는background_citations.json의 DOI 지원 항목으로 추적됩니다.
2. 4가지 황금 디자인 법칙
법칙 1: 60-30-10 색상 계층 구조 (라이트 및 다크 모드)
- 라이트 스위스 편집 모드 (레터 보고서):
60%캔버스: 스위스 웜 아이보리 (#fcfbf9) —onPage를 통해 명시적으로 페인팅됩니다.30%스캐폴딩: 딥 네이비 (#0f2b48), 슬레이트 (#334155), 스틸 (#64748b), 헤어라인 (#cbd5e1), 서브틀 틴트 (#f1f5f9).10%시그널 악센트: 코발트 (#0284c7), 앰버 (#d97706), 에메랄드 (#059669), 시그널 크림슨 (#dc2626— 위험/급증 시에만).
- 다크 임원 모드 (16:9 슬라이드 데크):
60%캔버스: 딥 옵시디언 (#0b0f19) 또는 미드나잇 네이비 (#051c2c) — 반드시onFirstPage/onLaterPages에서 플로어블이 렌더링되기 전에 전체 블리드로 페인팅해야 하며, 기본 흰색 PDF 용지에 의존하지 않아야 합니다!30%스캐폴딩 및 고대비 텍스트: 서브틀 토널 밴드 (#111827/#0a253a), 헤어라인 (#243247), 순수 흰색 제목 (#ffffff), 선명한 라이트 본문 (>= #e2e8f0,>= 9.5–10 pt), 보조 캡션 (>= #cbd5e1, 다크에서는 절대#64748b–#94a3b8산문을 사용하지 않음). 파라메트릭 와이어프레임 웨이브나 밝은 아트워크가 텍스트 근처에 있을 때는 항상 커버 타이포그래피 뒤에 미묘한 수평 다크 스크림을 배치합니다.10%시그널 악센트: 일렉트릭 코발트 (#38bdf8), 브라이트 앰버 (#fbbf24), 에메랄드 (#34d399), 시그널 크림슨 (#f87171).
법칙 2: 헤어라인 및 여백 중력 (제로 박스형 카드)
- 지표나 산문을 무거운 직사각형
BOX윤곽선이나INNERGRID웹 대시보드 상자 안에 가두지 마십시오. - KPI 및 콜아웃은 테두리 없는 토널 밴드(다크
#111827/ 라이트#f1f5f9)를 사용하여 그룹화하고, 선명한1.2 pt상단 악센트 헤어라인, 넉넉한12–16 pt열 여백, 투페트 스타일의 세로선 없는 원장(북탭스 스타일)으로 장식합니다.
법칙 3: 민토 피라미드 액션 타이틀
모든 슬라이드 또는 보고서 섹션은 수동적인 주제 레이블이 아닌 하나의 완전하고 단호한 주장으로 시작합니다:
- 금지:
"글로벌 배출량 동향" - 필수:
"OECD-5 국가 배출량 -25.0% 감소, 그러나 신흥 3개국 +235.8% 급증하여 패널 총계 23.52 Gt CO2e로 상승."
법칙 4: 보정된 수직 채우기 예산 + 시각적 검사
- 레터 보고서 (
612×792 pt):85%–92%목표 수직 채우기 (최소 >= 82%). - 16:9 데크 (
960×540 pt):72%–88%목표 수직 채우기 (최소 >= 72%). - 자동화된 패스를 최종 평가로 간주하지 마십시오.
audit_pdf.py를 통해 180 DPI PNG 미리보기를 내보내고 렌더링된 모든 페이지에서 레이블 겹침, 과부 헤드라인 줄바꿈, 광학적 균형을 시각적으로 검사하십시오.
3. 기관 데이터 시각화 레시피 (300 DPI, 투명)
모든 차트는 dpi=300, transparent=True, 상단/오른쪽 스파인 제거, 테마 일치 팔레트(dark vs light)로 렌더링합니다:
- 듀얼 패널 시계열 + 비율 가속도: 히스토리컬 월별/일별 궤적에 이벤트 음영과 직접 시작/피크 주석을 추가하고, 10년/기간 비율 막대와 쌍을 이룹니다.
- 스택 질량 균형 영역 + 인덱스 궤적: 스택 플로우 볼륨에 직접 오른쪽 가장자리 터미널 레이블(별도 부동 범례 상자 없음!)을 추가하고
Base = 100구조적 발산선과 쌍을 이룹니다. - 디커플링 사분면 산점도 + 덤벨 압축: 2D 성장 대 결과 산점도에 음영 처리된 목표 사분면 + 밀집 클러스터용 리더 화살표를 추가하고, 기준선 대 현재 수평 덤벨과 쌍을 이룹니다.
- 스티븐 퓨 수평 불릿 그래프: 3개 질적 배경 밴드 + 기본 성능 막대 + 수직 앰버 기준선/목표 눈금 + 오른쪽 정렬 델타 텍스트(
ax.spines["bottom"].set_bounds(...)를 사용하여 x축 스파인을 자릅니다). - 인메모리 헤드리스 투페트 스파크라인:
46–66 pt × 13–16 pt마이크로 라인을io.BytesIO()버퍼로 렌더링하고 시맨틱 에메랄드/크림슨 터미널 도트와 함께 ReportLab 테이블 셀에 직접 삽입합니다. - 기원-목적지 매트릭스 히트맵 및 능선 KDE: 순차적 팔레트와 대비 전환 듀얼 타이포그래피 또는 $P_{50}$ 및 $P_{90}$을 표시하는 겹치는 분포 능선을 사용합니다.
4. 프로덕션 ReportLab 구현 패턴
4.1 전체 블리드 캔버스 페인팅 (다크 및 아이보리 테마에 중요)
모든 페이지의 플로어블 아래에 캔버스 배경이 페인팅되도록 항상 onPage 콜백을 등록하십시오:
from reportlab.lib import colors
def paint_background(canv, _doc, bg_hex="#0b0f19", accent_hex="#38bdf8", page_w=960.0, page_h=540.0):
canv.saveState()
canv.setFillColor(colors.HexColor(bg_hex))
canv.rect(0, 0, page_w, page_h, fill=1, stroke=0)
if canv.getPageNumber() == 1:
canv.setFillColor(colors.HexColor(accent_hex))
canv.rect(0, page_h - 4, page_w, 4, fill=1, stroke=0)
canv.restoreState()
4.2 안전한 Inter TTF 검색 및 깔끔한 폴백
TTF를 먼저 등록하지 않고 "Inter-SemiBold"를 하드코딩하지 마십시오. INTER_FONT_DIR 및 표준 OS 글꼴 경로를 확인하고 깔끔하게 Helvetica로 폴백되는 헬퍼를 사용하십시오:
import os
from pathlib import Path
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
def register_editorial_fonts() -> dict[str, str]:
search = [Path(os.environ["INTER_FONT_DIR"])] if os.environ.get("INTER_FONT_DIR") else []
search += [Path.home() / "Library/Fonts", Path("/Library/Fonts"), Path("/usr/share/fonts/truetype/inter")]
files = {"regular": "Inter-Regular.ttf", "semibold": "Inter-SemiBold.ttf",
"bold": "Inter-Bold.ttf", "italic": "Inter-Italic.ttf", "bold_italic": "Inter-BoldItalic.ttf"}
found = {r: d / f for d in search if d.is_dir() for r, f in files.items() if (d / f).is_file()}
if {"regular", "bold", "italic", "bold_italic"}.issubset(found):
for role, name in [("regular", "Inter-Regular"), ("bold", "Inter-Bold"),
("italic", "Inter-Italic"), ("bold_italic", "Inter-BoldItalic")]:
pdfmetrics.registerFont(TTFont(name, str(found[role])))
semi = "Inter-Bold"
if "semibold" in found:
pdfmetrics.registerFont(TTFont("Inter-SemiBold", str(found["semibold"])))
semi = "Inter-SemiBold"
pdfmetrics.registerFontFamily("Inter-Regular", normal="Inter-Regular", bold="Inter-Bold",
italic="Inter-Italic", boldItalic="Inter-BoldItalic")
return {"regular": "Inter-Regular", "semibold": semi, "bold": "Inter-Bold",
"italic": "Inter-Italic", "bold_italic": "Inter-BoldItalic", "mono": "Courier"}
return {"regular": "Helvetica", "semibold": "Helvetica-Bold", "bold": "Helvetica-Bold",
"italic": "Helvetica-Oblique", "bold_italic": "Helvetica-BoldOblique", "mono": "Courier"}
4.3 2패스 실행 헤더 및 동적 페이지 번호 매기기
showPage()에서 페이지 상태 딕셔너리를 저장하고 save()에서 "Page X of Y" 또는 "Slide X / Y"를 스탬핑하는 reportlab.pdfgen.canvas.Canvas의 서브클래스를 사용하십시오(examples/reportlab_premium_template.py 참조).
5. 2023 컨설팅 플래그십 모드 (WeasyPrint + 순수 벡터 인라인 SVG)
2023년 주요 기관 간행물(Quantum Technology Monitor, The Economic Potential of Generative AI, Global Economics Intelligence, The State of Organizations)을 모델로 한 기조 연설급 데크를 위해 WeasyPrint (@page { size: 960pt 540pt; margin: 0; }) 와 100% 순수 벡터 인라인 <svg> 전시물을 함께 사용하십시오:
- 다크 히어로 / 순수 백색 데이터 극성 케이던스 (단조 금지):
- 커버 히어로: 딥 미드나잇 네이비 (
#051C2C)에서 코발트 (#0A2E8A)로 전환, 42가닥 파라메트릭 쌍곡선 베지어 와이어프레임 웨이브(#2251FF/#00A9F4)와 오른쪽의 깔끔한 편집 히어로 아트가 오버레이됩니다. - 경영진 요약: 전체 블리드
#051C2C, 선명한28 pt흰색 세리프 헤드라인 위에1.2 pt흰색 수평선, 3개의 여유로운 산스 칼럼, 3개의 거대한 청록색/파란색 세리프 KPI. - 분할 챕터 디바이더: 상단
48%는 전체 블리드 발광 아트워크가120 pt굵은 흰색 세리프 숫자(1,2)에 고정되고, 하단52%는 순수 흰색에220 pt왼쪽 들여쓰기 세리프 챕터 헤드라인 및 2열 프레이밍 카피. - 데이터 전시 슬라이드: 순수
#FFFFFF캔버스,19.5–22 pt굵은 세리프 액션 타이틀 위에1.1 pt#051C2C선, 미묘한 하단 각주 구분선, 오른쪽 하단#9AE6FF아이스 시안 섹션 진행 알약.
- 커버 히어로: 딥 미드나잇 네이비 (
- 고대비 편집 세리프 + 기하학적 산스 페어링:
- 디스플레이 세리프 (
Charter/Georgia/BaskervilleBold): 커버 타이틀, 섹션 숫자, 슬라이드 액션 타이틀, 거대한54 pt#2251FFKPI 콜아웃, 중앙 도넛 합계. - 데이터 산스 (
Inter/Helvetica Neue): 차트 주석, 부제목, 원장 셀, 각주, 영향력 카피.
- 디스플레이 세리프 (
- 4계층 맥킨지 블루 크로매틱 램프 (무지개 혼란 제로):
#051C2C미드나잇 네이비 (앵커 합계, 기준선, 심각한 수축) →#06319C딥 로열 →#2251FF일렉트릭 블루 (초점 델타, 거대 KPI, 확장 급증) →#00A9F4비비드 시안 →#9AE6FF아이스 시안 (이차 점유율 및 섹션 알약).
- 시그니처 벡터 SVG 전시물 원형:
- 질량 균형 폭포수/브리지 차트: 앵커 막대(
#051C2C), 부동 추가(#2251FF) 및 감소(#00A9F4), 점선 스텝 커넥터, 상단 대괄호 범위 콜아웃, 부동 세리프 순 델타. - 소규모 멀티플 월 + 그레이
»영향력 사이드바: 그룹화된5 + 3인덱스 궤적 카드와 오른쪽#EFEFEF사이드바가 원형#051C2C»쉐브론 배지(3 pt흰색 링)로 연결됩니다. - 10×10 라운드 사각형 와플 단위 매트릭스: 하향식 채우기
10×10그리드(#E5E7EB트랙, 4계층 블루 채우기)에 회색 네거티브 공간 안에 중앙 정렬 굵은 숫자가 있습니다. - 도넛 링 + 100% 스택 점유율 이동: 5단계 블루 도넛(
2 px흰색 슬라이스 구분선, 세리프 중앙 합계)과2000대2024열이 반투명 흐름 리본으로 연결됩니다. - WeasyPrint SVG 가드레일: 플렉스 컨테이너 내에서 항상 인라인
<svg>에pt단위의 명시적인width/height를 지정하고(.slide { height: 539.5pt; break-after: page; break-inside: avoid; }설정) 서브픽셀 빈 유출 페이지나300 pxSVG 축소를 방지하십시오. WeasyPrint에서<text>에 SVG 2paint-order="stroke"를 사용하지 마십시오(텍스트 채우기 위에 획을 그림). 대신 깔끔한 레이블 오프셋이나 명시적인 배경<rect>를 사용하십시오.
- 질량 균형 폭포수/브리지 차트: 앵커 막대(
- 전체 블리드 편집 사진 매거진 모드 (
612 × 792 pt레터 포트레이트, WeasyPrint): 사진 중심의 편집 잡지(Kinfolk × Cereal × Condé Nast Traveler × National Geographic 스타일,demos/felis-mundi-magazine/에 설명됨)를 제작할 때:- 타이포그래피 및 용지 재질: 따뜻한 무광택 아카이브 용지(
#FAF8F5)와 진한 카본 차콜 잉크(#161616), 고대비 디도네 디스플레이 세리프(Didot/Bodoni 72), 따뜻한 북 세리프 본문 카피(Charter/Baskerville,9 pt,1.5×행간), 넓은 자간 대문자 산스 메타데이터(Inter,6.5–7 pt,+0.18em자간)를 페어링합니다. 실행 folio 및 크레딧을 전체 블리드 사진 위에서 순수#FFFFFF로 매끄럽게 전환합니다. - 일관된 사진 (
>= 50%가장자리 간 블리드): 잠긴 마스터 사진 필름 아이덴티티 코어 아래에서 모든 플레이트를 생성하고(references/image_generation_recipes.md§5 참조), 인접 페이지에 걸쳐 스프레드 아키텍처를 다양화하며(100% 커버 → 61% 상단 블리드 → 65% 오른쪽 세로 열 → 100% 포토 에세이 → 76%4 pt흰색 인쇄 여백이 있는 2면화 → 68% 하단 블리드 → 77% 연락처 시트 3면화 → 100% 마감 황혼 콜로폰), AI 사진을 SHA-256 플레이트 매니페스트와 함께 투명하게 크레딧합니다. - WeasyPrint 매거진 가드레일 (경험적으로 검증됨):
- 드롭 캡 (
float: left): WeasyPrint 67.0의 CSS Grid 또는 Flexbox 항목 내에float: left드롭 캡을 절대 배치하지 마십시오(텍스트 열이 축소되거나 드롭 캡이 잘못 오프셋/충돌합니다). 분할 잡지 페이지의 경우position: absolute블록 열(display: block)을 사용하여 드롭 캡이 깔끔한 여러 줄 줄바꿈과 함께 100% 왼쪽 정렬되도록 하십시오. - 매끄러운 그라데이션 스크림: WeasyPrint에서 밝은 하늘이나 눈 위에 부분 높이
linear-gradient오버레이 상자를 절대 배치하지 마십시오(Cairo가 상자 가장자리를 따라 희미한 1px 헤어라인 이음을 페인트합니다). 항상 모든 스크림 오버레이의 크기를 사진 컨테이너의100%로 조정하고 투명 정지점 내에서rgba(..., 0)으로 페이드아웃하십시오. - 회전된 여백 크레딧: 세로 오른쪽 가장자리 크레딧을
top: 18pt; right: 16pt; transform-origin: 100% 0%; transform: rotate(90deg); white-space: nowrap;으로 고정하고, WeasyPrint 67.0의 알려진 변환 버그를 방지하기 위해 절대 위치 지정된 상위 컨테이너(position: relative)를 사용하십시오.
- 드롭 캡 (
- 타이포그래피 및 용지 재질: 따뜻한 무광택 아카이브 용지(