الهوية البصرية

أين توجد الهوية البصرية

كل لون رمز (token) يُعرَّف مرة للمظهر الفاتح (:root) ومرة للمظهر الداكن (:root[data-theme="dark"]). تقرأ المكونات الرموز فقط، لذلك يصل تغيير الرمز إلى كل صفحة. غيّر لون العلامة في الكتلتين، وإلا احتفظ مظهر واحد باللون القديم.

اسم الموقع وبريد التواصل والسوق

في storefront/src/config/brand.config.ts:

name: { en: "Velra", ar: "فيلرا" },          // tab titles, sharing cards, the wordmark, the manifest
contactEmail: "hello@velra.example",          // until the dashboard's settings answer
market: {
  currency: "AED",        // prices without a currency of their own, budget ranges, the footer
  timeZone: "Asia/Dubai", // viewing slots and dates
  utcOffset: "+04:00",    // the offset a viewing's preferred time is sent in
  areaServed: "Dubai",    // the agency's structured data for search engines
},

الاسم المكتوب بجانب الرمز نص حي، لذلك يتبع name. يظهر الاسم والمدينة أيضًا في جمل، باللغتين: ابحث في messages/ عن Velra وفيلرا، وعن Dubai ودبي، وأعد كتابة تلك الأسطر. وتلميح المنطقة الزمنية في messages/viewing يقول UTC+4.

رمز الموقع وأيقوناته وصوره

استبدل الملفات وأبقِ أسماءها، أو غيّر mark.color وmark.white في إعدادات العلامة. صور الوكالة نفسها (الاستوديو، والاستقبال، ولوحتا الشراء والإيجار، وبلاطات أنواع العقارات) تقدّمها واجهة API من public/media/velra/site/ في مجلد واجهة API: استبدلها بالأسماء نفسها. والملف agency-studio.webp هو أيضًا صورة المشاركة لكل صفحة ليس لها عقار خاص بها.

ألوان الموقع وخطوطه

يسرد storefront/BRANDING.md كل رمز. تأكد من أن النص على ألوانك ما زال مقروءًا بنسبة 4.5 إلى 1 في المظهرين. تُحمَّل الخطوط عبر next/font/google، فتُقدَّم مع البناء: Manrope للنص اللاتيني، وNoto Sans Arabic للنص العربي، وCormorant Garamond وNoto Naskh Arabic للعناوين. وألوان شريط المتصفح هي themeColor.light وthemeColor.dark في إعدادات العلامة.

نتائج البحث، والمشاركة، والنطاق

• NEXT_PUBLIC_SITE_URL هو أساس كل عنوان أساسي، وبدائل اللغات، وبطاقات المشاركة، وrobots.txt، وخريطة الموقع. اضبطه على عنوانك الحقيقي قبل أن تبني.
• عناوين الصفحات وأوصافها تحت meta في كل مساحة أسماء ضمن messages/ (للصفحة الرئيسية في messages/home، والافتراضي في messages/layouts). تستخدم صفحة العقار عنوان العقار ووصفه الخاصين لتحسين الظهور، المكتوبين في المحرر، وصورة غلافه.
• تُنسَّق الأسعار في src/lib/utils/formatPrice.ts برمز العملة متبوعًا بالمبلغ بأرقام لاتينية (AED 4,850,000)؛ وتضيف الإيجارات الفترة من الترجمات. نطاقات الميزانية في البحث في src/constants/search/priceRanges.ts.

فاتح وداكن ونظام

للتطبيقين قائمة مظهر فيها النظام وفاتح وداكن. يتبع النظام نظام التشغيل ويتغير بتغيره. يُحفظ الاختيار في localStorage بالمتصفح (velra-theme في الموقع وvelra-admin-theme في لوحة التحكم)، ولا يُرسل شيء إلى واجهة API، ويطبّقه سكربت قصير في رأس الصفحة قبل أول رسم، فلا تومض إعادة التحميل بالمظهر الآخر.

اسم لوحة التحكم ورمزها وألوانها

• الاسم: name في src/config/brand.config.ts هو الاسم المكتوب ونصف العلامة في عنوان كل صفحة (Properties | Velra)؛ ويحوي meta العنوان والوصف والكلمات المفتاحية الافتراضية، وdomain.url أساس عناوين البيانات الوصفية المطلقة، وmanifest التطبيق القابل للتثبيت. أما عنوان كل صفحة فهو تحت meta.titles في مساحتَي الأسماء dashboard وauth ضمن messages/.
• الرمز: استبدل public/brand/velra-mark.svg وvelra-mark-white.svg مع إبقاء الأسماء. أيقونة تبويب المتصفح هي src/app/icon0.svg، وأيقونة iPhone هي src/app/apple-icon.png، وأيقونات التطبيق القابل للتثبيت هي ملفا web-app-manifest في public/.
• الألوان: --primaryColor و--primaryColorHover و--primary-foreground و--primary-tint و--background و--surface و--text و--text-muted و--border و--errorColor، إضافة إلى أزواج --tone-* لشارات الحالة، في src/styles/theme-variables.css، مرة لكل مظهر. وأي حالة تأخذ أي درجة موجود في src/config/statusTones.ts.
• الخطوط: Manrope وNoto Sans Arabic وCormorant Garamond وNoto Naskh Arabic، تُحمَّل في src/app/layout.tsx وتُعيَّن في src/styles/base.css.

بيانات الوكالة نفسها

اسم الوكالة وعبارتها التعريفية ووصفها وبريد التواصل ومدينتها إعدادات تُعدَّل في لوحة التحكم تحت الإعدادات ثم الوكالة، ويقرؤها الموقع من GET /api/settings/public. تخزّنها البيانات الأولية باسم agency_name وagency_tagline_en وagency_tagline_ar وagency_description_en وagency_description_ar وcontact_email وagency_city. أما المنازل التي تعرضها الصفحة الرئيسية، والمنزل الذي تعرض غرفته المؤثثة، فتُضبط تحت الإعدادات ثم الصفحة الرئيسية.

شعار العلامة نفسه لا يُرفع في لوحة التحكم: فهو يأتي من الملفات المذكورة أعلاه.

الصياغة وسياسة الخصوصية

كل جملة ظاهرة موجودة في messages/، مجلد لكل منطقة فيه en.json وar.json؛ وأسماء المرافق في messages/amenities. أعد كتابة النصوص في الملفين. سياسة الخصوصية في messages/privacy نص قالب كُتب لوكالة خيالية وتقول ذلك في الصفحة: أعد كتابتها لوكالتك ولبلدك قبل الإطلاق، ثم احذف تلك الملاحظة (الفقرة الأخيرة من src/features/privacy/components/PrivacyHeader.tsx ومفتاحها templateNote في الملفين).

• اللغات