# 전체 흐름 다이어그램 작성 (보고서 삽입용)

**소요 시간**: 약 10분
**Context 사용량**: input ~180k / output ~6k tokens

## 요청

- 스테이션기반 플레이어의 **전체 흐름을 다이어그램**으로 표현 (사용자 보고서 삽입용).

## 산출물

- `docs/그림_전체흐름도.png` (2400×1100, 고해상도) / `docs/그림_전체흐름도.pdf` (압축)
- `scripts/fig_전체흐름도.py` — **재생성 스크립트** (문구·색 수정 후 `python3 scripts/fig_전체흐름도.py` 재실행)

## 다이어그램 구성 (좌→우 4단)

1. **입력 — 데이터 폴더 1개** (회색 그룹): 영상(mp4) / 드론 비행로그(csv, 위치·자세각·초점) / 측점(csv, 실측 정표고) / POI·구조물(kmz) + 노선 보정(json·선택)
2. **① 자동 파싱** (파랑): 인코딩 자동감지 · KMZ 해제
3. **② 좌표·측점 계산** (초록 2박스): 시간↔측점 대응표 생성 / 좌표 투영 계산(드론 위치·자세각 → 화면 픽셀)
4. **③ 화면 출력** (황금 3박스): 측점 스테이션바 / 영상 AR 오버레이 / 대용량 영상 재생
- 하단 엘보 경로: "영상 원본은 계산 없이 곧바로 스트리밍 재생" (계산 우회 표현)

## 기술 방식

- 직전 확립한 **PIL 직접 드로잉** 파이프라인 (weasyprint SVG 디센더 잘림 회피). 폰트 자동 축소(fit) 헬퍼로 박스 폭 초과 방지.
- 용어는 최근 정정 사항 반영: "스테이션기반", "드론 촬영 철도시설물 영상", "자세각", "시간↔측점 대응표".

## 검증

- PNG 육안 검증: 글자 잘림 없음, 배치·화살표 정상 ✅