kcg-ai-monitoring/frontend/src/features/detection/components/DarkDetailPanel.tsx
htlee d354c1ebc7 feat(frontend): 탐지 결과 운영 워크플로우 UI 구축
- DarkVesselDetection: 판정 상세 사이드 패널(점수 산출 내역 P1~P11,
  GAP 상세, 7일 이력 차트), 선박 위치 gap_start_lat/lon fallback,
  클릭 시 지도 하이라이트
- TransferDetection: 5단계 필터 기반 환적 운영 화면 재구성
  (KPI, 쌍 목록, 쌍 상세, 감시영역 지도, 탐지 조건 시각화)
- GearDetection: 모선 추론 상태(DIRECT_MATCH/AUTO_PROMOTED/REVIEW_REQUIRED),
  추정 모선 MMSI, 후보 수 3개 컬럼 추가
- EnforcementPlan: CRITICAL 이벤트를 카테고리별(다크베셀/환적/EEZ침범/고위험)
  아이콘+라벨로 "탐지 기반 단속 대상" 통합 표시
- darkVesselPatterns: prediction P1~P11 전 패턴 한국어 카탈로그 +
  buildScoreBreakdown() 점수 산출 유틸
- ScoreBreakdown: 가점/감점 분리 점수 내역 시각화 공통 컴포넌트

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-14 07:56:52 +09:00

192 lines
8.9 KiB
TypeScript

