feat(map): NaverMapView 채널별 마커 색상

- GoogleMapView와 동일 팔레트 (8 색)
- 식당 첫 채널 기준 색상, activeChannel 있으면 우선
- getChannelColorMap 재사용 패턴 동일

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

CHANGELOG.md

@@ -6,6 +6,17 @@
 
 ## 2026-06-16
 
+### 🎨 NaverMapView 채널별 마커 색상 (v0.1.60)
+- GoogleMapView와 동일 팔레트 (amber/blue/green/pink/purple/red/teal/yellow)
+- 식당의 첫 채널 기준 색상, activeChannel 있으면 그 채널 우선
+
+### ⚡ NaverMapView SDK 네이티브 마커 + InfoWindow (v0.1.59)
+- 마커를 React `absolute div` overlay → `naver.maps.Marker` 네이티브로 교체
+  - 줌/팬 시 SDK가 GPU 최적화, 매 frame React 리렌더링 없음 → 랙 해소
+- 식당명 InfoWindow 추가 (마커 클릭 시 표시)
+- bounds_changed → idle 이벤트로 sync (줌/팬 중 발화 빈도 ↓)
+- 클러스터도 네이티브 마커 (HTML 콘텐츠로 숫자 표시)
+
 ### 🗺️ NaverMapView 안정화 + 재활성 (v0.1.57)
 - divRef 항상 마운트 (이전: ready 가드로 첫 렌더 ref 누락 가능)
 - 명시적 width/height + 회색 배경(시각적 로딩 표시)

backend-java/src/main/java/com/tasteby/controller/AdminVideoRelevanceController.java

