Files
technical-visualization-haness/examples/README.md
T

2.6 KiB

TechViz examples — diagram-only fixtures

이 폴더는 기술 블로그와 사내 문서에 바로 삽입할 수 있는 실용적 다이어그램 품질 기준입니다. 0.2.0의 편집형 카드·헤드라인·하단 메시지 띠를 제거하고, 관계를 이해하는 데 필요한 요소만 SVG 캔버스에 남겼습니다.

gallery

Fixture 구조 SVG
01-component-flow component_flow payment-event-flow.svg
02-orchestrator-workers orchestrator_workers mission-workers.svg
03-query-fanout query_fanout metrics-query-fanout.svg
04-timeline timeline retention-cycle.svg
05-reconciliation-loop reconciliation_loop declarative-vm.svg
06-resource-architecture resource_controller dbaas-controller.svg
07-localization-pipeline two_zone_pipeline localization-pipeline.svg
08-sequence sequence payment-approval-sequence.svg
09-ports-adapters ports_adapters order-ports-adapters.svg

핵심 변경

  • 예제 SVG에는 전역 제목·부제·footer·결론 띠가 없습니다.
  • 그라디언트, 그림자, glow, 장식용 badge를 사용하지 않습니다.
  • 색은 관계·상태를 구분할 때만 사용합니다.
  • composition.json은 그림의 논리 구조와 금지 요소를 함께 기록합니다.
  • STYLE_CONTRACT.md가 향후 compositor와 모델 프롬프트의 기본 시각 계약입니다.

assets/, docs/, work/는 기존 런타임 렌더러의 회귀 테스트 자료이므로 그대로 유지합니다. 번호 디렉터리는 다음 렌더러가 목표로 삼을 품질 fixture입니다.

재생성

python examples/build_examples.py
python examples/validate_examples.py

빌드 스크립트는 SVG, PNG preview, gallery, manifest.json, CHECKSUMS.sha256를 결정적으로 다시 생성합니다. 검증 스크립트는 title/footer/effect 금지 규칙과 접근성 메타데이터를 검사합니다.