커밋 그래프

72 커밋

작성자 SHA1 메시지 날짜
f34d4921b7 Merge pull request 'fix: 캐시 maxSize 설정 경로 수정' (#42) from feature/dashboard-phase-1 into develop 2026-02-19 20:53:18 +09:00
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