Files
GhiVideo/docs/history/2026-07-08_1711_데이터폴더-입력명세-작성.md
b23042andClaude Opus 4.8 fe25ce00f1 docs: 발표·특허·AI영상요약 자료 및 작업기록 추가
- 발표자료(좌표투영·측점기반재생) 갱신 + 그림/PDF
- 특허 출원 초안 및 도면
- AI 영상요약 서비스 작업기록(docs/history)
- 관련 scripts 추가

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-09 11:20:03 +09:00

1.5 KiB

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(드래그 역투영 보정값)