37 lines
2.6 KiB
Markdown
37 lines
2.6 KiB
Markdown
# TechViz examples — diagram-only fixtures
|
|
|
|
이 폴더는 기술 블로그와 사내 문서에 바로 삽입할 수 있는 **실용적 다이어그램 품질 기준**입니다. 0.2.0의 편집형 카드·헤드라인·하단 메시지 띠를 제거하고, 관계를 이해하는 데 필요한 요소만 SVG 캔버스에 남겼습니다.
|
|
|
|
|
|
|
|
| Fixture | 구조 | SVG |
|
|
|---|---|---|
|
|
| [01-component-flow](01-component-flow/) | `component_flow` | [payment-event-flow.svg](01-component-flow/payment-event-flow.svg) |
|
|
| [02-orchestrator-workers](02-orchestrator-workers/) | `orchestrator_workers` | [mission-workers.svg](02-orchestrator-workers/mission-workers.svg) |
|
|
| [03-query-fanout](03-query-fanout/) | `query_fanout` | [metrics-query-fanout.svg](03-query-fanout/metrics-query-fanout.svg) |
|
|
| [04-timeline](04-timeline/) | `timeline` | [retention-cycle.svg](04-timeline/retention-cycle.svg) |
|
|
| [05-reconciliation-loop](05-reconciliation-loop/) | `reconciliation_loop` | [declarative-vm.svg](05-reconciliation-loop/declarative-vm.svg) |
|
|
| [06-resource-architecture](06-resource-architecture/) | `resource_controller` | [dbaas-controller.svg](06-resource-architecture/dbaas-controller.svg) |
|
|
| [07-localization-pipeline](07-localization-pipeline/) | `two_zone_pipeline` | [localization-pipeline.svg](07-localization-pipeline/localization-pipeline.svg) |
|
|
| [08-sequence](08-sequence/) | `sequence` | [payment-approval-sequence.svg](08-sequence/payment-approval-sequence.svg) |
|
|
| [09-ports-adapters](09-ports-adapters/) | `ports_adapters` | [order-ports-adapters.svg](09-ports-adapters/order-ports-adapters.svg) |
|
|
|
|
## 핵심 변경
|
|
|
|
- 예제 SVG에는 전역 제목·부제·footer·결론 띠가 없습니다.
|
|
- 그라디언트, 그림자, glow, 장식용 badge를 사용하지 않습니다.
|
|
- 색은 관계·상태를 구분할 때만 사용합니다.
|
|
- `composition.json`은 그림의 논리 구조와 금지 요소를 함께 기록합니다.
|
|
- `STYLE_CONTRACT.md`가 향후 compositor와 모델 프롬프트의 기본 시각 계약입니다.
|
|
|
|
`assets/`, `docs/`, `work/`는 기존 런타임 렌더러의 회귀 테스트 자료이므로 그대로 유지합니다. 번호 디렉터리는 다음 렌더러가 목표로 삼을 품질 fixture입니다.
|
|
|
|
## 재생성
|
|
|
|
```bash
|
|
python examples/build_examples.py
|
|
python examples/validate_examples.py
|
|
```
|
|
|
|
빌드 스크립트는 SVG, PNG preview, gallery, `manifest.json`, `CHECKSUMS.sha256`를 결정적으로 다시 생성합니다. 검증 스크립트는 title/footer/effect 금지 규칙과 접근성 메타데이터를 검사합니다.
|