# هوية المشروع — Brand Identity

> **املأ هذا الملف في بداية كل مشروع جديد.** هو المصدر الوحيد للحقيقة (single source of truth)
> الذي تقرأ منه ملفات `project-init` الأخرى (مثل [`landing-site.md`](./landing-site.md)) لبناء
> هوية كاملة للتطبيق: ألوان، خطوط، محتوى، شعار، وصور.
>
> كل ما هو بين `< >` عبارة عن placeholder — استبدله بقيمة المشروع الحقيقية، واحذف القيم غير المتاحة.

---

## 1) الأساسيات (Identity basics)

| الحقل | القيمة |
|------|--------|
| اسم التطبيق (عربي) | `<مثال: خزنة>` |
| اسم التطبيق (إنجليزي) | `<e.g. Khazna>` |
| الوصف المختصر / Tagline (ع) | `<جملة واحدة تلخّص فكرة التطبيق>` |
| الوصف المختصر / Tagline (en) | `<one-line value proposition>` |
| الوصف الطويل (ع) | `<فقرة قصيرة عن التطبيق وقيمته>` |
| الوصف الطويل (en) | `<short paragraph>` |
| الجمهور المستهدف | `<من المستخدم؟>` |
| نبرة العلامة (Tone) | `<مثال: موثوق، دافئ، احترافي / playful, premium...>` |
| نوع التطبيق | `<mobile app / SaaS / marketplace ...>` |

---

## 2) الألوان (Brand palette)

> هذه القيم تُسقَط مباشرة على متغيّرات الـ CSS في `public/landing/css/landing.css` (الكتلة `:root`، البادئة `--safe-*`).
> راجع [`landing-site.md`](./landing-site.md) لخريطة الإسقاط الكاملة.

| الدور | المتغيّر | اللون | ملاحظة |
|------|----------|-------|--------|
| اللون الأساسي | `--safe-primary` | `<#______>` | لون العلامة الرئيسي |
| الأساسي (أغمق 600) | `--safe-primary-600` | `<#______>` | للـ hover |
| الأساسي (أغمق 700) | `--safe-primary-700` | `<#______>` | للنصوص/الأيقونات على خلفية فاتحة |
| الأساسي (فاتح 100) | `--safe-primary-100` | `<#______>` | خلفيات ناعمة |
| الأساسي (فاتح 050) | `--safe-primary-050` | `<#______>` | أفتح خلفية |
| اللون المكمّل (Accent) | `--safe-accent` | `<#______>` | لون ثانوي/تمييز |
| المكمّل (أغمق 700) | `--safe-accent-700` | `<#______>` | |
| لون النص الداكن (Ink) | `--safe-ink` | `<#______>` | العناوين |
| لون نص الجسم | `--safe-body` | `<#______>` | الفقرات |
| لون النص الخافت | `--safe-muted` | `<#______>` | النصوص الثانوية |
| السطح (Surface) | `--safe-surface` | `<#ffffff>` | خلفية الكروت |
| خلفية الصفحة | `--safe-bg` | `<#______>` | |

**Dark mode؟** `<نعم/لا — إن لزم، حدّد نسخة داكنة من القيم أعلاه>`

---

## 3) الخطوط (Typography)

| اللغة | الخط | المصدر |
|------|------|--------|
| العربية | `<مثال: Tajawal>` | `<Google Fonts / ملف محلي>` |
| الإنجليزية | `<e.g. Inter>` | `<Google Fonts / local>` |

> تُحدَّث في `resources/views/landing/partials/head.blade.php` (روابط Google Fonts) وفي متغيّر `--safe-font` داخل `landing.css`.

---

## 4) الشعار والأصول البصرية (Logo & assets)

> ضع ملفات هذا المشروع داخل `docs/project-init/assets/` ثم انسخ ما يلزم إلى `public/landing/img/`.

| الأصل | المسار في هذا الملف | الوجهة في المشروع |
|------|---------------------|--------------------|
| الشعار (PNG/SVG) | `<./assets/logo.svg>` | `public/landing/img/logo.svg` |
| الأيقونة (Favicon) | `<./assets/favicon.png>` | إعداد `fav_icon` |
| أيقونات مساعدة | `<./assets/*.png>` | `public/landing/img/` |

### Screenshots (لقطات التطبيق)
> تُستخدم لاستبدال الـ phone-mockup الافتراضي أو لإثراء أقسام الـ about/download.

- `<./assets/screen-1.png>` — `<وصف الشاشة>`
- `<./assets/screen-2.png>` — `<وصف الشاشة>`
- `<./assets/screen-3.png>` — `<وصف الشاشة>`

---

## 5) التحليل الفني (Technical analysis)

> ضع هنا تحليل المشروع/الـ ERD/الـ features، أو رابطًا لمستند التحليل، حتى يبني المساعد فهمًا
> كاملًا للتطبيق قبل تصميم المحتوى.

```
<الصق التحليل الفني هنا، أو رابط الملف>
```

أقسام التطبيق الرئيسية (features) التي يجب أن تظهر في الموقع التعريفي:
1. `<feature 1>`
2. `<feature 2>`
3. `<feature 3>`

---

## 6) روابط خارجية (Links)

| العنصر | الرابط |
|------|--------|
| تصميم Figma (الرابط الكامل) | `<https://www.figma.com/design/<fileKey>/<name>?node-id=...>` |
| **Figma `fileKey`** (يُشتقّ تلقائيًا من الرابط أعلاه) | `<fileKey — الجزء بعد `/design/` مباشرة، مثال: HZuA1NokGs5cso6nYiCJ2m>` |
| App Store | `<https://apps.apple.com/...>` |
| Google Play | `<https://play.google.com/...>` |
| الموقع/الدومين | `<https://...>` |

> **بناء رابط الشاشة تلقائيًا (بدون تدخّل يدوي):** لأي شاشة في التصميم، Figma MCP يرجّع
> الـ node كـ `254:1955`. الرابط الكامل يُركَّب آليًا من هذا الملف:
> `https://www.figma.com/design/<fileKey>/<name>?node-id=` + **الـ node بعد استبدال `:` بـ `-`** + `&m=dev`
> — مثال: `254:1955` → `…?node-id=254-1955&m=dev`. الـ `fileKey` يُقرأ من هذا الجدول مرة واحدة؛
> استبدال `:`→`-` يُطبَّق لكل node. **لا يُكتب الـ node-id الخام وحده أبدًا** في أي خطة/Postman.

---

## 7) أرقام/إحصائيات (Stats) — اختياري

> تظهر في شريط الإحصائيات بالموقع. عدّلها لتناسب التطبيق.

| القيمة | اللاحقة | التسمية (ع) | التسمية (en) |
|------|---------|-------------|---------------|
| `<10>` | `<K+>` | `<مستخدم>` | `<Users>` |
| `<100>` | `<%>` | `<...>` | `<...>` |
| `<24>` | `</7>` | `<دعم>` | `<Support>` |