작업 개요

essay_3years_6months 쇼케이스 페이지 렌더링 버그 3건 수정, v4 재빌드

수정 내역

BUG-1: renderPipelineStack LLM 데이터 포맷 불일치

• 파일: tools/mcp_slide_builder/templates/article_page.html
• 함수: renderPipelineStack() (line 1402)
• 증상: LLM이 d.layers[{label, items:[{name,desc}]}] 생성, 기존 코드는 d.stages[{label,desc,done,metric}]만 처리 → stages=[], 빈 화면
• 수정: d.stages || d.layers 로 양쪽 fallback, s.items[] 있으면 join(' → ') 으로 desc 생성
• 영향: 섹션 7,8,9,11번 pipeline_stack 정상 렌더링

BUG-2: enhanceArticleBodies 볼드 마커 소실

• 파일: tools/mcp_slide_builder/templates/article_page.html
• 함수: enhanceArticleBodies() (line 992)
• 증상: renderSlides()가 **bold** → <strong> 변환 후, enhanceArticleBodies()가 body.textContent(마커 없음)로 다시 덮어쓰면서 볼드 사라짐
• 수정: body.querySelector('strong, code, pre') 감지 → 이미 처리됐으면 skip
• 영향: 모든 슬라이드 볼드 텍스트 유지

BUG-3: 슬라이드 컨테이너 overflow 클리핑

• 파일: tools/mcp_slide_builder/templates/article_page.html
• CSS: #slide-container (line 125)
• 증상: overflow:hidden + 컨텐츠 높이 초과 → 다이어그램 잘림
• 수정: overflow:hidden → overflow-y:auto, .slide에서 justify-content:center 제거, .art-body에서 max-height:55vh 제거
• 영향: 5번 오빗 다이어그램 포함 모든 슬라이드 스크롤 가능

BUG-0: renderOrbitDiagram (이전 세션)

• 파일: tools/mcp_slide_builder/templates/article_page.html
• 함수: renderOrbitDiagram() (line 1215)
• 수정: d.center.label + d.core 양쪽 포맷 대응, legend HTML 추가
• 영향: 5번 슬라이드 오빗 다이어그램 정상 렌더링

현재 상태

• 템플릿: tools/mcp_slide_builder/templates/article_page.html (수정 완료)
• 출력: docs/slides/essay_3years_6months_v4.html (72KB, 13섹션, 1532줄)
• HTTP 서버: port 8766 (localhost + Tailscale 100.90.83.128)

다음 작업

• 13종 인포그래픽 중 6종만 사용됨 — LLM fill 단계에서 나머지 7종도 강제 적용할지 결정 필요
• enhanceArticleBodies() 코드블록 처리 renderSlides()로 이관 검토

참고

• 원본 소스: docs/essays/3years-6months.md
• ShowcaseSpec 기반 빌드: page_service.py → showcase_builder.py → render_page() → 템플릿
• MCP v2 서버: tools/mcp_slide_builder/_v2/mcp_server_v2.py