chore : 버전 2.9.0

apps/twa/CLAUDE.md

@@ -5,12 +5,12 @@ This file provides guidance to Claude Code (claude.ai/code) when working with th
 ## Overview
 
 `apps/twa`는 **Singcode PWA를 Google Play Store에 배포하기 위한 Android 빌드 워크스페이스**다.
-Bubblewrap CLI가 `https://singcode.kr`의 PWA Manifest를 받아 Android 프로젝트(.aab/.apk)를 생성한다.
+Bubblewrap CLI가 `https://www.singcode.kr`의 PWA Manifest를 받아 Android 프로젝트(.aab/.apk)를 생성한다.
 
 - **Application ID**: `kr.singcode.app` — 한 번 결정되면 영구적이다. 변경 불가.
-- **PWA URL**: `https://singcode.kr`
-- **Manifest URL**: `https://singcode.kr/manifest.webmanifest`
-- **Digital Asset Links**: `https://singcode.kr/.well-known/assetlinks.json`
+- **PWA URL**: `https://www.singcode.kr`
+- **Manifest URL**: `https://www.singcode.kr/manifest.webmanifest`
+- **Digital Asset Links**: `https://www.singcode.kr/.well-known/assetlinks.json`
 
 ## Prerequisites (로컬 1회성 셋업)
 
@@ -64,8 +64,8 @@ pnpm build   # bubblewrap build
 빌드 전 PWA가 정상인지 확인.
 
 ```bash
-curl -sI https://singcode.kr/manifest.webmanifest         # 200
-curl -s   https://singcode.kr/manifest.webmanifest | jq . # 유효한 JSON
+curl -sI https://www.singcode.kr/manifest.webmanifest         # 200
+curl -s   https://www.singcode.kr/manifest.webmanifest | jq . # 유효한 JSON
 ```
 
 `manifest.webmanifest`의 `icons[].purpose`에 `any`와 `maskable`이 모두 등록되어 있어야 한다.
@@ -82,16 +82,16 @@ pnpm --filter twa run init
 
 | 항목              | 값                                                |
 | ----------------- | ------------------------------------------------- |
-| Domain            | `singcode.kr`                                     |
+| Domain            | `www.singcode.kr`                                 |
 | Application ID    | `kr.singcode.app` (영구)                          |
 | Application name  | `Singcode - 당신의 노래방 메모장`                 |
 | Launcher name     | `Singcode`                                        |
 | Display mode      | `standalone`                                      |
 | Orientation       | `portrait`                                        |
 | Theme color       | `#1a1a2e`                                         |
 | Splash background | `#1a1a2e`                                         |
-| Icon URL          | `https://singcode.kr/icons/icon-512.png`          |
-| Maskable icon URL | `https://singcode.kr/icons/icon-maskable-512.png` |
+| Icon URL          | `https://www.singcode.kr/icons/icon-512.png`          |
+| Maskable icon URL | `https://www.singcode.kr/icons/icon-maskable-512.png` |
 | Signing key alias | `singcode`                                        |
 
 ### 3. 키스토어 생성 (최초 1회, 사용자 직접 진행)
@@ -139,10 +139,10 @@ keytool -list -v \
 배포 후 검증:
 
 ```bash
-curl -sI https://singcode.kr/.well-known/assetlinks.json   # 200
+curl -sI https://www.singcode.kr/.well-known/assetlinks.json   # 200
 ```
 
