AI 기반 불법조업 탐지·차단 플랫폼 (React 19 + MapLibre + deck.gl + Zustand + Tailwind CSS)
htlee
b0c9a9fffb
Phase 3-1~10: 백엔드
- pom.xml에 spring-boot-starter-aop 추가
- JPA 엔티티 12종 + Repository 9종
(User/LoginHistory/Role/UserRole/PermTree/Perm/AuditLog/AccessLog 등)
- PermResolver: wing 프로젝트의 permResolver.ts를 Java로 이식
- 트리 BFS + 부모 READ 게이팅 + 다중 역할 OR 합집합 + 부모 fallback
- PermissionService: Caffeine 캐싱 (TTL 10분)
- JwtService + JwtAuthFilter (HttpOnly 쿠키 + Authorization 헤더 fallback)
- AuthProvider 인터페이스 + PasswordAuthProvider (BCrypt + 5회 잠금)
- REQUIRES_NEW + noRollbackFor로 fail_cnt 증가 보존
- AuthService + LoginAuditWriter (REQUIRES_NEW로 실패 기록 보존)
- AuthController: /api/auth/login, /logout, /me
- @RequirePermission 어노테이션 + PermissionAspect (메서드 권한 체크)
- @Auditable 어노테이션 + AuditAspect (의사결정 자동 기록)
- AccessLogFilter: 모든 HTTP 요청 비동기 기록 (BlockingQueue)
- SecurityConfig 본격 도입 (CORS + JWT 필터 + 401/403 핸들러)
Phase 3-10: 데모 계정
- V006__demo_accounts.sql: 5개 데모 계정 (admin/operator/analyst/field/viewer)
+ 역할 매핑 (PLACEHOLDER 해시)
- AccountSeeder.java: 시동 시 BCrypt 해시 시드 (PLACEHOLDER만 갱신)
- 데모 계정도 실제 권한, 로그인 이력, 감사로그 기록 대상
Phase 3-11: 백엔드 검증 완료
- admin/operator/viewer 로그인 성공
- 권한 매트릭스: ADMIN(49), OPERATOR(40), VIEWER(35)
- 트리 상속 검증: detection READ → 자식 4개 자동 상속
- 잘못된 비밀번호 → fail_cnt 증가 + login_hist FAILED 기록
- 정상 로그인 → fail_cnt 0 초기화
- 모든 요청 access_log에 비동기 기록
V001/V002: CHAR(1) → VARCHAR(1) 변경 (Hibernate validate 호환성)
Phase 3-12: 프론트엔드 연동
- services/authApi.ts: 백엔드 호출 클라이언트 (login/logout/me)
- AuthContext.tsx: 백엔드 API 통합 + 트리 기반 hasPermission
+ 부모 fallback (예: detection:gear-detection 미등록 시 detection 검사)
+ 30분 세션 타임아웃 유지
- DemoQuickLogin.tsx: 데모 퀵로그인 컴포넌트 분리
+ isDemoLoginEnabled() = VITE_SHOW_DEMO_LOGIN === 'true'
+ 데모 클릭 시에도 정상 백엔드 인증 플로우 사용
- LoginPage.tsx: 백엔드 인증 호출 + DemoQuickLogin 통합
+ 에러 메시지 한국어 변환 (WRONG_PASSWORD:N, ACCOUNT_LOCKED 등)
+ GPKI/SSO 탭은 disabled (Phase 9 도입 예정)
- frontend/.env.development: VITE_SHOW_DEMO_LOGIN=true
- frontend/.env.production: VITE_SHOW_DEMO_LOGIN=true (현재 단계)
- .gitignore에 frontend/.env.{development,production} 예외 추가
설계 핵심:
- 데모 계정은 백엔드 DB에 실제 권한 부여 + 로그인/감사 기록 대상
- DemoQuickLogin 컴포넌트는 환경변수로 토글 가능하도록 구조 분리
- 향후 운영 배포 시 .env.production만 false로 변경하면 데모 영역 숨김
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
||
|---|---|---|
| .claude | ||
| .gitea/workflows | ||
| .githooks | ||
| backend | ||
| database/migration | ||
| docs | ||
| frontend | ||
| .gitignore | ||
| ATTRIBUTIONS.md | ||
| CLAUDE.md | ||
| Makefile | ||
| 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 완료 |