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

Go to file

htlee 4e6ac8645a feat: S5 프론트 실데이터 전환 — EventList/Statistics/EnforcementHistory/Dashboard KPI 이벤트 목록 (EventList): - eventStore를 GET /api/events 호출로 전환 - 서버 필터링 (level/status/category), 페이지네이션 - 상태 배지 (NEW/ACK/IN_PROGRESS/RESOLVED/FALSE_POSITIVE) - getEventStats() 기반 KPI 카드 단속 이력 (EnforcementHistory): - 신규 services/enforcement.ts (GET/POST /enforcement/records, /plans) - enforcementStore를 API 기반으로 전환 - KPI 카드 (총단속/처벌/AI일치/오탐) 클라이언트 계산 통계 (Statistics): - kpi.ts를 GET /api/stats/kpi, /stats/monthly 실제 호출로 전환 - toMonthlyTrend/toViolationTypes 변환 헬퍼 추가 - BarChart/AreaChart 기존 구조 유지 대시보드 KPI: - kpiStore를 API 기반으로 전환 (getKpiMetrics + getMonthlyStats) - Dashboard KPI_UI_MAP에 kpiKey 기반 매핑 추가 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>		2026-04-07 12:14:53 +09:00
.claude	chore: 팀 워크플로우 초기화 + Prettier + 타입 에러 수정	2026-04-07 08:44:28 +09:00
.gitea/workflows	ci: Gitea Actions 자동배포 워크플로우 추가	2026-04-06 14:12:55 +09:00
.githooks	refactor: 모노레포 구조로 전환 (frontend/ + backend/ + database/)	2026-04-07 08:47:24 +09:00
backend	fix: prediction_stats_monthly.stat_month CHAR(7) → DATE 타입 변경	2026-04-07 12:05:04 +09:00
database/migration	feat: S1 마스터 데이터 + prediction 기반 DB 스키마 (V008~V013)	2026-04-07 11:49:26 +09:00
docs	chore: 팀 워크플로우 기반 초기 프로젝트 구성	2026-04-06 14:11:29 +09:00
frontend	feat: S5 프론트 실데이터 전환 — EventList/Statistics/EnforcementHistory/Dashboard KPI	2026-04-07 12:14:53 +09:00
.gitignore	feat: Phase 3 - 자체 인증 + 트리 기반 RBAC + 감사로그 + 데모 계정	2026-04-07 09:29:52 +09:00
ATTRIBUTIONS.md	chore: 팀 워크플로우 기반 초기 프로젝트 구성	2026-04-06 14:11:29 +09:00
CLAUDE.md	refactor: 모노레포 구조로 전환 (frontend/ + backend/ + database/)	2026-04-07 08:47:24 +09:00
Makefile	refactor: 모노레포 구조로 전환 (frontend/ + backend/ + database/)	2026-04-07 08:47:24 +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 완료