hedena_gold/docs/BRANDING.md

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

نام برند **هدنا گلد / Hedena Gold** است. برای عوض کردن نام دوباره **لازم نیست کل کد را بگردید**؛ فقط موارد همین فهرست.

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

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

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

منبع اصلی (آیکون بدون متن): [`scripts/brand-assets/hedena-icon.webp`](../scripts/brand-assets/hedena-icon.webp)

- `apps/user-app/public/img/brand-logo.png` و `.webp`
- `apps/user-app/src/assets/img/brand-logo.png`
- `apps/user-app/public/img/no-items.png` و `src/assets/img/no-items.png` (placeholder تصویر محصول)
- `apps/admin-panel/src/assets/images/logo/brand-icon.png` و `.webp`، `brand-horizontal.png`
- آیکون‌های PWA و favicon: `apps/*/public/icon-192.png`، `icon-512.png`، `favicon.*`
- اسکریپت (ترجیحی): [`scripts/generate-brand-icons.mjs`](../scripts/generate-brand-icons.mjs) — نیاز به `sharp` و `to-ico`
- اسکریپت جایگزین: [`scripts/generate-brand-icons.py`](../scripts/generate-brand-icons.py)

### بعد از تغییر

1. `dist` فرانت‌ها و `apps/api/release` را دوباره بسازید.
2. اگر در دیتابیس برندی با عنوان قدیمی هست، از پنل ادمین ویرایشش کنید.

## ۲. عمداً خارج از گیت / رفرنس محلی

| مورد | توضیح |
|---|---|
| پوشه‌های `henza_admin`، `henza_pwa`، `henza_server` | فقط رفرنس محلی؛ در `.gitignore` هستند و به ریپو نمی‌روند |
| پوشهٔ `docs/` parity و سوابق | سابقهٔ کار؛ متن برنامه نیست |
| آدرس‌های `henzagold.com` در کامنت‌های قدیمی | اجرا نمی‌شوند |

## ۳. بررسی سریع

```bash
grep -rn "زرتاج\|Zartaj\|منتزر\|gold-bank\|goldbank" apps/*/src brand.ts package.json
```