포그라운드 Push 표시 · 퀘스트 알림 다국어 제목 · 약관 미동의 계정의 행성 가입·성운 생성 차단

app/firebase/functions/src/account/account.ts

@@ -147,6 +147,14 @@ function primaryPatch(user: Data, fandomId: string, cooldownDays: number, now: n
  * - `users/{uid}/memberships/{id}` — 「가입 또는 생성한 행성/성운」 목록(명세 §2.58)의 원천.
  * - `memberCount` 는 같은 트랜잭션에서 올린다 — 전환 조건(B-10)이 이 값을 읽는다.
  */
+/**
+ * 가입 약관(`termsAgreedAt`, [fnSignupConsent]) 없이 행성 · 성운 멤버가 되지 않게 막는다.
+ * 앱은 약관 화면부터 보내지만(app_router 게이트) 서버도 같은 기준을 지킨다 — 10/6 실기기 판정.
+ */
+function requireTerms(user: Data): void {
+  if (!user?.termsAgreedAt) fail(ERR.permissionDenied, '이용 약관에 동의한 뒤 가입할 수 있습니다.');
+}
+
 function writeJoin(tx: Transaction, uid: string, fandomId: string, fandom: Data): void {
   const db = getFirestore();
   const memberNo = Number(fandom?.memberSeq ?? fandom?.memberCount ?? 0) + 1;
@@ -199,6 +207,7 @@ export const fnNebulaCreate = onCall(async (req) => {
     const [todaySnap, nameSnap, userSnap] = await Promise.all([
       tx.get(todayRef), tx.get(nameRef), tx.get(userRef),
     ]);
+    requireTerms(userSnap.data());
     if (todaySnap.exists) fail(ERR.nebulaDailyLimit, '이미 오늘 성운을 생성하셨습니다.');
     if (nameSnap.exists) fail(ERR.fandomNameTaken, '이미 사용중인 이름입니다.');
     const { patch } = primaryPatch(userSnap.data(), fandom.id, policy.primaryCooldownDays, now);
@@ -243,6 +252,7 @@ export const fnFandomJoin = onCall(async (req) => {
     ]);
     if (!fandomSnap.exists) fail(ERR.permissionDenied, '행성을 찾을 수 없습니다.');
     if (memberSnap.exists) return { fandomId, joined: false };
+    requireTerms(userSnap.data());
     writeJoin(tx, uid, fandomId, fandomSnap.data());
     // 원장 S20(확인 전 유지 기준) — 창립자가 혼자 떠나 탄생 권한자가 빈 성운은 다음 가입자가 이어받는다.
     if (fandomSnap.get('stage') === 0 && !fandomSnap.get('founderUid')) {

app/firebase/functions/src/core/names.ts

@@ -11,3 +11,20 @@ export function publicNameOf(user: { get(field: string): unknown } | null | unde
   const v = typeof raw === 'string' ? raw.trim() : '';
   return v.length === 0 || v.includes('@') ? PUBLIC_NAME_FALLBACK : v;
 }
+
+/**
+ * 다국어 값 — 문자열이거나 언어별 지도(`{ko, en, …}`, 운영 Quest 제목 등 설계서 §2.8).
+ * 지도면 `locale`(`users/{uid}.locale`, 예 `zh-CN`) → 그 언어 코드 → ko → en → 아무 값.
+ * 앱 `SnapshotReader.textOr` 와 같은 계산. 알림 문구에 지도를 그대로 넣으면 「[object Object]」가 된다.
+ */
+export function localizedText(value: unknown, locale?: unknown): string {
+  if (typeof value === 'string') return value;
+  if (!value || typeof value !== 'object') return '';
+  const map = value as Record<string, unknown>;
+  const tag = typeof locale === 'string' ? locale : '';
+  for (const k of [tag, tag.split('-')[0], 'ko', 'en']) {
+    const v = k ? map[k] : undefined;
+    if (typeof v === 'string' && v) return v;
+  }
+  return Object.values(map).find((v): v is string => typeof v === 'string' && v.length > 0) ?? '';
+}

app/firebase/functions/src/notify/inbox.ts

@@ -2,6 +2,7 @@ import { FieldValue, getFirestore } from 'firebase-admin/firestore';
 import { onDocumentCreated, onDocumentUpdated, onDocumentWritten } from 'firebase-functions/v2/firestore';
 import { logger } from 'firebase-functions';
 
+import { localizedText } from '../core/names.js';
 import { PUSH_CATEGORIES, sendUserPush, type UserPushOutcome } from './push.js';
 
 /**
@@ -99,8 +100,9 @@ export async function notifyQuestDone(
   const count = typeof after.count === 'number' ? after.count : 0;
   if (count < 1) return false;
   if (before && before.dayKey === after.dayKey && (before.count as number | undefined ?? 0) >= count) return false;
-  const quest = await getFirestore().doc(`quests/${questId}`).get();
-  const title = (quest.get('title') as string | undefined) ?? '';
+  const db = getFirestore();
+  const [quest, user] = await Promise.all([db.doc(`quests/${questId}`).get(), db.doc(`users/${uid}`).get()]);
+  const title = localizedText(quest.get('title'), user.get('locale'));
   return notifyOnce(uid, `quest_${questId}_${String(after.dayKey)}_${count}`, {
     eventType: 'quest', type: 'essential',
     title: `[${title}] 퀘스트를 완료했어요!`, source: '퀘스트',