gc/ship-gis
1
0
포크 0
코드 이슈 풀 리퀘스트 위키 활동
ac3c204843
ship-gis/CLAUDE.md
htlee ac3c204843 refactor: 민간화 + 팀 프로젝트 구조 전환 
- 해경 관련 코드/에셋 정리 (KCGV, 해경관할구역 FGB, PatrolShipSelector)
- 위성/기상/퍼블리시/레거시 모듈 전체 삭제
- STOMP WebSocket → AIS Target API HTTP 폴링 방식 전환
- 세션 인증 임시 비활성화 (VITE_DEV_SKIP_AUTH)
- 환경변수 민간 데모용으로 재구성
- 팀 워크플로우 v1.2.0 구조 적용 (.claude/rules, skills, settings)
- .githooks, .editorconfig, .node-version 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 06:13:08 +09:00

2.4 KiB
Raw Blame 히스토리

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

빌드 / 실행

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

데이터 소스

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

환경변수

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 저장소

팀 워크플로우

  • 버전: v1.2.0
  • 커밋 형식: Conventional Commits (한/영 혼용)
  • 브랜치 전략: main ← develop ← feature/*