-[Statement List Tester](https://developers.google.com/digital-asset-links/tools/generator)에서 `https://singcode.kr` + `kr.singcode.app` + SHA-256으로 통과 확인.
+[Statement List Tester](https://developers.google.com/digital-asset-links/tools/generator)에서 `https://www.singcode.kr` + `kr.singcode.app` + SHA-256으로 통과 확인.
 
 ### 6. `bubblewrap build`
 
@@ -168,7 +168,7 @@ adb install -r apps/twa/app-release-signed.apk
 체크리스트:
 
 - [ ] 앱 실행 시 **풀스크린** (주소창이 뜨지 않음)
-- [ ] `singcode.kr` 정상 로드 (오프라인 splash 후 메인 진입)
+- [ ] `www.singcode.kr` 정상 로드 (오프라인 splash 후 메인 진입)
 - [ ] 시스템 뒤로가기 동작 정상
 - [ ] 카카오 로그인 정상 (브라우저 탭 전환 후 복귀)
 - [ ] PWA 아이콘 (`icon-maskable-*`)이 흰 배경 마스킹 없이 표시
@@ -184,7 +184,7 @@ adb install -r apps/twa/app-release-signed.apk
 keytool -printcert -jarfile apps/twa/app-release-signed.apk
 
 # 2. 배포된 assetlinks.json 값 확인
-curl -s https://singcode.kr/.well-known/assetlinks.json | jq .
+curl -s https://www.singcode.kr/.well-known/assetlinks.json | jq .
 
 # 3. 두 값이 동일한지 비교 — 다르면 assetlinks.json 갱신 후 재배포
 ```

apps/twa/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "description": "Singcode TWA (Trusted Web Activity) Android build",
   "scripts": {
-    "init": "bubblewrap init --manifest=https://singcode.kr/manifest.webmanifest",
+    "init": "bubblewrap init --manifest=https://www.singcode.kr/manifest.webmanifest",
     "build": "bubblewrap build",
     "update": "bubblewrap update"
   },

apps/twa/twa-manifest.json

@@ -1,6 +1,6 @@
 {
   "packageId": "kr.singcode.app",
-  "host": "singcode.kr",
+  "host": "www.singcode.kr",
   "name": "싱코드(singcode) - 노래방 번호 검색",
   "launcherName": "Singcode",
   "display": "standalone",
@@ -13,19 +13,19 @@
   "backgroundColor": "#1A1A2E",
   "enableNotifications": true,
   "startUrl": "/",
-  "iconUrl": "https://singcode.kr/icons/icon-512.png",
-  "maskableIconUrl": "https://singcode.kr/icons/icon-maskable-512.png",
-  "monochromeIconUrl": "https://singcode.kr/icons/icon-512.png",
+  "iconUrl": "https://www.singcode.kr/icons/icon-512.png",
+  "maskableIconUrl": "https://www.singcode.kr/icons/icon-maskable-512.png",
+  "monochromeIconUrl": "https://www.singcode.kr/icons/icon-512.png",
   "splashScreenFadeOutDuration": 300,
   "signingKey": {
     "path": "./android.keystore",
     "alias": "singcode"
   },
-  "appVersionName": "3",
-  "appVersionCode": 3,
+  "appVersionName": "7",
+  "appVersionCode": 7,
   "shortcuts": [],
   "generatorApp": "bubblewrap-cli",
-  "webManifestUrl": "https://singcode.kr/manifest.webmanifest",
+  "webManifestUrl": "https://www.singcode.kr/manifest.webmanifest",
   "fallbackType": "customtabs",
   "features": {},
   "alphaDependencies": {
@@ -34,7 +34,7 @@
   "enableSiteSettingsShortcut": true,
   "isChromeOSOnly": false,
   "isMetaQuest": false,
-  "fullScopeUrl": "https://singcode.kr/",
+  "fullScopeUrl": "https://www.singcode.kr/",
   "minSdkVersion": 21,
   "orientation": "portrait",
   "fingerprints": [],
@@ -44,5 +44,5 @@
   "fileHandlers": [],
   "launchHandlerClientMode": "",
   "displayOverride": [],
-  "appVersion": "3"
-}
+  "appVersion": "7"
+}

apps/web/.gitignore

@@ -45,3 +45,5 @@ next-env.d.ts
 /public/sw.js.map
 /public/swe-worker-*.js
 /public/swe-worker-*.js.map
+
+store-assets

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "type": "module",
   "private": true,
   "scripts": {
@@ -43,6 +43,7 @@
     "axios": "^1.5.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "country-flag-icons": "^1.6.20",
     "date-fns": "^4.1.0",
     "es-hangul": "^2.3.8",
     "framer-motion": "^12.33.0",

apps/web/src/Footer.tsx

@@ -30,7 +30,7 @@ export default function Footer() {
   const navPath = pathname.split('/')[1];
 
   return (
-    <footer className="bg-background fixed bottom-0 flex h-8 w-full max-w-md justify-between border-t">
+    <footer className="bg-background fixed bottom-0 flex h-10 w-full max-w-md justify-between border-t">
       {navigation.map(item => {
         const isActive = '/' + navPath === item.href;
         const isAnimating = footerAnimateKey === item.key;

apps/web/src/app/api/search/route.ts

@@ -1,5 +1,6 @@
 import { NextResponse } from 'next/server';
 
+import { LANGUAGE_TAGS } from '@/constants/languageTags';
 import createClient from '@/lib/supabase/server';
 import { ApiResponse } from '@/types/apiRoute';
 import { SearchSong, Song } from '@/types/song';
@@ -56,20 +57,36 @@ function buildColumnOrGroup(columns: string[], pattern: string): string {
   return columns.map(column => `${column}.ilike.${pattern}`).join(',');
 }
 
+// languageTag가 있으면 song_tags(언어 태그) 조인 필터를 추가한다.
+// select 절에 `song_tags!inner(tag_id)`가 함께 포함되어 있어야 한다.
+function applyLanguageTagFilter<T extends { eq: (column: string, value: number) => T }>(
+  query: T,
+  languageTag?: number,
+): T {
+  return languageTag ? query.eq('song_tags.tag_id', languageTag) : query;
+}
+
 // 정확 일치: 전체 구가 한 컬럼과 일치 (랭킹 상위). 띄어쓰기 차이는 무시한다.
-function applyExactFilter(baseQuery: any, type: string, searchText: string) {
+function applyExactFilter(baseQuery: any, type: string, searchText: string, languageTag?: number) {
   if (type === 'number') {
-    return baseQuery.or(`num_tj.eq.${searchText},num_ky.eq.${searchText}`);
+    const query = baseQuery.or(`num_tj.eq.${searchText},num_ky.eq.${searchText}`);
+    return applyLanguageTagFilter(query, languageTag);
   }
 
   const phrase = buildPhrasePattern(tokenizeQuery(searchText));
   const columns = getSearchColumns(type);
 
-  return baseQuery.or(buildColumnOrGroup(columns, phrase));
+  const query = baseQuery.or(buildColumnOrGroup(columns, phrase));
+  return applyLanguageTagFilter(query, languageTag);
 }
 
 // 부분 일치: 입력한 모든 토큰이 (순서 무관) 포함돼야 매칭(AND) + 정확 일치 결과는 제외.
-function applyPartialFilter(baseQuery: any, type: string, searchText: string) {
+function applyPartialFilter(
+  baseQuery: any,
+  type: string,
+  searchText: string,
+  languageTag?: number,
+) {
   const tokens = tokenizeQuery(searchText);
   const phrase = buildPhrasePattern(tokens);
   const columns = getSearchColumns(type);
@@ -90,7 +107,7 @@ function applyPartialFilter(baseQuery: any, type: string, searchText: string) {
     query = query.or(`${column}.not.ilike.${phrase},${column}.is.null`);
   }
 
-  return query;
+  return applyLanguageTagFilter(query, languageTag);
 }
 
 async function executeSearchQueries(
@@ -101,6 +118,7 @@ async function executeSearchQueries(
   order: string,
   from: number,
   to: number,
+  languageTag?: number,
 ): Promise<{ data: DBSong[]; hasNext: boolean } | { error: string }> {
   const size = to - from + 1;
 
@@ -110,11 +128,17 @@ async function executeSearchQueries(
       supabase.from('songs').select(selectClause, { count: 'exact', head: true }),
       type,
       query,
+      languageTag,
     );
     if (exactCountResult.error) return { error: exactCountResult.error.message };
     const exactTotal = exactCountResult.count ?? 0;
 
-    const exactQuery = applyExactFilter(supabase.from('songs').select(selectClause), type, query);
+    const exactQuery = applyExactFilter(
+      supabase.from('songs').select(selectClause),
+      type,
+      query,
+      languageTag,
+    );
     const { data, error } = await exactQuery.order(order).range(from, to);
     if (error) return { error: error.message };
 
@@ -134,11 +158,13 @@ async function executeSearchQueries(
     supabase.from('songs').select(selectClause, { count: 'exact', head: true }),
     type,
     query,
+    languageTag,
   );
   const partialCountQuery = applyPartialFilter(
     supabase.from('songs').select(selectClause, { count: 'exact', head: true }),
     type,
     query,
+    languageTag,
   );
 
   const [exactCountResult, partialCountResult] = await Promise.all([
@@ -163,6 +189,7 @@ async function executeSearchQueries(
       supabase.from('songs').select(selectClause),
       type,
       query,
+      languageTag,
     );
     const { data, error } = await partialQuery.order(order).range(from, to);
     if (error) return { error: error.message };
@@ -175,14 +202,20 @@ async function executeSearchQueries(
       supabase.from('songs').select(selectClause),
       type,
       query,
+      languageTag,
     );
     const { data, error } = await partialQuery.order(order).range(partialFrom, partialTo);
     if (error) return { error: error.message };
     partialData = (data as DBSong[]) ?? [];
   } else {
     // 현재 페이지가 정확 일치 영역에 포함 (경계에 걸릴 수도 있음)
     const exactTo = Math.min(to, exactTotal - 1);
-    const exactQuery = applyExactFilter(supabase.from('songs').select(selectClause), type, query);
+    const exactQuery = applyExactFilter(
+      supabase.from('songs').select(selectClause),
+      type,
+      query,
+      languageTag,
+    );
     const exactResult = await exactQuery.order(order).range(from, exactTo);
     if (exactResult.error) return { error: exactResult.error.message };
     exactData = (exactResult.data as DBSong[]) ?? [];
@@ -194,6 +227,7 @@ async function executeSearchQueries(
         supabase.from('songs').select(selectClause),
         type,
         query,
+        languageTag,
       );
       const partialResult = await partialQuery.order(order).range(0, partialTo);
       if (partialResult.error) return { error: partialResult.error.message };
@@ -217,6 +251,23 @@ export async function GET(request: Request): Promise<NextResponse<ApiResponse<Se
     const order = type === 'all' ? 'title' : type === 'number' ? 'num_tj' : type;
     const authenticated = searchParams.get('authenticated') === 'true';
 
+    const languageTagParam = searchParams.get('languageTag');
+    let languageTag: number | undefined;
+    if (languageTagParam) {
+      const parsedLanguageTag = Number.parseInt(languageTagParam, 10);
+      const isValidLanguageTag = LANGUAGE_TAGS.some(tag => tag.id === parsedLanguageTag);
+      if (!isValidLanguageTag) {
+        return NextResponse.json(
+          {
+            success: false,
+            error: '유효하지 않은 languageTag 값입니다',
+          },
+          { status: 400 },
+        );
+      }
+      languageTag = parsedLanguageTag;
+    }
+
     const page = parseInt(searchParams.get('page') || '0', 10);
     const size = 20;
     const from = page * size;
@@ -234,11 +285,25 @@ export async function GET(request: Request): Promise<NextResponse<ApiResponse<Se
 
     const supabase = await createClient();
 
-    const selectClause = authenticated
+    const baseSelectClause = authenticated
       ? `*, thumb_logs(*), tosings(user_id), like_activities(user_id), save_activities(user_id)`
       : `*, thumb_logs(*)`;
-
-    const result = await executeSearchQueries(supabase, selectClause, query, type, order, from, to);
+    // languageTag로 필터링할 때만 song_tags를 inner join으로 함께 select한다.
+    // (그 외에는 태그 없는 곡이 결과에서 누락되지 않도록 조인하지 않는다)
+    const selectClause = languageTag
+      ? `${baseSelectClause}, song_tags!inner(tag_id)`
+      : baseSelectClause;
+
+    const result = await executeSearchQueries(
+      supabase,
+      selectClause,
+      query,
+      type,
+      order,
+      from,
+      to,
+      languageTag,
+    );
 
     if ('error' in result) {
       return NextResponse.json(

apps/web/src/app/layout.tsx

@@ -38,8 +38,8 @@ export const metadata: Metadata = {
   },
   twitter: {
     card: 'summary_large_image',
-    title: 'Singcode - 노래방에서 부를 곡, 기억하지 말고 저장하세요',
-    description: '노래방 갈 때마다 잊어버리는 곡번호? Singcode가 대신 기억할게요!',
+    title: 'Singcode - 노래방 번호 검색',
+    description: 'Singcode에서 빠르고 편하게 노래방 번호 검색하세요. J-POP 검색도 지원합니다.',
     images: ['/brand/thumbnail.png'],
   },
   robots: {
@@ -106,7 +106,7 @@ export default function RootLayout({
         <Header />
         <div className="h-full p-4">{children}</div>
 
-        <div className="pointer-events-none fixed bottom-8 left-1/2 z-40 w-full max-w-md -translate-x-1/2 px-1 pb-1">
+        <div className="pointer-events-none fixed bottom-10 left-1/2 z-40 w-full max-w-md -translate-x-1/2 px-1 pb-1">
           <div className="pointer-events-auto">
             <PromotionBanner />
           </div>

apps/web/src/app/patch-notes/page.tsx

@@ -25,7 +25,7 @@ export default function PatchNotesPage() {
       </div>
 
       <ScrollArea className="mt-4 flex-1">
-        <ol className="relative flex flex-col gap-6 pb-8">
+        <ol className="relative flex flex-col gap-6 pb-10">
           <span
             aria-hidden
             className="bg-border absolute top-3 bottom-3 left-[5rem] w-px sm:left-[6rem]"

apps/web/src/app/privacy/page.tsx

@@ -7,7 +7,7 @@ export const metadata: Metadata = {
 
 export default function PrivacyPage() {
   return (
-    <div className="space-y-8 pb-8 text-sm leading-relaxed">
+    <div className="space-y-8 pb-10 text-sm leading-relaxed">
       <div>
         <h1 className="mb-2 text-2xl font-bold">Singcode 개인정보처리방침</h1>
         <p className="text-muted-foreground">본 방침은 2025년 6월 18일부터 적용됩니다.</p>