b23042andClaude Fable 5
d38b842e8d
기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제. (node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
23 lines
1.5 KiB
Markdown
23 lines
1.5 KiB
Markdown
# 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`(드래그 역투영 보정값)
|