8a5e77ab80
fix: 캐시 maxSize 설정 경로 수정 — application.yml이 실제 소스
...
application-prod.yml의 five-min-track/hourly-track가 app.ais-api 아래에
잘못 중첩되어 적용되지 않았음. application.yml의 app.cache 아래가 실제
@Value가 읽는 경로이므로 해당 파일을 수정.
- L1: 700K→1.5M, L2: 1.4M→3.5M (application.yml)
- application-prod.yml: 잘못된 중첩 제거
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 20:52:55 +09:00
10e99b6cee
Merge pull request 'fix: L1/L2 캐시 maxSize 상향 + AisTarget hitRate 타입 수정' ( #40 ) from feature/dashboard-phase-1 into develop
2026-02-19 20:47:45 +09:00
9774a75988
fix: L1/L2 캐시 maxSize 상향 + AisTarget hitRate 타입 수정
...
- L1(5분): 700K→1.5M (실측 612K, 87% 포화 → 41%)
- L2(시간): 1.4M→3.5M (실측 1.27M, 91% 포화 → 36%)
- AisTarget hitRate: String("64.41%") → double(64.41)
프론트엔드 .toFixed() 호출 시 타입 에러 수정
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 20:47:14 +09:00
8e7e8ff2de
Merge pull request 'perf: API 응답 최적화 + 점진적 렌더링 + 해구 choropleth 지도' ( #38 ) from feature/dashboard-phase-1 into develop
2026-02-19 20:25:52 +09:00
0cdb46d063
perf: API 응답 최적화 + 점진적 렌더링 + 해구 choropleth 지도
...
백엔드:
- haegu/realtime: DB 공간 JOIN(12s) → 인메모리 캐시 순회(~50ms)
- batch/statistics: N+1 JobExplorer(1.1s) → 단일 SQL 집계(~100ms)
- batch/daily-stats: N+1×7일(9s) → 직접 SQL 2쿼리(~200ms)
- throughput: pg_total_relation_size 매번 호출(1.4s) → Caffeine 5분 캐시
- quality: 풀스캔(0.6s) → 24시간 범위 제한
프론트엔드:
- Promise.allSettled 차단 → 개별 .then() 점진적 렌더링
- useCachedState 훅: 페이지 전환 시 이전 데이터 즉시 표시
- AreaStats: 해구 폴리곤 choropleth 지도 + 선박수 범례 추가
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 20:24:28 +09:00
97b71b16e1
Merge pull request 'feat: Phase 4 — 비정상 항적 + 시스템 메트릭 (7/7 완성)' ( #36 ) from feature/dashboard-phase-1 into develop
2026-02-19 19:20:21 +09:00
7a17d8e1d8
feat: Phase 4 — 비정상 항적 + 시스템 메트릭 페이지 (7/7 완성)
...
- AbnormalTracks: 유형별 통계, 일별 추이 차트, 검출 목록 테이블
- abnormalApi 클라이언트 (recent, summary, types)
- ApiMetrics: 시스템 메트릭, 캐시 상세(L1/L2/L3/AIS), 처리 지연, 히트율
- 10초 폴링으로 실시간 갱신
- i18n: abnormal.* 17키 + metrics.* 21키 한/영 추가
- 전체 7개 페이지 라우팅 완성 (Navbar 메뉴 전부 활성)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 19:19:51 +09:00
20cb4b3337
Merge pull request 'feat: Phase 3 — API Explorer 지도 스캐폴딩' ( #34 ) from feature/dashboard-phase-1 into develop
2026-02-19 19:14:30 +09:00
8fafaad6c0
feat: Phase 3 — API Explorer 지도 스캐폴딩
...
- MapLibre GL JS 5 지도 컨테이너 (Light/Dark 테마 자동 전환)
- Sidebar 접기/펼치기 레이아웃 (320px 사이드바 + 전체 높이 지도)
- API 유형 선택 UI (최근 위치 / 해구별 항적 / 선박별 항적)
- gisApi 클라이언트 (V1/V2 REST API 인터페이스)
- 지도 상수 (한반도 중심, 항적 색상, OpenFreeMap 타일)
- i18n 한/영 explorer.* 키 12개 추가
- lazy loading: ApiExplorer 청크 분리 (gzip 278KB)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 19:14:03 +09:00
c44075d72b
Merge pull request 'perf: L1/L2 캐시 maxSize 상향 (실측 기반)' ( #32 ) from feature/dashboard-phase-1 into develop
2026-02-19 19:09:55 +09:00
4b8b48e494
perf: L1/L2 캐시 maxSize 상향 (실측 기반)
...
- L1 FiveMinTrackCache: 500K→700K (실측 504K, 30% 여유)
- L2 HourlyTrackCache: 780K→1.4M (실측 1.08M, 30% 여유)
- 기존 산정: 30K MMSI × 버킷 → 실측: 190K MMSI (6.3배 과소 산정)
- L2 메모리 영향: +1.5GB (총 8.6GB, 힙 20~24GB 기준 36~43%)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 19:09:29 +09:00
9ca3057abd
Merge pull request 'fix: 해구 통계 ROUND 함수 타입 캐스팅 오류 수정' ( #30 ) from feature/dashboard-phase-1 into develop
2026-02-19 19:01:17 +09:00
029f912783
fix: 해구 통계 ROUND 함수 타입 캐스팅 오류 수정
...
GREATEST() 반환값이 double precision이라 ROUND(dp, int) 호출 시
PostgreSQL에서 미지원 함수 에러 발생 → 전체 나눗셈 결과를 ::numeric 캐스팅
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 19:00:50 +09:00
908f047f55
Merge pull request 'fix: 해구 조회 바운딩 박스 간소화' ( #28 ) from feature/dashboard-phase-1 into develop
2026-02-19 18:54:35 +09:00
61ec36c74a
fix: 해구 조회 ST_Contains 제거 — 바운딩 박스 조인으로 간소화
...
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 18:54:16 +09:00
c72e3cad36
Merge pull request 'debug: 해구 조회 에러 로깅' ( #24 ) from feature/dashboard-phase-1 into develop
2026-02-19 18:50:13 +09:00
6b1d5f3479
fix: 해구 통계 조회 에러 응답 노출 + 디버그 로깅 추가
...
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 18:49:27 +09:00
b46b9335a0
Merge pull request 'fix: toLocalDateTime 변환 강화' ( #22 ) from feature/dashboard-phase-1 into develop
2026-02-19 18:39:50 +09:00
6c63133fd8
fix: toLocalDateTime 변환 강화 — 타입 불일치 로깅 + toString 폴백
...
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 18:39:43 +09:00
8911259f29
Merge pull request 'fix: Timestamp 캐스팅 오류 수정' ( #20 ) from feature/dashboard-phase-1 into develop
2026-02-19 18:35:35 +09:00
508cc264ee
fix: MonitoringController Timestamp 캐스팅 오류 수정
...
- JdbcTemplate이 timestamptz를 java.sql.Timestamp로 반환하는 케이스 처리
- toLocalDateTime() 유틸 메서드로 Timestamp/OffsetDateTime/LocalDateTime 통합 변환
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 18:34:47 +09:00
1f209954bf
Merge pull request 'fix: MonitoringController 레거시 타일 쿼리 → AIS 위치/항적 기반 전환' ( #18 ) from feature/dashboard-phase-1 into develop
2026-02-19 18:30:39 +09:00
986ae7bc14
fix: MonitoringController 레거시 타일 쿼리 → AIS 위치/항적 기반 전환
...
- /delay: t_tile_summary → t_vessel_tracks_5min 기반 처리 지연 계산
- /haegu/realtime: t_tile_summary JOIN → t_ais_position + t_haegu_definitions 공간 조인
- /throughput: 타일 처리량 → 5분 항적 처리량 + vessel_tracks 테이블 크기
- /quality: 타일 중복/누락 → 항적 중복 + AIS 위치 갱신 지연 검증
- 프론트엔드 타입/라벨 동기화 (HaeguStat, DataQuality, ProcessingDelay)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 18:30:16 +09:00
e8f17dbd9a
Merge pull request 'chore: AIS API 인증 정보 추가' ( #16 ) from feature/dashboard-phase-1 into develop
2026-02-19 18:08:53 +09:00
61d68bb57b
chore: AIS API 인증 정보 추가 (prod)
...
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 18:08:26 +09:00
53e8c2eb02
Merge pull request 'feat: Phase 2 — 데이터 파이프라인 + 해구 통계 페이지' ( #14 ) from feature/dashboard-phase-1 into develop
2026-02-19 17:56:20 +09:00
23e33fe4bb
feat: Phase 2 — 데이터 파이프라인 + 해구 통계 페이지
...
- DataPipeline: 4단계 흐름도(PipelineChart), L1/L2/L3 캐시 현황, 일별 처리량 추이(LineChart), 최근 실행 이력
- AreaStats: 대해구별 선박 통계 테이블, 처리량(파티션 크기), 데이터 품질 검증
- LineChart, PipelineChart 차트 컴포넌트 신규
- API 타입 추가 (CacheDetails, HaeguStat, ThroughputMetrics, DataQuality)
- monitorApi에 getCacheDetails, getHaeguRealtimeStats, getQuality 추가
- i18n pipeline.*, area.* 번역 키 추가 (ko/en)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 17:55:52 +09:00
dca887b292
Merge pull request 'fix: Dashboard API 연동 오류 수정 — 캐시 모니터링 + 렌더링 안전성' ( #12 ) from feature/dashboard-phase-1 into develop
2026-02-19 17:34:23 +09:00
631454f8c4
fix: Dashboard API 연동 오류 수정 — 캐시 모니터링 + 렌더링 안전성
...
- CacheMonitoringController: @ConditionalOnProperty 제거, 5개 캐시 통합 집계
- MonitoringController: delay API에서 delayMinutes/status 항상 반환
- FiveMinTrackCache/HourlyTrackCache: getStatsMap() 메서드 추가
- App.tsx: Suspense fallback + ErrorBoundary 추가
- Dashboard.tsx: nullable 필드 방어 (?? 연산자)
- formatters.ts: formatNumber null 안전 처리
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 17:33:08 +09:00
76f71fb374
Merge pull request 'feat: React 19 SPA Dashboard Phase 1 + 안전 배포 시스템' ( #10 ) from feature/dashboard-phase-1 into develop
...
Reviewed-on: #10
2026-02-19 17:09:04 +09:00
dd694bdcbb
feat: React 19 SPA Dashboard Phase 1 + 안전 배포 시스템
...
## React SPA Dashboard
- React 19 + Vite 7 + Tailwind CSS 4 + Recharts 2 SPA 구축
- Dashboard (배치현황/시스템메트릭/캐시/처리량) + JobMonitor (이력조회/Step상세)
- i18n 다국어(ko/en) 시스템, Light/Dark 테마 CSS 토큰 전환
- frontend-maven-plugin 1.15.1 (mvn package 시 자동 빌드)
- WebViewController SPA forward + context-path /signal-batch
- 레거시 HTML 48개 파일 전체 삭제
## 안전 배포
- VesselBatchScheduler @PreDestroy: 신규 Job 차단 + 실행 중 Job 완료 대기
- server.shutdown=graceful, timeout-per-shutdown-phase=3m
- deploy.yml: 활성 Job 3초 연속 확인 후 stop → 교체 → start
- signal-batch.service TimeoutStopSec 60→180
- scripts/deploy.sh: 수동 배포용 안전 스크립트
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 17:05:38 +09:00
fb1a9f21f2
Merge pull request 'ci: Gitea Actions CI/CD 파이프라인 + systemd 서비스 구성' ( #8 ) from feature/multilevel-track-cache into develop
2026-02-19 14:30:37 +09:00
2838af323b
ci: Gitea Actions CI/CD 파이프라인 + systemd 서비스 구성
...
- .gitea/workflows/deploy.yml: main push → 빌드 → SSH 배포 → 헬스체크
- JDK 17 + Maven 빌드, JAR 원자적 교체, 백업 5세대 유지
- 90초 startup 대기 (64GB 힙 AlwaysPreTouch)
- deploy/signal-batch.service: systemd 유닛 파일
- 64GB 힙, G1GC 24 병렬스레드, GC 로그 5×100MB 로테이션
- on-failure 자동 재시작, graceful shutdown (SIGTERM 60s)
- application-prod.yml: 64코어/250GB 서버 최적화 (파티션 32, 커넥션 풀 정리)
- 미사용 프로필 삭제: application-dev.yml, application-prod-mpr.yml, application-query.yml
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 14:30:02 +09:00
29bf116246
Merge pull request 'feat: 다계층 인메모리 캐시(L1/L2/L3) 조회 통합 + CACHE-MONITOR 로그' ( #6 ) from feature/multilevel-track-cache into develop
2026-02-19 13:34:22 +09:00
bfc4614ce7
Merge pull request 'feat: Stale 데이터 비정상 궤적 전환 + vesselStatic N+1 쿼리 제거' ( #5 ) from feature/stale-data-abnormal-track into develop
2026-02-19 13:34:12 +09:00
5f0ef5e812
Merge pull request 'perf: Hourly Job 인메모리 병합 전환 — N+1 SQL 제거' ( #4 ) from feature/hourly-inmemory-merge into develop
2026-02-19 13:33:30 +09:00
daab14f0ad
Merge pull request 'chore: 팀 워크플로우 초기 구성 + SNP API 전환 및 레거시 정리' ( #3 ) from chore/team-workflow-init into develop
2026-02-19 13:32:37 +09:00
cf48cc94c7
feat: 다계층 인메모리 캐시(L1/L2/L3) 조회 통합 + CACHE-MONITOR 로그
...
L1(5min) + L2(hourly, 신규) + L3(daily) 3계층 캐시로 오늘 범위 조회를
DB 쿼리 대신 인메모리 캐시에서 처리하도록 전환.
신규:
- HourlyTrackCache: Caffeine L2 캐시 (TTL 26h, 780K entries)
- CacheWarmupService: L1/L2/L3 통합 비동기 워밍업
- VesselTrackToCompactConverter: VesselTrack → CompactVesselTrack 변환
변경:
- GisServiceV2: todayRange → hourlyRange(L2) + fiveMinRange(L1) 캐시 우선 조회
- DailyTrackCacheManager: SplitQueryResult에 hourlyRange/fiveMinRange 분리
- CompositeTrackWriter: hourly 저장 시 L2 캐시 동시 적재
- HourlyAggregationJobConfig: hourly 완료 → L1 cleanup 리스너
- DailyAggregationJobConfig: daily 완료 → L2 cleanup 리스너
- AsyncConfig: cacheWarmupExecutor 전용 스레드 풀 추가
- [CACHE-MONITOR] 임시 모니터링 로그 9개 파일 추가
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 13:29:06 +09:00
4dd40b7231
perf: vesselStaticSyncStep N+1 쿼리 제거 — DISTINCT ON bulk SELECT로 전환
...
이전: MMSI별 개별 SELECT (~10만 쿼리) → 수 분 소요
이후: DISTINCT ON (mmsi) 1회 bulk SELECT → 인메모리 CDC 비교
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 12:17:16 +09:00
a6d886c61b
fix: hourly job timeBucket 파라미터 문자열 "hourly" → 실제 시간값 전달
...
VesselBatchScheduler에서 hourlyAggregationJob 실행 시 timeBucket 파라미터에
"hourly" 문자열을 전달하여 HourlyTrackMergeProcessor의 LocalDateTime.parse() 실패.
startTime (정시 값)을 전달하도록 수정.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 11:12:49 +09:00
732f69eb02
feat: Stale 데이터 비정상 궤적 전환 — 과거 timestamp 수신 시 정보 보존
...
- CacheBasedVesselTrackDataReader: stale 그룹 스킵 제거 → 전체 통과 + 감지 로깅
- VesselTrackStepConfig: Processor에서 stale time_bucket 감지 시 비정상 궤적으로 전환
- abnormal_type: stale_timestamp (신규 분류)
- time_bucket: 현재 5분 버킷으로 오버라이드 (파티션 존재 보장)
- details: 원본 time_bucket, 지연 시간(분/시), 속도/거리 정보
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 11:09:27 +09:00
82ae4d9ef5
perf: Hourly Job 인메모리 병합 전환 — N+1 SQL 제거
...
Hourly 집계의 N+1 DB 쿼리 패턴(60K+)을 인메모리 병합으로 교체.
5분 트랙 적재 시 FiveMinTrackCache에 보관하고 hourly job에서 캐시 기반으로
좌표 병합/통계 집계/간소화를 수행하여 DB 쿼리를 0~2회로 감소.
- FiveMinTrackCache: Caffeine 캐시 (TTL 75분, maxSize 500K)
- CacheBasedHourlyTrackReader: 캐시 기반 Reader + DB fallback
- HourlyTrackMergeProcessor: Java WKT 병합 + 비정상 검출 bulk prefetch
- @ConfigurationProperties 중복 해결 (프로그래밍 방식 Hikari 바인딩)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 10:11:55 +09:00
2e9361ee58
refactor: SNP API 전환 및 레거시 코드 전면 정리
...
- CollectDB 다중 신호 수집 → S&P Global AIS API 단일 수집으로 전환
- sig_src_cd + target_id 이중 식별자 → mmsi(VARCHAR) 단일 식별자
- t_vessel_latest_position → t_ais_position 테이블 전환
- 레거시 배치/유틸 ~30개 클래스 삭제 (VesselAggregationJobConfig, ShipKindCodeConverter 등)
- AisTargetCacheManager 기반 캐시 이중 구조 (최신위치 + 트랙 버퍼)
- CacheBasedVesselTrackDataReader + CacheBasedTrackJobListener 신규 추가
- VesselStaticStepConfig: 정적정보 CDC 변경 검출 + hourly job 편승
- SignalKindCode enum: vesselType/extraInfo 기반 선종 자동 분류
- WebSocket/STOMP 전체 mmsi 전환 (StompTrackStreamingService ~40곳)
- 모니터링/성능 최적화 코드 mmsi 기반 전환
- DataSource 설정 통합 (snpdb 단일 DB)
- AreaBoundaryCache Polygon→Geometry 캐스트 수정 (MULTIPOLYGON 지원)
- ConcurrentHashMap 적용 (VesselTrackStepConfig 동시성 버그 수정)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 09:59:49 +09:00
e3816e6ecb
Merge pull request 'fix(rules): SLF4J 로깅 지침 추가' ( #2 ) from fix/logging-guideline into develop
2026-02-19 07:29:27 +09:00
636760dd1d
fix(rules): SLF4J 로깅 지침 추가 (printf 포맷 사용 금지)
2026-02-19 07:29:13 +09:00
b749417fc5
Merge pull request 'chore: 팀 워크플로우 v1.2.0 초기 구성 (java-maven)' ( #1 ) from chore/team-workflow-init into develop
...
Reviewed-on: #1
2026-02-18 20:56:04 +09:00
a98fdcbdc9
chore: 팀 워크플로우 v1.2.0 초기 구성 (java-maven)
...
- .claude/rules: team-policy, git-workflow, code-style, naming, testing
- .claude/skills: init-project, sync-team-workflow, create-mr, fix-issue
- .claude/scripts: on-pre-compact, on-post-compact, on-commit (v1.2.0)
- .claude/settings.json: 팀 표준 권한 allow/deny + script hooks
- .githooks: commit-msg, pre-commit (mvn compile), post-checkout
- .mvn/settings.xml: Nexus 미러 설정
- .editorconfig: 팀 표준 포맷
- CLAUDE.md: 팀 규칙 참조 섹션 추가
- .gitignore: !.claude/ negation 추가 (글로벌 gitignore override)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 20:52:38 +09:00
63022a63ff
chore: 팀 Gitea 전환 준비 (.gitignore 표준화 + 정리)
...
- .gitignore: .claude, *.md, scripts/ 포괄 무시 → 선택적 무시로 전환
- .claude.bak/ 삭제 (불필요 백업)
- .claudeignore 삭제
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 20:44:26 +09:00
LHT
28e6887379
fix: WebSocket OOM 방지 — 버퍼 256MB→2MB + 힙 기반 Admission Control
...
근본 원인: maxTextMessageBufferSize=256MB가 세션당 Humongous 객체 유발
- 100세션 × 256MB = 25.6GB G1GC 회수 불가 Humongous 리전 누적 → OOM
변경 내역:
- WebSocketStompConfig: 컨테이너 버퍼 256MB→2MB, SockJS stream 100MB→5MB
- WebSocketProperties: sendBuffer 256→50MB, outboundQueue 5000→200, msgLimit 50→2MB
- YAML(prod/prod-mpr/query): websocket.transport 섹션 명시적 추가
- ActiveQueryManager: 힙 사용률 85% 초과 시 쿼리 대기열 전환
- ChunkedTrackStreamingService: 중간 컬렉션 clear()/null 즉시 해제
- GisServiceV2: 캐시 원본 보호 toBuilder().build() + 중간 컬렉션 해제
- StompTrackController: activeSessions COMPLETED/ERROR 시 자동 제거
- AsyncConfig: 스레드풀 core 40→15, max 120→30
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 16:37:48 +09:00
LHT
fb72be89a1
feat: 비정상 접촉 선박 탐색 API (POST /api/v2/tracks/vessel-contacts)
...
인메모리 캐시 기반으로 폴리곤 내 일정 시간/거리 이내 선박 쌍 탐색.
Two-pointer 시간 동기화 + 평균 거리 기반 접촉 판정 + 환적 의심 지표.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 11:53:50 +09:00
