AI 기반 불법조업 탐지·차단 플랫폼 (React 19 + MapLibre + deck.gl + Zustand + Tailwind CSS)

Go to file

htlee 2e5d55a27f fix(prediction): dark 판정에 한국 AIS 수신 영역 필터 추가 16:00 cron 1차 분석 결과, lightweight path가 6,500척 중 5,250척(80%)을 dark로 판정. 좌표 검증 결과 모두 30~37°N/122~125°E (동중국해/서해)로 한국 AIS 수신소 도달 한계 영역에 위치하여 정상 운항 중에도 20~24h 통째로 수신이 끊기는 자연 gap이 발생. 핫픽스: lightweight path에서 dark 판정 직후 마지막 위치가 북위 32~39.5, 동경 124~132 (한반도 + EEZ + 접속수역 여유 포함) 밖이면 dark를 False로 강제. 한국 측 관심 영역의 dark 탐지는 그대로 유지. 근본 개편(STATIONARY 정박 필터, 진입 후 단절 패턴, gap 임계값 재조정 등)은 12시간 추적 데이터 수집 후 내일 진행.		2026-04-08 16:11:02 +09:00
.claude	chore: .env.development → .example + pre-commit 모노레포 대응	2026-04-07 13:52:53 +09:00
.gitea/workflows	feat: System Flow 뷰어 추가 (system-flow.html) — 102 노드, 133 엣지	2026-04-07 17:10:22 +09:00
.githooks	chore: .env.development → .example + pre-commit 모노레포 대응	2026-04-07 13:52:53 +09:00
backend	feat(backend): Role.colorHex 추가 + V017 migration	2026-04-08 10:52:36 +09:00
database/migration	feat: S1 마스터 데이터 + prediction 기반 DB 스키마 (V008~V013)	2026-04-07 11:49:26 +09:00
deploy	docs: 배포 문서 보강 + CI/CD 모노레포 수정 + CLAUDE.md 배포 섹션	2026-04-07 13:43:19 +09:00
docs	docs: 릴리즈 노트 정리 (2026-04-08)	2026-04-08 13:42:41 +09:00
frontend	fix(frontend): 아이콘 전용 버튼 접근 이름 누락 7곳 보완	2026-04-08 13:16:20 +09:00
prediction	fix(prediction): dark 판정에 한국 AIS 수신 영역 필터 추가	2026-04-08 16:11:02 +09:00
.gitignore	chore: .env.development.example → .env.example (서버 hook .env.* 차단 대응)	2026-04-07 13:54:22 +09:00
ATTRIBUTIONS.md	chore: 팀 워크플로우 기반 초기 프로젝트 구성	2026-04-06 14:11:29 +09:00
CLAUDE.md	docs: 디자인 시스템 SSOT 개발 지침 + 릴리즈 노트 갱신	2026-04-08 13:29:28 +09:00
Makefile	feat: S2 prediction 분석 엔진 모노레포 이식	2026-04-07 12:56:51 +09:00
README.md	chore: 팀 워크플로우 기반 초기 프로젝트 구성	2026-04-06 14:11:29 +09:00

README.md

AI 기반 불법조업 탐지·차단 플랫폼

해양경찰청 AIS 신호 기반 불법 조업 선박 탐지, 단속 의사결정 지원 플랫폼.

기술 스택

분류	기술	버전
프레임워크	React + TypeScript	19.2 / 5.9
번들러	Vite (Rolldown)	8.0
지도	MapLibre GL + deck.gl	5.22 / 9.2
차트	ECharts	6.0
상태관리	Zustand	5.0
스타일	Tailwind CSS + CVA	4.2 / 0.7
다국어	react-i18next	ko / en
린트	ESLint (Flat Config)	10

실행

npm install
npm run dev      # 개발 서버
npm run build    # 프로덕션 빌드 (~480ms)
npm run lint     # ESLint 검사

프로젝트 구조

src/
├── lib/charts/       ECharts 공통 (BaseChart + 프리셋)
├── lib/map/          MapLibre + deck.gl (BaseMap + 레이어 + hooks)
├── lib/i18n/         다국어 (10 네임스페이스, ko/en)
├── lib/theme/        디자인 토큰 + CVA 변형
├── data/mock/        공유 더미 데이터 (7 모듈)
├── stores/           Zustand 스토어 (8개)
├── services/         API 서비스 샘플
├── shared/           공유 UI 컴포넌트
├── features/         도메인별 페이지 (13그룹, 31페이지)
├── app/              라우터, 인증, 레이아웃
└── styles/           CSS (Dark/Light 테마)

문서

문서	설명
docs/architecture.md	아키텍처 현황 (기술스택, 구조, 렌더링 최적화, 테마)
docs/sfr-user-guide.md	SFR 사용자 가이드 (메뉴별 기능 설명, 구현/미구현 현황)
docs/sfr-traceability.md	SFR 요구사항 추적 매트릭스 (개발자용, 소스 경로 포함)
docs/page-workflow.md	31개 페이지 역할 + 4개 업무 파이프라인
docs/data-sharing-analysis.md	데이터 공유 분석 + mock 통합 결과
docs/next-refactoring.md	다음 단계 TODO (API 연동, 실시간, 코드 스플리팅)

SFR 요구사항 대응 현황

20개 SFR 전체 UI 구현 완료. 백엔드 연동 대기 중.

SFR	기능	화면	상태
SFR-01	로그인·권한 관리	`/login`, `/access-control`	UI 완료
SFR-02	환경설정·공지·공통	`/system-config`, `/notices`	UI 완료
SFR-03	통합 데이터 허브	`/data-hub`	UI 완료
SFR-04	AI 예측모델 관리	`/ai-model`	UI 완료
SFR-05	위험도 지도	`/risk-map`	UI 완료
SFR-06	단속 계획·경보	`/enforcement-plan`	UI 완료
SFR-07	단일함정 순찰경로	`/patrol-route`	UI 완료
SFR-08	다함정 경로최적화	`/fleet-optimization`	UI 완료
SFR-09	Dark Vessel 탐지	`/dark-vessel`	UI 완료
SFR-10	어구 탐지	`/gear-detection`	UI 완료
SFR-11	단속·탐지 이력	`/enforcement-history`	UI 완료
SFR-12	모니터링 대시보드	`/dashboard`, `/monitoring`	UI 완료
SFR-13	통계·성과 분석	`/statistics`	UI 완료
SFR-14	외부 서비스 연계	`/external-service`	UI 완료
SFR-15	모바일 서비스	`/mobile-service`	UI 완료
SFR-16	함정 Agent	`/ship-agent`	UI 완료
SFR-17	AI 알림 발송	`/ai-alert`	UI 완료
SFR-18/19	MLOps / LLMOps	`/mlops`	UI 완료
SFR-20	AI Q&A 지원	`/ai-assistant`	UI 완료