# 2026-07-08 데이터 폴더 입력 명세 작성

**소요 시간**: 15분
**Context 사용량**: input 120k / output 10k tokens (추정)

## 요청
- 웹플레이어가 동영상이 있는 폴더 경로를 전달받아 재생할 때 **필요한 데이터 명세** 작성

## 산출물
- `docs/명세_GhiVideo_데이터폴더_입력명세.md` (+ `.html` / `.pdf`, md2docs.sh 변환)
  - 폴더 구성 요약(필수 4종 + 선택 2종 + 무시 파일), 파일별 상세 명세(컬럼·단위·폴백 규칙), 인코딩 공통 규칙, 누락 시 동작, 소스 근거 매핑
  - 근거 코드: `client/src/utils/geoData.ts` (loadFolderGeoData 및 개별 파서), `client/src/types/geo.ts` (RouteMeta/RouteInfo/RouteStructure)
  - 실데이터 검증: `/mnt/d/_project/20260612_abcvideo/import data/` 상행·하행 v3.0 폴더의 실제 헤더·route.json 확인

## 발견 이슈 (문서 3.3절 주의사항으로 명기)
- **상행 v3.0 `01)측점.csv` 표고 컬럼 불일치**: 실측 표고가 `z` 컬럼에 있고 `Z좌표`=0.0인데,
  파서(parseStations)는 `Z좌표_한국` → `Z좌표` 순서만 읽음 → **표고가 0으로 로드됨**.
  하행 파일(`Z좌표_한국` 있음)은 정상. 해결: 데이터 컬럼명 통일 또는 파서에 `z` 폴백 추가 필요.

## 참고
- 필수 파일: `<base>.MP4`, `<base>.csv`(비행로그), `01)측점.csv`(또는 측점.csv), `<base>.kmz`(POI·구조물 유일 소스 — CSV 폴백 없음)
- 선택 파일: `<base>.route.json`(노선정보·구조물 보정), `<base>_poi_overrides.json`(드래그 역투영 보정값)