/**
* DarkDetailPanel — Dark Vessel 판정 상세 사이드 패널
*
* 테이블 행 클릭 시 우측에 슬라이드 표시.
* 점수 산출 내역, 선박 정보, GAP 상세, 과거 이력을 종합 표시.
*/
import { useEffect, useState, useMemo, useCallback } from 'react';
import { useNavigate } from 'react-router-dom';
import { Badge } from '@shared/components/ui/badge';
import { Button } from '@shared/components/ui/button';
import { ScoreBreakdown } from '@shared/components/common/ScoreBreakdown';
import { buildScoreBreakdown } from '@shared/constants/darkVesselPatterns';
import { getRiskIntent } from '@shared/constants/statusIntent';
import { getAlertLevelIntent } from '@shared/constants/alertLevels';
import { formatDateTime } from '@shared/utils/dateFormat';
import { getAnalysisHistory, type VesselAnalysis } from '@/services/analysisApi';
import { X, Ship, MapPin, Clock, AlertTriangle, TrendingUp, ExternalLink, ShieldAlert } from 'lucide-react';
import { BarChart as EcBarChart } from '@lib/charts';
interface DarkDetailPanelProps {
vessel: VesselAnalysis | null;
onClose: () => void;
}
export function DarkDetailPanel({ vessel, onClose }: DarkDetailPanelProps) {
const navigate = useNavigate();
const [history, setHistory] = useState<VesselAnalysis[]>([]);
const features = vessel?.features ?? {};
const darkTier = (features.dark_tier as string) ?? 'NONE';
const darkScore = (features.dark_suspicion_score as number) ?? 0;
const darkPatterns = (features.dark_patterns as string[]) ?? [];
const darkHistory7d = (features.dark_history_7d as number) ?? 0;
const darkHistory24h = (features.dark_history_24h as number) ?? 0;
const gapStartLat = features.gap_start_lat as number | undefined;
const gapStartLon = features.gap_start_lon as number | undefined;
const gapStartSog = features.gap_start_sog as number | undefined;
const gapStartState = features.gap_start_state as string | undefined;
// 점수 산출 내역
const breakdown = useMemo(() => buildScoreBreakdown(darkPatterns), [darkPatterns]);
// 7일 이력 조회
const loadHistory = useCallback(async () => {
if (!vessel?.mmsi) return;
try {
const res = await getAnalysisHistory(vessel.mmsi, 168); // 7일
setHistory(res);
} catch { setHistory([]); }
}, [vessel?.mmsi]);
useEffect(() => { loadHistory(); }, [loadHistory]);
// 일별 dark 건수 집계 (차트용)
const dailyDarkData = useMemo(() => {
const dayMap: Record<string, number> = {};
for (const h of history) {
if (!h.isDark) continue;
const day = (h.analyzedAt ?? '').slice(0, 10);
if (day) dayMap[day] = (dayMap[day] || 0) + 1;
}
return Object.entries(dayMap)
.sort(([a], [b]) => a.localeCompare(b))
.map(([day, count]) => ({ name: day.slice(5), value: count }));
}, [history]);
if (!vessel) return null;
return (
<div className="fixed inset-y-0 right-0 w-[420px] bg-background border-l border-border z-50 overflow-y-auto shadow-2xl">
{/* 헤더 */}
<div className="sticky top-0 bg-background/95 backdrop-blur-sm border-b border-border px-4 py-3 flex items-center justify-between z-10">
<div className="flex items-center gap-2">
<ShieldAlert className="w-4 h-4 text-red-400" />
<span className="font-bold text-heading text-sm"> </span>
<Badge intent={getAlertLevelIntent(darkTier)} size="sm">{darkTier}</Badge>
<span className="text-xs font-mono font-bold text-heading">{darkScore}</span>
</div>
<button type="button" onClick={onClose} className="p-1 hover:bg-surface-raised rounded" aria-label="닫기">
<X className="w-4 h-4 text-hint" />
</button>
</div>
<div className="p-4 space-y-4">
{/* 선박 기본 정보 */}
<div className="bg-surface-raised rounded-lg p-3 space-y-2">
<div className="flex items-center gap-2 text-xs">
<Ship className="w-3.5 h-3.5 text-cyan-400" />
<span className="text-label font-medium"> </span>
</div>
<div className="grid grid-cols-2 gap-y-1 text-xs">
<span className="text-hint">MMSI</span>
<button type="button" className="text-cyan-400 hover:underline text-right font-mono"
onClick={() => navigate(`/vessel/${vessel.mmsi}`)}>
{vessel.mmsi} <ExternalLink className="w-2.5 h-2.5 inline" />
</button>
<span className="text-hint"></span>
<span className="text-label text-right">{vessel.vesselType || 'UNKNOWN'}</span>
<span className="text-hint"></span>
<span className="text-label text-right">{vessel.mmsi?.startsWith('412') ? 'CN (중국)' : vessel.mmsi?.slice(0, 3)}</span>
<span className="text-hint"></span>
<span className="text-label text-right">{vessel.zoneCode || '-'}</span>
<span className="text-hint"></span>
<span className="text-label text-right">{vessel.activityState || '-'}</span>
<span className="text-hint"></span>
<span className="text-right">
<Badge intent={getRiskIntent(vessel.riskScore ?? 0)} size="sm">
{vessel.riskLevel} ({vessel.riskScore})
</Badge>
</span>
</div>
</div>
{/* 점수 산출 내역 */}
<div className="bg-surface-raised rounded-lg p-3 space-y-2">
<div className="flex items-center gap-2 text-xs">
<AlertTriangle className="w-3.5 h-3.5 text-orange-400" />
<span className="text-label font-medium"> </span>
<span className="text-hint text-[10px]">({breakdown.items.length} )</span>
</div>
<ScoreBreakdown items={breakdown.items} totalScore={darkScore} />
</div>
{/* GAP 상세 */}
<div className="bg-surface-raised rounded-lg p-3 space-y-2">
<div className="flex items-center gap-2 text-xs">
<MapPin className="w-3.5 h-3.5 text-yellow-400" />
<span className="text-label font-medium">GAP </span>
</div>
<div className="grid grid-cols-2 gap-y-1 text-xs">
<span className="text-hint">GAP </span>
<span className="text-label text-right font-mono">
{vessel.gapDurationMin ? `${vessel.gapDurationMin}분 (${(vessel.gapDurationMin / 60).toFixed(1)}h)` : '-'}
</span>
<span className="text-hint"> </span>
<span className="text-label text-right font-mono text-[10px]">
{gapStartLat != null ? `${gapStartLat.toFixed(4)}°N ${gapStartLon?.toFixed(4)}°E` : '-'}
</span>
<span className="text-hint"> SOG</span>
<span className="text-label text-right font-mono">
{gapStartSog != null ? `${gapStartSog.toFixed(1)}kn` : '-'}
</span>
<span className="text-hint"> </span>
<span className="text-label text-right">{gapStartState || '-'}</span>
<span className="text-hint"></span>
<span className="text-label text-right text-[10px]">{formatDateTime(vessel.analyzedAt)}</span>
</div>
</div>
{/* 과거 이력 */}
<div className="bg-surface-raised rounded-lg p-3 space-y-2">
<div className="flex items-center gap-2 text-xs">
<TrendingUp className="w-3.5 h-3.5 text-purple-400" />
<span className="text-label font-medium"> (7)</span>
</div>
<div className="grid grid-cols-2 gap-y-1 text-xs">
<span className="text-hint">7 dark </span>
<span className="text-label text-right font-bold">{darkHistory7d}</span>
<span className="text-hint">24 dark</span>
<span className="text-label text-right">{darkHistory24h}</span>
</div>
{dailyDarkData.length > 0 && (
<div className="h-24 mt-2">
<EcBarChart
data={dailyDarkData}
xKey="name"
series={[{ key: 'value', name: 'Dark 건수', color: '#ef4444' }]}
height={96}
/>
</div>
)}
{dailyDarkData.length === 0 && (
<div className="text-hint text-[10px] text-center py-2"> </div>
)}
</div>
{/* 액션 버튼 */}
<div className="flex gap-2">
<Button variant="outline" size="sm" className="flex-1"
onClick={() => navigate(`/vessel/${vessel.mmsi}`)}>
<Ship className="w-3.5 h-3.5 mr-1" />
</Button>
<Button variant="primary" size="sm" className="flex-1"
onClick={() => { /* TODO: 단속 대상 등록 API 연동 */ }}>
<Clock className="w-3.5 h-3.5 mr-1" />
</Button>
</div>
</div>
</div>
);
}