Files
tehran_taj/docs/BRANDING.md
T
mahmoodandCursor de13445109 feat: new Tehrani brand logo, custom button audience, trim dashboard
- Replace the crown logo with logo.svg / logo_bk.svg across both frontends;
  regenerate favicons and PWA icons via scripts/generate-brand-icons.cjs
- Custom button: admin chooses whether it shows before login or only after
- Dashboard: drop the survey-majority banner, hide the custom-order row

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-14 16:53:25 +03:30

4.5 KiB

برند پروژه (تهران تاج) — چک‌لیست تغییر نام

نام برند تهران تاج / Tehran Taj است. برای عوض کردن نام دوباره لازم نیست کل کد را بگردید؛ فقط موارد همین فهرست.

۱. جاهایی که باید عوض شوند (فقط همین‌ها)

چه چیزی کجا توضیح
نام فارسی، نام لاتین، عنوان تب مرورگر، آدرس سایت brand.ts در ریشهٔ پروژه پنل ادمین، اپ مشتری و اپ مشتری v2 همه از همین یک فایل می‌خوانند: عنوان صفحه، نام نصب PWA، عنوان صفحهٔ ورود، پیام خوش‌آمد، متن‌های راهنما، لینک محصول.
نام برند در همهٔ پیامک‌ها متغیر محیطی BRAND_NAME روی سرور API خالی باشد = «تهران تاج» (پیش‌فرض در apps/api/src/common/brand.ts). بعد از تغییر فقط API را ری‌استارت کنید.
لینک سایت در پیامک خوش‌آمد متغیر محیطی BRAND_SITE_URL روی سرور API پیش‌فرض فعلاً https://bnk.montzar.ir است (دامنهٔ زنده).
لوگو دو فایل SVG در ریشهٔ پروژه (پایین) فقط همین دو فایل را عوض کنید و اسکریپت ساخت را اجرا کنید؛ بقیه از روی آن‌ها ساخته می‌شوند.

فایل‌های لوگو

منبع (ریشهٔ پروژه):

  • logo.svg — نقش مشکی روی زمینهٔ شفاف؛ در صفحه‌ها، favicon و آیکون PWA
  • logo_bk.svg — همان نقش روی کارت سفید؛ برای زمینه‌های تیره (پردهٔ تازه‌سازی اپ)

ساخت همهٔ خروجی‌ها: node scripts/generate-brand-icons.cjs (scripts/generate-brand-icons.cjs). خروجی‌ها:

  • apps/user-app-v2/public/img/brand-logo.svg، brand-logo-card.svg، و نسخهٔ brand-logo.png/.webp برای لینک‌های مستقیم قدیمی
  • apps/user-app-v2/src/assets/img/brand-logo.svg
  • apps/admin-panel/src/assets/images/logo/brand-logo.svg
  • آیکون‌های PWA و favicon: apps/user-app-v2/public/icon-192.png، icon-512.png، apps/*/public/favicon.*

نقش مشکی است؛ در حالت تیرهٔ اپ مشتری، کلاس brand-mark آن را روشن نشان می‌دهد (style.less).

بعد از تغییر

  1. dist هر دو فرانت و apps/api/release را دوباره بسازید (طبق روال انتشار).
  2. اگر در دیتابیس فعلی برندی به نام قدیمی در «برندهای محصول» هست، از پنل ادمین ویرایشش کنید (seed فقط دیتابیس خالی را پر می‌کند).

۲. عمداً عوض نشده‌اند (نام داخلی، دیده نمی‌شوند)

این‌ها به کاربر نمایش داده نمی‌شوند و تغییرشان خرابی می‌آورد:

مورد چرا عوض نشد
کلیدهای مرورگر مثل gold-bank:token تغییر = خروج همهٔ مشتری‌ها از اپ
جدول _goldbank_migrations، نام دیتابیس goldbank، سرویس داکر goldbank-api تغییر = خراب شدن مایگریشن و استقرار روی سرور
نام پکیج‌ها @gold-bank/* و پوشهٔ پروژه فقط نام فنی
شناسهٔ برند محصول brand-montzar در دیتابیس کلید اصلی است و محصولات به آن وصل‌اند؛ عنوانش به «تهران تاج طلا» تغییر کرد
پوشه‌های henza_admin، henza_pwa، henza_server و ارجاع‌های کد به آن‌ها کد سیستم قدیمی، فقط برای مرجع
آدرس‌های henzagold.com در توضیحات کد سابقهٔ سیستم قدیمی، اجرا نمی‌شوند
پوشهٔ docs/ (سوابق) سابقهٔ کار است، نه متن برنامه

۳. بررسی سریع

برای اطمینان از اینکه نام قدیمی جایی در متن‌های برنامه نمانده:

grep -rn "زرتاج\|Zartaj\|منتزر\|Montzar\|هنزا" apps/*/src apps/*/index.html apps/api/prisma/seed.ts brand.ts

خروجی خالی یعنی تمیز است.