mahmoodandCursor
de13445109
- 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>
58 lines
4.5 KiB
Markdown
58 lines
4.5 KiB
Markdown
# برند پروژه (تهران تاج) — چک‌لیست تغییر نام
|
|
|
|
نام برند **تهران تاج / Tehran Taj** است. برای عوض کردن نام دوباره **لازم نیست کل کد را بگردید**؛ فقط موارد همین فهرست.
|
|
|
|
## ۱. جاهایی که باید عوض شوند (فقط همین‌ها)
|
|
|
|
| چه چیزی | کجا | توضیح |
|
|
|---|---|---|
|
|
| نام فارسی، نام لاتین، عنوان تب مرورگر، آدرس سایت | [`brand.ts`](../brand.ts) در ریشهٔ پروژه | پنل ادمین، اپ مشتری و اپ مشتری v2 همه از همین یک فایل می‌خوانند: عنوان صفحه، نام نصب PWA، عنوان صفحهٔ ورود، پیام خوش‌آمد، متن‌های راهنما، لینک محصول. |
|
|
| نام برند در **همهٔ پیامک‌ها** | متغیر محیطی `BRAND_NAME` روی سرور API | خالی باشد = «تهران تاج» (پیش‌فرض در [`apps/api/src/common/brand.ts`](../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`](../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/` (سوابق) | سابقهٔ کار است، نه متن برنامه |
|
|
|
|
## ۳. بررسی سریع
|
|
|
|
برای اطمینان از اینکه نام قدیمی جایی در متن‌های برنامه نمانده:
|
|
|
|
```bash
|
|
grep -rn "زرتاج\|Zartaj\|منتزر\|Montzar\|هنزا" apps/*/src apps/*/index.html apps/api/prisma/seed.ts brand.ts
|
|
```
|
|
|
|
خروجی خالی یعنی تمیز است.
|