# Ship GIS - 해양 선박위치정보 GIS 프론트엔드

## 프로젝트 개요
해양 선박위치정보를 지도 위에 실시간으로 시각화하는 GIS 프론트엔드 애플리케이션.
민간용 데모 버전으로, OSM + OpenSeaMap 기반 지도와 AIS API 폴링 방식의 선박 데이터를 사용.

## 기술 스택
- **프레임워크**: React 18 + Vite 5
- **지도 엔진**: OpenLayers 9 + Deck.gl 9 (MapLibre 전환 예정)
- **상태관리**: Zustand 4
- **HTTP**: Axios
- **스타일**: SASS
- **라우팅**: React Router DOM 6

## 빌드 / 실행
```bash
yarn install         # 의존성 설치
yarn dev             # 로컬 개발 서버 (port 3000)
yarn build           # 프로덕션 빌드
```

## 데이터 소스
- **선박 위치**: SNP-Batch API (`/api/ais-target/search`) HTTP 폴링
  - 초기: 최근 60분 전체 로드
  - 이후: 1분마다 최근 2분 증분 조회
- **인증**: 임시 비활성화 (`VITE_DEV_SKIP_AUTH=true`)

## 환경변수
```env
VITE_BASE_URL=/                                    # 배포 경로
VITE_API_URL=http://211.208.115.83:8041/snp-api   # API 서버
VITE_DEV_SKIP_AUTH=true                            # 인증 우회
```

## 핵심 디렉토리 구조
```
src/
├── api/              # API 클라이언트 (aisTargetApi, signalApi, trackApi)
├── areaSearch/       # 항적분석 모듈
├── assets/           # 이미지, 아이콘 에셋
├── common/           # STOMP 클라이언트 (비활성화)
├── components/       # 공통 컴포넌트 (layout, ship, map, auth, common)
├── hooks/            # 커스텀 훅 (useShipData, useShipLayer 등)
├── map/              # 지도 컨테이너, 레이어, 측정 도구
├── pages/            # 페이지 (Home, Replay)
├── replay/           # 리플레이 모듈
├── scss/             # 글로벌 SCSS
├── stores/           # Zustand 스토어 (ship, map, auth, tracking 등)
├── tracking/         # 항적조회 모듈
├── types/            # 상수 정의
├── utils/            # 유틸리티
└── workers/          # Web Worker (signalWorker)
```

## Git 저장소
- **Remote**: https://gitea.gc-si.dev/gc/ship-gis.git
- **브랜치**: main (보호), develop (작업 브랜치)

## 팀 워크플로우
- 버전: v1.2.0
- 커밋 형식: Conventional Commits (한/영 혼용)
- 브랜치 전략: main ← develop ← feature/*