# 노트북 시연 가이드

폴더 선택 기반 재생(드론 영상 + 측점/지장물 오버레이) 시연은 **Node.js만 있으면** 동작한다.
WSL/PM2/FFmpeg 불필요 (FFmpeg 은 HLS 변환·서버 프레임추출용 — 시연 흐름에서 안 씀).

## 1. 사전 준비 (사무실, 인터넷 필요)

1. 노트북에 **Node.js 20 LTS** 설치 — https://nodejs.org (Windows 인스톨러)
2. 소스 받기 (둘 중 하나)
   - `git clone https://gitea.hmac.kr/b23042/GhiVideo_v4.git`
   - 또는 현재 PC 의 저장소 폴더를 통째로 복사 (node_modules 제외)
3. 저장소 루트에서:
   ```bat
   npm install
   npm run build
   ```
4. **시연 데이터 폴더 복사** — `경로 1-1` 폴더 전체(약 12GB)를 노트북 아무 곳에나:
   - 영상 4개(DJI_*.MP4), 비행로그 CSV, 측점/지장물 KML, route.json
   - **`*.camera.json` / `*.display.json`(환경설정 파일) 포함** — 캘리브레이션 자동 적용됨

## 2. 시연 실행

- 저장소 루트의 **`start-demo.bat` 더블클릭** → 브라우저가 http://localhost:54000 자동 오픈
- 화면 가운데 **[폴더 선택]** → 복사해 둔 `경로 1-1` 폴더 선택
- 자동으로: 첫 영상 재생 + 측점/지장물/궤적/선형 오버레이 + 카메라 보정 적용 + 이름순 연속재생

## 3. 주의사항

- **사전 리허설 필수**: 시연 전 노트북에서 위 흐름 1회 확인
- **오프라인 시연**: 나침반 '지도(street/sat)' 스타일은 외부 타일 프록시라 인터넷 필요 →
  오프라인이면 나침반을 '눈금(analog)'으로 (display.json 기본이 analog 라 문제 없음)
- 브라우저는 Chrome/Edge 권장 (폴더 선택 webkitdirectory)
- 영상이 고사양(4K60, 150Mbps)이라 저사양 노트북에서는 1x 재생 위주로 시연 권장
- 서버 종료: bat 창에서 Ctrl+C (또는 창 닫기)

## 4. (선택) FFmpeg

서버 업로드·HLS 변환·정밀 프레임 추출까지 시연하려면 FFmpeg 설치 후 PATH 등록:
https://www.gyan.dev/ffmpeg/builds/ → 미설치 시 해당 기능만 비활성(경고 로그), 나머지 정상.