gc/gc-wing

Wing Fleet Dashboard

Go to file

htlee 918b80e06a chore: 팀 프로젝트 워크플로우 세팅 - pnpm → npm 전환 (워크스페이스 유지) - .claude/ 팀 규칙(5), 스킬(4), 설정, hooks 스크립트(3) 추가 - .githooks/ commit-msg, post-checkout, pre-commit 추가 - Nexus npm 프록시 설정 (.npmrc — URL만, 인증 제외) - .editorconfig, .prettierrc, .node-version(24) 추가 - CLAUDE.md 프로젝트 설명서 생성 - Map3D.tsx 미사용 함수 제거 (getDeckShipAngle) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>		2026-02-15 22:18:40 +09:00
.claude	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
.githooks	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
apps	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
data/raw/zones	chore: initial commit	2026-02-15 11:22:38 +09:00
legacy	chore: initial commit	2026-02-15 11:22:38 +09:00
scripts	chore: initial commit	2026-02-15 11:22:38 +09:00
.editorconfig	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
.gitignore	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
.node-version	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
.npmrc	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
.prettierrc	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
CLAUDE.md	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
package-lock.json	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
package.json	chore: 팀 프로젝트 워크플로우 세팅	2026-02-15 22:18:40 +09:00
README.md	chore: initial commit	2026-02-15 11:22:38 +09:00

README.md

WING Fleet Dashboard (Prototype to Project)

This repo started as a single HTML prototype and is being refactored into a structured React + TypeScript project.

Layout

legacy/: original single-file HTML prototype (reference)
data/raw/zones/: raw GeoJSON zone polygons as received
apps/web/: React + TS frontend (MapLibre GL JS + Deck.gl, single WebGL context)
apps/api/: optional API server (proxy/stub)
scripts/: data preparation scripts (e.g. zone reprojection)

What Works Now (GIS Demo)

Live AIS polling (initial 10 minutes, then every 1 minute / last 2 minutes incremental) with MMSI upsert store:
- frontend hook: apps/web/src/features/aisPolling/useAisTargetPolling.ts
- API proxy (CORS safe): apps/api/src/index.ts (GET /api/ais-target/search?minutes=...&bbox=...)
MapLibre basemap:
- default (no MapTiler key): local raster style + OpenSeaMap seamark overlay: apps/web/public/map/styles/osm-seamark.json
- optional (recommended): MapTiler dataviz-dark + Ocean (bathymetry) vector overlays, plus OpenSeaMap seamark raster overlay
Deck.gl layers rendered into MapLibre WebGL context (single context via MapboxOverlay):
- ships IconLayer, zones GeoJsonLayer, optional 3D density HexagonLayer
- map widget: apps/web/src/widgets/map3d/Map3D.tsx
Zone polygons converted to WGS84 GeoJSON:
- input: data/raw/zones/*.json
- build: pnpm prepare:data -> apps/web/public/data/zones/zones.wgs84.geojson
Legacy CN-permit overlay (name/callsign/mmsi match; ring + color by 업종):
- legacy sources: legacy/*.xlsx, legacy/*.jsx
- build: pnpm prepare:data -> apps/web/public/data/legacy/chinese-permitted.v1.json

Quick Start

pnpm install
pnpm prepare:data
pnpm dev:web
(optional) pnpm dev:api # only needed when you start adding DB-backed/local APIs

API server (optional): pnpm dev:api (defaults to http://127.0.0.1:5174)

Ports (dev):

Web (Vite): http://127.0.0.1:5175 (default, strict). Change via WEB_PORT=....
API (Fastify): http://127.0.0.1:5174 (default). Change via PORT=.... and match API_PORT=.... for the web proxy.

Vite proxy (dev):

/snp-api/* -> http://211.208.115.83:8041 (override via VITE_SNP_API_TARGET=...)

MapTiler (Optional, Bathymetry Vector Map)

To enable a dark-mode basemap + bathymetry (MapTiler Ocean tiles):

Create a free MapTiler Cloud account and get an API key
Set env vars for the web app:

# enables MapTiler style + ocean bathymetry layers in MapLibre
VITE_MAPTILER_KEY="YOUR_KEY"

# optional: change basemap style id (default: dataviz-dark)
VITE_MAPTILER_BASE_MAP_ID="dataviz-dark"