feat(profile): "set your city" gamification box → one-time 500-coin reward

- New searchable city picker (src/lib/iran-cities.ts, ~60 Iranian cities,
  fa/en search) shown as a gold reward card at the top of the profile Basic tab.
- First time a non-empty city is set, the player earns 500 coins (CITY_REWARD),
  granted server-authoritatively. Collapses to a compact summary afterwards with
  a "change city" option (no re-reward).
- Frontend: UserProfile.city + cityRewardClaimed; mock-service grants on first
  set; session/service updateProfile accept `city`; celebratory toast + sfx.
- Backend (.NET): ProfileDto.City/CityRewardClaimed (JSON blob → no migration);
  ProfileService.Update grants +500 once and writes a "city" ledger entry.
- i18n: city.* keys (fa + en).

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

src/lib/i18n.tsx

@@ -152,6 +152,15 @@ const fa: Dict = {
   "chat.placeholder": "پیام بنویسید…",
   "chat.send": "ارسال",
   "chat.emoji": "ایموجی",
+  "city.rewardTitle": "شهرت را انتخاب کن!",
+  "city.rewardSub": "{n} سکه هدیه بگیر",
+  "city.search": "جستجوی شهر…",
+  "city.none": "شهری پیدا نشد",
+  "city.claim": "ثبت و دریافت {n} سکه",
+  "city.saveCity": "ذخیره: {city}",
+  "city.claimed": "جایزهٔ شهر دریافت شد ✓",
+  "city.change": "تغییر",
+  "city.unknown": "نامشخص",
   "chat.empty": "گفتگو را شروع کنید",
   "friends.message": "پیام",
 
@@ -503,6 +512,15 @@ const en: Dict = {
   "chat.placeholder": "Type a message…",
   "chat.send": "Send",
   "chat.emoji": "Emoji",
+  "city.rewardTitle": "Set your city!",
+  "city.rewardSub": "Earn {n} coins",
+  "city.search": "Search city…",
+  "city.none": "No city found",
+  "city.claim": "Save & get {n} coins",
+  "city.saveCity": "Save: {city}",
+  "city.claimed": "City reward claimed ✓",
+  "city.change": "Change",
+  "city.unknown": "Unknown",
   "chat.empty": "Start the conversation",
   "friends.message": "Message",
 

src/lib/iran-cities.ts

@@ -0,0 +1,89 @@
+// Major Iranian cities for the profile "set your city" picker.
+// `id` is a stable slug; `fa`/`en` are display names (search matches either).
+
+export interface City {
+  id: string;
+  fa: string;
+  en: string;
+}
+
+export const IRAN_CITIES: City[] = [
+  { id: "tehran", fa: "تهران", en: "Tehran" },
+  { id: "mashhad", fa: "مشهد", en: "Mashhad" },
+  { id: "isfahan", fa: "اصفهان", en: "Isfahan" },
+  { id: "karaj", fa: "کرج", en: "Karaj" },
+  { id: "shiraz", fa: "شیراز", en: "Shiraz" },
+  { id: "tabriz", fa: "تبریز", en: "Tabriz" },
+  { id: "qom", fa: "قم", en: "Qom" },
+  { id: "ahvaz", fa: "اهواز", en: "Ahvaz" },
+  { id: "kermanshah", fa: "کرمانشاه", en: "Kermanshah" },
+  { id: "urmia", fa: "ارومیه", en: "Urmia" },
+  { id: "rasht", fa: "رشت", en: "Rasht" },
+  { id: "zahedan", fa: "زاهدان", en: "Zahedan" },
+  { id: "hamedan", fa: "همدان", en: "Hamedan" },
+  { id: "kerman", fa: "کرمان", en: "Kerman" },
+  { id: "yazd", fa: "یزد", en: "Yazd" },
+  { id: "ardabil", fa: "اردبیل", en: "Ardabil" },
+  { id: "bandar-abbas", fa: "بندرعباس", en: "Bandar Abbas" },
+  { id: "arak", fa: "اراک", en: "Arak" },
+  { id: "eslamshahr", fa: "اسلام‌شهر", en: "Eslamshahr" },
+  { id: "zanjan", fa: "زنجان", en: "Zanjan" },
+  { id: "sanandaj", fa: "سنندج", en: "Sanandaj" },
+  { id: "qazvin", fa: "قزوین", en: "Qazvin" },
+  { id: "khorramabad", fa: "خرم‌آباد", en: "Khorramabad" },
+  { id: "gorgan", fa: "گرگان", en: "Gorgan" },
+  { id: "sari", fa: "ساری", en: "Sari" },
+  { id: "shahriar", fa: "شهریار", en: "Shahriar" },
+  { id: "dezful", fa: "دزفول", en: "Dezful" },
+  { id: "kashan", fa: "کاشان", en: "Kashan" },
+  { id: "bojnurd", fa: "بجنورد", en: "Bojnurd" },
+  { id: "birjand", fa: "بیرجند", en: "Birjand" },
+  { id: "bushehr", fa: "بوشهر", en: "Bushehr" },
+  { id: "qaemshahr", fa: "قائم‌شهر", en: "Qaemshahr" },
+  { id: "babol", fa: "بابل", en: "Babol" },
+  { id: "amol", fa: "آمل", en: "Amol" },
+  { id: "khoy", fa: "خوی", en: "Khoy" },
+  { id: "sabzevar", fa: "سبزوار", en: "Sabzevar" },
+  { id: "neyshabur", fa: "نیشابور", en: "Neyshabur" },
+  { id: "najafabad", fa: "نجف‌آباد", en: "Najafabad" },
+  { id: "varamin", fa: "ورامین", en: "Varamin" },
+  { id: "bandar-anzali", fa: "بندر انزلی", en: "Bandar-e Anzali" },
+  { id: "yasuj", fa: "یاسوج", en: "Yasuj" },
+  { id: "ilam", fa: "ایلام", en: "Ilam" },
+  { id: "marvdasht", fa: "مرودشت", en: "Marvdasht" },
+  { id: "saveh", fa: "ساوه", en: "Saveh" },
+  { id: "bukan", fa: "بوکان", en: "Bukan" },
+  { id: "shahrekord", fa: "شهرکرد", en: "Shahrekord" },
+  { id: "maragheh", fa: "مراغه", en: "Maragheh" },
+  { id: "semnan", fa: "سمنان", en: "Semnan" },
+  { id: "gonbad-kavus", fa: "گنبد کاووس", en: "Gonbad-e Kavus" },
+  { id: "saqqez", fa: "سقز", en: "Saqqez" },
+  { id: "bandar-mahshahr", fa: "بندر ماهشهر", en: "Bandar-e Mahshahr" },
+  { id: "abadan", fa: "آبادان", en: "Abadan" },
+  { id: "khorramshahr", fa: "خرمشهر", en: "Khorramshahr" },
+  { id: "borujerd", fa: "بروجرد", en: "Borujerd" },
+  { id: "miandoab", fa: "میاندوآب", en: "Miandoab" },
+  { id: "marand", fa: "مرند", en: "Marand" },
+  { id: "torbat-heydarieh", fa: "تربت حیدریه", en: "Torbat-e Heydarieh" },
+  { id: "jiroft", fa: "جیرفت", en: "Jiroft" },
+  { id: "rafsanjan", fa: "رفسنجان", en: "Rafsanjan" },
+  { id: "sirjan", fa: "سیرجان", en: "Sirjan" },
+  { id: "kish", fa: "کیش", en: "Kish" },
+  { id: "qeshm", fa: "قشم", en: "Qeshm" },
+  { id: "other", fa: "سایر شهرها", en: "Other" },
+];
+
+const BY_ID: Record<string, City> = Object.fromEntries(IRAN_CITIES.map((c) => [c.id, c]));
+
+export function cityById(id?: string | null): City | undefined {
+  return id ? BY_ID[id] : undefined;
+}
+
+/** Case/diacritic-insensitive filter on either Persian or English name. */
+export function searchCities(query: string, limit = 30): City[] {
+  const q = query.trim().toLowerCase();
+  if (!q) return IRAN_CITIES.slice(0, limit);
+  return IRAN_CITIES.filter(
+    (c) => c.fa.includes(q) || c.en.toLowerCase().includes(q) || c.id.includes(q),
+  ).slice(0, limit);
+}

src/lib/online/gamification.ts

@@ -803,3 +803,8 @@ export const DAILY_REWARDS = [100, 150, 200, 300, 400, 600, 1500];
 export function dailyRewardFor(day: number): number {
   return DAILY_REWARDS[Math.min(day, DAILY_REWARDS.length) - 1] ?? 100;
 }
+
+/* ----------------------- Profile-completion reward ----------------------- */
+
+/** One-time coin reward for setting your city on the profile. */
+export const CITY_REWARD = 500;

src/lib/online/mock-service.ts

@@ -6,6 +6,7 @@ import {
   ACHIEVEMENTS,
   CARD_BACKS,
   CARD_FRONTS,
+  CITY_REWARD,
   REACTION_PACKS,
   STICKER_PACKS,
   TITLES,
@@ -362,7 +363,13 @@ export class MockOnlineService implements OnlineService {
 
   async updateProfile(patch: Parameters<OnlineService["updateProfile"]>[0]) {
     const p = await this.getProfile();
-    this.profile = { ...p, ...patch };
+    const next = { ...p, ...patch };
+    // One-time reward: first time the player sets a (non-empty) city → +500 coins.
+    if (patch.city && patch.city.trim() && !p.cityRewardClaimed) {
+      next.coins = p.coins + CITY_REWARD;
+      next.cityRewardClaimed = true;
+    }
+    this.profile = next;
     this.saveProfile();
     return this.profile;
   }

src/lib/online/service.ts

@@ -56,7 +56,7 @@ export interface OnlineService {
       Pick<
         UserProfile,
         | "displayName" | "avatar" | "avatarImage" | "title" | "cardFront" | "cardBack"
-        | "gender" | "socials" | "socialsVisibility"
+        | "gender" | "city" | "socials" | "socialsVisibility"
       >
     >
   ): Promise<UserProfile>;

src/lib/online/types.ts

@@ -83,6 +83,8 @@ export interface UserProfile {
 
   // social
   gender?: Gender;
+  city?: string; // selected city id (see IRAN_CITIES)
+  cityRewardClaimed?: boolean; // true once the one-time "set your city" reward was granted
   socials?: SocialLinks;
   socialsVisibility?: SocialVisibility; // default "public"
 

src/lib/session-store.ts

@@ -26,7 +26,7 @@ interface SessionStore {
       Pick<
         UserProfile,
         | "displayName" | "avatar" | "avatarImage" | "title" | "cardFront" | "cardBack"
-        | "gender" | "socials" | "socialsVisibility"
+        | "gender" | "city" | "socials" | "socialsVisibility"
       >
     >
   ) => Promise<void>;