@@ -40,9 +40,11 @@ public class AdminVideoRelevanceController {
     @PostMapping("/all")
     public Map<String, Object> verifyAll(@RequestParam(defaultValue = "10") int batchSize) {
         var admin = AuthUtil.requireAdmin();
-        log.info("[ADMIN] {} triggered video-relevance verifyAll(batchSize={})", admin.getSubject(), batchSize);
+        int pending = restaurantService.countUnevaluatedLinks();
-        int processed = relevanceService.verifyAll(batchSize);
+        log.info("[ADMIN] {} triggered video-relevance verifyAllAsync (batchSize={}, pending={})", admin.getSubject(), batchSize, pending);
-        return Map.of("processed", processed);
+        // 비동기 트리거 — HTTP request는 즉시 응답. 진행은 /pending 폴링으로 확인.
+        relevanceService.verifyAllAsync(batchSize);
+        return Map.of("started", true, "pending", pending);
     }
 
     @PostMapping("/{linkId}/evaluate")

backend-java/src/main/java/com/tasteby/service/VideoRelevanceService.java

@@ -63,6 +63,16 @@ public class VideoRelevanceService {
         restaurantService.updateLinkRelevance(linkId, result.relevance(), truncate(result.reason(), 120));
     }
 
+    @Async
+    public void verifyAllAsync(int batchSize) {
+        try {
+            int n = verifyAll(batchSize);
+            log.info("[VideoRelevance] backfill done: {} processed", n);
+        } catch (Exception e) {
+            log.warn("verifyAllAsync failed: {}", e.getMessage());
+        }
+    }
+
     public int verifyAll(int batchSize) {
         int total = 0;
         List<Map<String, Object>> batch;

docs/design/363-map-sdk-branch/README.md

@@ -82,3 +82,31 @@ MapView (dispatcher)
 - 한 화면 mixed(국가 경계 근처) 동시 마커 — 후속.
 - 사용자 토글 UI — 후속.
 - 모바일 nearby 동일 분기 — 1차 적용 후 결정.
+
+## 11. 실제 구현 기록 (2026-06-16)
+
+### 배포 흐름
+| 버전 | 내용 |
+|---|---|
+| v0.1.51 | **1단계** — 식당 상세 외부 링크 좌표 기반 분기 (`RestaurantDetail.tsx`) |
+| v0.1.52 | **2단계** — MapView dispatcher + NaverMapView/GoogleMapView 분리 + Dockerfile/deploy.sh build-arg |
+| v0.1.53 | **fix**: 인증 파라미터 `ncpClientId` → `ncpKeyId` (NCLOUD 신 정책, 옛 NAVER Developers와 다름) |
+| v0.1.55–56 | 임시 fallback (운영 일시 GoogleMap, 디버그) |
+| v0.1.57 | **안정화 + 재활성** — divRef 첫 렌더 누락 fix, ResizeObserver/rAF, try/catch |
+
+### 운영 진단에서 확인된 사항
+- NCLOUD Maps Application의 Web 서비스 URL은 **스킴 포함**(`https://...`).
+- 옛 NAVER Developers와 NCLOUD는 다른 시스템 — Search Application과 Maps Application은 도메인 중복 충돌 없음.
+- NCLOUD 콘솔의 신규 경로: `Services > Application Services > Maps > Application`.
+
+### NaverMapView 안정화 핵심 결정사항
+- **`divRef` 항상 마운트** (early return 제거) — `ready=false` 동안에도 div를 두고 로딩 메시지는 overlay로 표시.
+- **명시적 `width:100%; height:100%`** + 회색 배경 — 컨테이너 영역이 시각적으로 확인 가능.
+- **ResizeObserver + requestAnimationFrame**으로 컨테이너 0×0 → 정상 크기 변경 시 `m.refresh(true)`.
+- **try/catch + `initError` state** — init 실패 시 화면 가시화.
+
+### 후속 (별도 PR)
+- 사용자 토글 (네이버/구글 강제 선택) UI.
+- mixed 화면(국경 근처) 동시 마커.
+- 모바일 nearby 탭 동일 분기 검토.
+- 채널 색상/InfoWindow 등 GoogleMapView 수준의 디테일을 NaverMapView에 도입.

frontend/src/components/NaverMapView.tsx

@@ -3,7 +3,6 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import Supercluster from "supercluster";
 import type { Restaurant } from "@/lib/api";
-import { getCuisineIcon } from "@/lib/cuisine-icons";
 import Icon from "@/components/Icon";
 import type { MapBounds, MapViewProps } from "@/components/MapView.types";
 
@@ -12,26 +11,63 @@ declare global {
     naver?: { maps: NaverMaps };
   }
 }
+type LatLng = { lat: () => number; lng: () => number };
 type NaverMaps = {
-  LatLng: new (lat: number, lng: number) => unknown;
+  LatLng: new (lat: number, lng: number) => LatLng;
   Map: new (el: HTMLElement, opts: Record<string, unknown>) => NaverMapInstance;
-  Event: { addListener: (target: unknown, type: string, fn: (...args: unknown[]) => void) => unknown };
+  Marker: new (opts: Record<string, unknown>) => NaverMarker;
+  InfoWindow: new (opts: Record<string, unknown>) => NaverInfoWindow;
+  Event: { addListener: (target: unknown, type: string, fn: (...args: unknown[]) => void) => unknown; removeListener: (handler: unknown) => void };
   Size: new (w: number, h: number) => unknown;
+  Point: new (x: number, y: number) => unknown;
 };
 type NaverMapInstance = {
   setCenter: (latlng: unknown) => void;
   setZoom: (zoom: number, useEffect?: boolean) => void;
-  getCenter: () => { lat: () => number; lng: () => number };
   getZoom: () => number;
-  getBounds: () => { getNE: () => { lat: () => number; lng: () => number }; getSW: () => { lat: () => number; lng: () => number } };
+  getBounds: () => { getNE: () => LatLng; getSW: () => LatLng };
-  getProjection: () => { fromCoordToOffset: (latlng: unknown) => { x: number; y: number } };
   panTo: (latlng: unknown, opts?: Record<string, unknown>) => void;
   refresh: (noEffect?: boolean) => void;
-  setSize?: (size: unknown) => void;
+};
+type NaverMarker = {
+  setMap: (map: NaverMapInstance | null) => void;
+  setIcon: (icon: Record<string, unknown>) => void;
+  setPosition: (latlng: unknown) => void;
+  getPosition: () => LatLng;
+};
+type NaverInfoWindow = {
+  open: (map: NaverMapInstance, marker: NaverMarker) => void;
+  close: () => void;
+  setContent: (content: string) => void;
+  getMap: () => NaverMapInstance | null;
 };
 
 const NAVER_CLIENT_ID = process.env.NEXT_PUBLIC_NAVER_MAP_CLIENT_ID || "";
 
+// Channel color palette — GoogleMapView와 동일
+const CHANNEL_COLORS = [
+  { border: "#f59e0b" }, // amber (default)
+  { border: "#3b82f6" }, // blue
+  { border: "#22c55e" }, // green
+  { border: "#ec4899" }, // pink
+  { border: "#a855f7" }, // purple
+  { border: "#ef4444" }, // red
+  { border: "#14b8a6" }, // teal
+  { border: "#eab308" }, // yellow
+];
+
+function getChannelColorMap(restaurants: Restaurant[]) {
+  const channels = new Set<string>();
+  restaurants.forEach((r) => r.channels?.forEach((ch) => channels.add(ch)));
+  const map: Record<string, typeof CHANNEL_COLORS[0]> = {};
+  let i = 0;
+  for (const ch of channels) {
+    map[ch] = CHANNEL_COLORS[i % CHANNEL_COLORS.length];
+    i++;
+  }
+  return map;
+}
+
 function useNaverMaps(): { ready: boolean; error: string | null } {
   const [ready, setReady] = useState(typeof window !== "undefined" && !!window.naver?.maps);
   const [error, setError] = useState<string | null>(null);
@@ -89,6 +125,15 @@ function getClusterSize(count: number): number {
   return 54;
 }
 
+// 단일 마커 — 채널 색상별
+function markerIconHtml(color: string): string {
+  return `<div style="width:28px;height:28px;border-radius:9999px;background:${color};border:2px solid #fff;box-shadow:0 2px 6px rgba(0,0,0,.25);"></div>`;
+}
+// SVG data URL — 클러스터(숫자)
+function clusterIconHtml(count: number, size: number): string {
+  return `<div style="width:${size}px;height:${size}px;border-radius:9999px;background:rgba(245,158,11,.92);color:#fff;display:flex;align-items:center;justify-content:center;font-weight:700;font-size:${size > 44 ? 14 : 12}px;border:2px solid #fff;box-shadow:0 2px 8px rgba(0,0,0,.3);">${count}</div>`;
+}
+
 export default function NaverMapView({
   restaurants,
   selected,
@@ -96,16 +141,20 @@ export default function NaverMapView({
   onBoundsChanged,
   flyTo,
   onMyLocation,
+  activeChannel,
 }: MapViewProps) {
+  const channelColors = useMemo(() => getChannelColorMap(restaurants), [restaurants]);
   const { ready, error } = useNaverMaps();
   const divRef = useRef<HTMLDivElement | null>(null);
   const mapRef = useRef<NaverMapInstance | null>(null);
+  const markersRef = useRef<NaverMarker[]>([]);
+  const infoWindowRef = useRef<NaverInfoWindow | null>(null);
   const [bounds, setBounds] = useState<MapBounds | null>(null);
   const [zoom, setZoom] = useState(13);
   const [initError, setInitError] = useState<string | null>(null);
   const { getClusters, getExpansionZoom } = useSupercluster(restaurants);
 
-  // 지도 1회 생성 — divRef 항상 마운트되므로 ready 시점에 안정적으로 잡힘
+  // 지도 1회 생성
   useEffect(() => {
     if (!ready || !divRef.current || mapRef.current) return;
     try {
@@ -122,13 +171,20 @@ export default function NaverMapView({
         zoomControl: false,
       });
       mapRef.current = m;
+      infoWindowRef.current = new n.InfoWindow({
+        borderWidth: 0,
+        anchorSize: new n.Size(10, 10),
+        pixelOffset: new n.Point(0, -8),
+        backgroundColor: "transparent",
+        disableAnchor: false,
+      });
 
-      // 컨테이너 크기 변경(예: flex layout 안에서 첫 마운트 시 0×0 → 실제 크기) → refresh
       const ro = new ResizeObserver(() => {
         try { m.refresh(true); } catch { /* noop */ }
       });
       ro.observe(divRef.current);
 
+      // bounds_changed가 줌/팬 끝나는 시점에 한 번만 emit (SDK가 throttle)
       const sync = () => {
         try {
           const b = m.getBounds();
@@ -141,13 +197,12 @@ export default function NaverMapView({
           console.warn("[NaverMap] sync failed", e);
         }
       };
-      // 컨테이너 크기가 정해진 다음 sync (rAF로 다음 프레임)
       requestAnimationFrame(() => {
         try { m.refresh(true); } catch { /* noop */ }
         sync();
       });
-      n.Event.addListener(m, "bounds_changed", sync);
+      // idle = 줌/팬 끝났을 때 한 번 (bounds_changed보다 적게 발화 → 성능)
-      n.Event.addListener(m, "zoom_changed", sync);
+      n.Event.addListener(m, "idle", sync);
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       console.error("[NaverMap] init failed", e);
@@ -163,34 +218,89 @@ export default function NaverMapView({
     if (flyTo.zoom) m.setZoom(flyTo.zoom, true);
   }, [flyTo]);
 
+  // 클러스터 계산 (bounds/zoom 변경 시)
   const clusters = useMemo(() => {
     if (!bounds) return [];
     return getClusters(bounds, zoom);
   }, [bounds, zoom, getClusters]);
 
-  const toScreen = useCallback((lat: number, lng: number) => {
+  // 마커를 SDK 네이티브로 그림 — clusters 바뀌면 기존 마커 모두 제거 후 새로 생성
+  useEffect(() => {
     const m = mapRef.current;
-    if (!m || !window.naver?.maps) return null;
+    const naver = window.naver?.maps;
-    try {
+    if (!m || !naver) return;
-      return m.getProjection().fromCoordToOffset(new window.naver.maps.LatLng(lat, lng));
+
-    } catch {
+    // 기존 마커 제거
-      return null;
+    for (const mk of markersRef.current) mk.setMap(null);
+    markersRef.current = [];
+
+    for (const feature of clusters) {
+      const [lng, lat] = feature.geometry.coordinates;
+      const isCluster = feature.properties && "cluster" in feature.properties && feature.properties.cluster;
+      if (isCluster) {
+        const { cluster_id, point_count } = feature.properties as Supercluster.ClusterProperties;
+        const size = getClusterSize(point_count);
+        const marker = new naver.Marker({
+          position: new naver.LatLng(lat, lng),
+          map: m,
+          icon: {
+            content: clusterIconHtml(point_count, size),
+            anchor: new naver.Point(size / 2, size / 2),
+          },
+        });
+        naver.Event.addListener(marker, "click", () => {
+          const z = Math.min(getExpansionZoom(cluster_id), 18);
+          m.panTo(new naver.LatLng(lat, lng));
+          m.setZoom(z, true);
+        });
+        markersRef.current.push(marker);
+      } else {
+        const r = (feature.properties as RestaurantProps).restaurant;
+        const chKey = activeChannel && r.channels?.includes(activeChannel) ? activeChannel : r.channels?.[0];
+        const chColor = chKey ? channelColors[chKey] : CHANNEL_COLORS[0];
+        const marker = new naver.Marker({
+          position: new naver.LatLng(lat, lng),
+          map: m,
+          title: r.name,
+          icon: {
+            content: markerIconHtml(chColor?.border ?? "#f59e0b"),
+            anchor: new naver.Point(14, 14),
+          },
+        });
+        naver.Event.addListener(marker, "click", () => {
+          const iw = infoWindowRef.current;
+          if (iw && m) {
+            iw.setContent(
+              `<div style="background:#fff;border-radius:8px;padding:8px 12px;box-shadow:0 4px 12px rgba(0,0,0,.18);font-size:13px;font-weight:600;color:#111;white-space:nowrap;">${escapeHtml(r.name)}</div>`
+            );
+            iw.open(m, marker);
           }
+          onSelectRestaurant?.(r);
+        });
+        markersRef.current.push(marker);
+      }
+    }
+  }, [clusters, getExpansionZoom, onSelectRestaurant, channelColors, activeChannel]);
+
+  // 컴포넌트 unmount 시 마커 정리
+  useEffect(() => {
+    return () => {
+      for (const mk of markersRef.current) mk.setMap(null);
+      markersRef.current = [];
+      infoWindowRef.current?.close();
+    };
   }, []);
 
   return (
     <div className="relative w-full h-full">
-      {/* 지도 컨테이너 — 항상 마운트, 명시적 크기 보장 */}
       <div
         ref={divRef}
         className="absolute inset-0"
         style={{ width: "100%", height: "100%", backgroundColor: "#e5e7eb" }}
       />
-
-      {/* 로딩/에러 overlay */}
       {(error || initError) && (
         <div className="absolute inset-0 flex items-center justify-center text-xs text-red-600 bg-white/80 pointer-events-none">
-          {error ?? initError} — 새로고침 또는 GoogleMap로 fallback
+          {error ?? initError}
         </div>
       )}
       {!ready && !error && (
@@ -198,54 +308,11 @@ export default function NaverMapView({
           네이버 지도 로딩 중…
         </div>
       )}
-
-      {/* 마커 overlay */}
-      {clusters.map((feature) => {
-        const [lng, lat] = feature.geometry.coordinates;
-        const pt = toScreen(lat, lng);
-        if (!pt) return null;
-        const isCluster = feature.properties && "cluster" in feature.properties && feature.properties.cluster;
-        if (isCluster) {
-          const { cluster_id, point_count } = feature.properties as Supercluster.ClusterProperties;
-          const size = getClusterSize(point_count);
-          return (
-            <button
-              key={`c-${cluster_id}`}
-              onClick={() => {
-                const z = Math.min(getExpansionZoom(cluster_id), 18);
-                const m = mapRef.current;
-                if (!m || !window.naver?.maps) return;
-                m.panTo(new window.naver.maps.LatLng(lat, lng));
-                m.setZoom(z, true);
-              }}
-              className="absolute -translate-x-1/2 -translate-y-1/2 rounded-full bg-brand-500/90 text-white font-semibold shadow-lg ring-2 ring-white"
-              style={{ left: pt.x, top: pt.y, width: size, height: size, fontSize: size > 44 ? 14 : 12 }}
-            >
-              {point_count}
-            </button>
-          );
-        }
-        const r = (feature.properties as RestaurantProps).restaurant;
-        const cuisineIcon = getCuisineIcon(r.cuisine_type);
-        const isSel = selected?.id === r.id;
-        return (
-          <button
-            key={r.id}
-            onClick={() => onSelectRestaurant?.(r)}
-            className={`absolute -translate-x-1/2 -translate-y-full rounded-full shadow-md ring-2 ring-white transition-transform ${isSel ? "scale-125 z-10" : ""}`}
-            style={{ left: pt.x, top: pt.y, width: 32, height: 32, background: "#f59e0b", color: "#78350f" }}
-            title={r.name}
-          >
-            <Icon name={cuisineIcon} size={18} />
-          </button>
-        );
-      })}
-
       {onMyLocation && (
         <button
           onClick={onMyLocation}
           aria-label="내 위치"
-          className="absolute right-3 bottom-3 size-11 rounded-full bg-white shadow-lg flex items-center justify-center"
+          className="absolute right-3 bottom-3 size-11 rounded-full bg-white shadow-lg flex items-center justify-center z-10"
         >
           <Icon name="my-location" size={22} />
         </button>
@@ -253,3 +320,7 @@ export default function NaverMapView({
     </div>
   );
 }
+
+function escapeHtml(s: string): string {
+  return s.replace(/[&<>"']/g, (ch) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[ch] as string));
+}