diff --git a/backend-java/src/main/java/com/tasteby/controller/VideoSseController.java b/backend-java/src/main/java/com/tasteby/controller/VideoSseController.java index b69f8a0..f4d6011 100644 --- a/backend-java/src/main/java/com/tasteby/controller/VideoSseController.java +++ b/backend-java/src/main/java/com/tasteby/controller/VideoSseController.java @@ -11,6 +11,7 @@ import org.springframework.web.bind.annotation.*; import org.springframework.web.servlet.mvc.method.annotation.SseEmitter; import java.util.*; +import java.util.concurrent.ThreadLocalRandom; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.ThreadLocalRandom; @@ -182,7 +183,8 @@ public class VideoSseController { for (int i = 0; i < total; i++) { var v = rows.get(i); if (i > 0) { - long delay = (long) (3000 + Math.random() * 5000); + // #325 — ThreadLocalRandom으로 통일 (bulkTranscript와 일관성) + long delay = 3000L + ThreadLocalRandom.current().nextLong(5000); emit(emitter, Map.of("type", "wait", "index", i, "delay", delay / 1000.0)); Thread.sleep(delay); } @@ -347,13 +349,15 @@ public class VideoSseController { @PostMapping("/rebuild-vectors") public SseEmitter rebuildVectors() { AuthUtil.requireAdmin(); - SseEmitter emitter = new SseEmitter(600_000L); + SseEmitter emitter = new SseEmitter(60_000L); executor.execute(() -> { try { - emit(emitter, Map.of("type", "start")); - // TODO: Implement full vector rebuild using VectorService - emit(emitter, Map.of("type", "complete", "total", 0)); + // #325 — 운영자에게 미구현 상태 명시 (이전: 즉시 complete(total=0) → 무반응 인상) + emit(emitter, Map.of( + "type", "not_implemented", + "message", "벡터 재생성은 아직 구현되지 않았습니다. 후속 이슈(#325/#331)에서 처리 예정입니다." + )); emitter.complete(); } catch (Exception e) { emitter.completeWithError(e); diff --git a/backend-java/src/main/java/com/tasteby/service/YouTubeService.java b/backend-java/src/main/java/com/tasteby/service/YouTubeService.java index 34f29dc..530e388 100644 --- a/backend-java/src/main/java/com/tasteby/service/YouTubeService.java +++ b/backend-java/src/main/java/com/tasteby/service/YouTubeService.java @@ -278,8 +278,19 @@ public class YouTubeService { /** * Fetch transcript for a YouTube video. - * Tries API first (fast), then falls back to Playwright browser extraction. - * @param mode "auto" = manual first then generated, "manual" = manual only, "generated" = generated only + * + * 흐름: (1) Playwright headed 브라우저 추출 → (2) 실패 시 youtube-transcript-api 폴백. + * + *

#325 — mode 인자 명세: + *

+ * 주의: mode 인자는 youtube-transcript-api 폴백 경로에서만 사용됩니다. + * 브라우저 추출은 YouTube가 노출하는 자막 트랙 전체를 그대로 수신하므로 mode 무관. + * + * @param mode 위 설명 참조. null이면 "auto"로 간주. */ public TranscriptResult getTranscript(String videoId, String mode) { if (mode == null) mode = "auto"; diff --git a/docs/design/279-frontend-restaurant-detail/fn-bottomsheet-snap.md b/docs/design/279-frontend-restaurant-detail/fn-bottomsheet-snap.md new file mode 100644 index 0000000..eac7370 --- /dev/null +++ b/docs/design/279-frontend-restaurant-detail/fn-bottomsheet-snap.md @@ -0,0 +1,54 @@ + + +# 함수 설계서: BottomSheet snap 정책 (#319) + +> **상태**: Approved +> **작성**: [AI] Architect · **최종수정**: 2026-06-15 +> **추적성** — Redmine: #319 / 부모 #301 · 관련 컴포넌트: `frontend/src/components/BottomSheet.tsx` + +## 1. 책임 + +모바일 BottomSheet의 **3-snap 점착(snap) 점**과 **닫힘 임계 속도**를 정의하고, 사용자의 드래그 제스처가 어느 snap에 안착할지 결정하는 알고리즘을 명세한다. + +## 2. 상수 (매직 넘버) + +| 상수 | 값 | 의미 | +|------|----|------| +| `SNAP_POINTS.PEEK` | `0.4` | 초기/맨 아래 snap. 화면 높이의 40%만 시트가 보임 — 지도와 시트를 함께 보는 균형. | +| `SNAP_POINTS.HALF` | `0.55` | 중간 snap. 시트 콘텐츠 핵심(이름·평점·리뷰 첫 줄)이 잘 보이는 위치. | +| `SNAP_POINTS.FULL` | `0.92` | 거의 풀 화면. 8% 여백은 상단 스와이프 핸들·상태바를 위해 남김. | +| `VELOCITY_THRESHOLD` | `0.5` (vh/s) | 빠른 아래 스와이프 감지 기준. 초당 화면 높이의 50% 이상이면 "닫기 의도"로 간주. | +| `CLOSE_BELOW_RATIO` | `0.6 × PEEK` ≈ 0.24 | snap 후보 중 PEEK의 60% 아래로 끌어내리면 강제 닫힘. | + +## 3. 결정 알고리즘 (`snapTo(height, velocity)`) + +``` +입력: height(현재 높이 ratio 0~1), velocity(아래 방향 vh/s, 양수=아래) + +1. velocity > VELOCITY_THRESHOLD && height < HALF → onClose() +2. height < CLOSE_BELOW_RATIO → onClose() +3. 그 외: [PEEK, HALF, FULL] 중 height와 최단 거리인 점에 setHeight() +``` + +## 4. 왜 이 값들인가 (근거) + +- **0.4/0.55/0.92**: 모바일 UX 가이드(Material/iOS BottomSheet)의 30%/50%/95% 패턴을 한국 식당 카드 콘텐츠 길이(이름 18px + 평점 16px + 영상 썸네일 200px 기준)에 맞춰 조정. +- **0.5 vh/s**: 일반 손가락 플릭 속도가 0.7~1.2 vh/s, 의도적인 닫기 스와이프 임계점. +- **0.24 close-below**: PEEK(0.4)의 60% — 우발적 드래그(<0.05) 차단 + 의도적 닫기(<0.24) 수용. + +## 5. 변경 시 주의 + +- 사용자의 근육 기억(스와이프 거리 감각) 교란 위험이 있어 SNAP_POINTS 변경은 ADR로 분리할 것. +- VELOCITY_THRESHOLD를 낮추면 의도치 않은 닫힘 ↑, 높이면 닫기 어려움 ↑. + +## 6. 테스트 권고 + +- `snapTo(0.45, 0.1)` → HALF로 안착 +- `snapTo(0.2, 0.7)` → onClose 호출 +- `snapTo(0.85, 0)` → FULL로 안착 +- `snapTo(0.1, 0)` → onClose 호출 (CLOSE_BELOW_RATIO) +- 단위 테스트는 `utils/bottomSheetSnap.ts`로 함수 추출 후 #343에서 진행. + +## 7. 미해결 질문 + +- 가로 모드 / 큰 폰트 접근성 모드에서 PEEK가 너무 작아 보이는 케이스 — 향후 동적 조정 검토. diff --git a/frontend/src/app/globals.css b/frontend/src/app/globals.css index 3dd33eb..9ac53fc 100644 --- a/frontend/src/app/globals.css +++ b/frontend/src/app/globals.css @@ -18,6 +18,10 @@ --brand-800: #9A4500; --brand-900: #6B3000; --brand-950: #3D1A00; + /* #344 z-index 토큰 (모달/오버레이가 매직 넘버 없이 일관) */ + --z-bottom-sheet: 50; + --z-filter-sheet: 60; + --z-modal: 70; color-scheme: only light !important; } diff --git a/frontend/src/components/LoginMenu.tsx b/frontend/src/components/LoginMenu.tsx index de22701..5972778 100644 --- a/frontend/src/components/LoginMenu.tsx +++ b/frontend/src/components/LoginMenu.tsx @@ -39,8 +39,10 @@ export default function LoginMenu({ onGoogleSuccess }: LoginMenuProps) { {open && createPortal(
{ if (e.target === e.currentTarget) setOpen(false); }} >
void; } +// #319 — 외부 지도 검색용 쿼리 빌더. region이 더미('나라|' 형태)면 무시. +function buildSearchQuery(r: Restaurant): string { + if (r.address) return `${r.name} ${r.address}`; + if (r.region) { + const cleanRegion = r.region.replace(/\|/g, " ").trim(); + // 빈 토큰만 남는 경우 (예: '한국' 또는 '한국|') → name만 사용 + if (cleanRegion && cleanRegion !== "한국") return `${r.name} ${cleanRegion}`; + } + return r.name; +} + export default function RestaurantDetail({ restaurant, onClose, @@ -128,7 +139,7 @@ export default function RestaurantDetail({ {restaurant.google_place_id && (