الموقع العام

ما يفعله الموقع العام: صفحاته، والتراخيص ودفعها، والتوثيق والمدونة وسجل التغييرات، ونموذج التواصل، والانتقال إلى لوحة التحكم، ومحركات البحث.

لحزمة الحزمة الكاملة

الصفحات

كل صفحة موجودة بالإنجليزية تحت /en وبالعربية تحت /ar، بمظهر فاتح ومظهر داكن. جزآن فقط من الموقع يستدعيان واجهة API لـ Northstack: نموذج التواصل ودفع الترخيص. وكل ما عداهما مكتوب داخل الموقع نفسه.

الصفحة	المسار	ما تعرضه
الرئيسية	`/en`	الواجهة الرئيسية مع احصل على القالب وجرّب العرض الحي، ثم الأساس، ومعاينة مساحة العمل، ومسار الإطلاق، وأدوار مساحة العمل، وقسم المطورين، والترخيصان، والأسئلة الشائعة، ودعوة ختامية إلى اتخاذ إجراء.
الأسعار	`/en/pricing`	الترخيصان، المشروع الواحد والاستوديو، وجدول مقارنة وأسئلة الترخيص. يفتح احصل على ترخيص المشروع الواحد واحصل على ترخيص الاستوديو ملخص الشراء.
إتمام الشراء	`/en/checkout?license=studio`	بيانات المشتري وطريقة الدفع، بجانب الطلب. صفحات العودة هي `/en/checkout/success` و`/en/checkout/cancelled` ودفع الاختبار `/en/checkout/test`.
التوثيق	`/en/docs`, `/en/docs/<article>`	عشر مقالات في ثلاث مجموعات (البداية، المفاهيم الأساسية، النشر)، مع بحث. يفتح `/en/docs` صفحة البدء السريع.
المدونة	`/en/blog`, `/en/blog/<article>`	سبع مقالات بتصنيفات وبحث وصفحات من سبع مقالات.
سجل التغييرات	`/en/changelog`	كل إصدار، الأحدث أولًا، مع تصفية حسب رئيسي أو فرعي أو تصحيحي.
اتصل بنا	`/en/contact`	نموذج التواصل وثلاثة أسئلة شائعة.
قانوني	`/en/legal/privacy`, `/en/legal/terms`, `/en/legal/cookies`, `/en/legal/gdpr`	سياسة الخصوصية وشروط الاستخدام وسياسة ملفات تعريف الارتباط وحقوقك في بياناتك: نصوص تجريبية أعد كتابتها لتناسب عملك.
تسجيل الدخول، إنشاء حساب، إعادة تعيين كلمة المرور	`/en/auth/signin`, `/en/auth/signup`, `/en/auth/forgot-password`	ليس لها صفحة خاصة: كل واحدة تحيل الزائر إلى الصفحة نفسها في لوحة التحكم وباللغة نفسها، مع الإبقاء على سلسلة الاستعلام.
صفحات الأخطاء	`/en/error/401`, `/en/error/404`, `/en/error/500`	الوصول مطلوب، والصفحة غير موجودة، وحدث خطأ ما، وفي كل منها طريق للعودة.

يربط رأس الصفحة بالمنتج والتوثيق والأسعار وسجل التغييرات، ويفتح ابدأ البناء صفحة الأسعار. ويربط التذييل بالتوثيق والمدونة والتواصل والخصوصية والشروط.

روابط إلى لوحة التحكم

لا حسابات خاصة بالموقع. يسجّل الناس الدخول وينشئون حساباتهم ويعملون في لوحة التحكم، على العنوان الموجود في NEXT_PUBLIC_DASHBOARD_URL (http://localhost:3031 عندما يكون فارغًا).

العنصر	وجهته
جرّب العرض الحي (الواجهة الرئيسية)، استكشف العرض الحي (معاينة مساحة العمل وصفحة التواصل)	صفحة تسجيل الدخول في لوحة التحكم، `/<locale>/auth/signin`، بلغة الصفحة.
اطّلع على إدارة الأدوار (قسم الأدوار في الصفحة الرئيسية)	صفحة تسجيل الدخول نفسها، ثم صفحة الأدوار في مساحة العمل بعد تسجيل الدخول.
تسجيل الدخول في صفحة الوصول مطلوب، وعناوين `/auth/...` أعلاه	صفحة لوحة التحكم التي تحمل الاسم نفسه.

لا يحتوي رأس الصفحة على رابط لتسجيل الدخول. تحمل روابط العرض الحي ?demo=1، وعندما يكون الوضع التجريبي مطفأً تفتح نموذج تسجيل الدخول العادي، حيث يسجّل أي حساب أولي الدخول.

التراخيص ودفعها

تقرأ صفحة الأسعار وقسم التراخيص في الصفحة الرئيسية والدفع الترخيصين من src/config/licenses.ts: سعرهما، وعدد المنتجات النهائية التي يغطيها كل منهما، والسطور التي تعرضها كل بطاقة. يفتح زر الترخيص ملخص الشراء، ويفتح المتابعة إلى الدفع المسار /checkout لذلك الترخيص، أو صفحة دفع متجر خارجي إذا حُدد واحد.

يدفع المشتري في صفحة Stripe أو PayPal نفسها، فلا يوجد حقل بطاقة على الموقع إطلاقًا. وبلا مفاتيح دفع في واجهة API تمر الطريقتان عبر دفع الاختبار الخاص بالموقع، الذي لا يخصم من أحد.

الدفع بالترخيص

التوثيق والمدونة وسجل التغييرات

نصها جزء من الموقع، بملف لكل لغة: src/content/docs/ وsrc/content/journal/ وsrc/content/changelog/، في كل منها en.json وar.json. ترتيب مقالات التوثيق ومجموعاته هو DOCS_NAV في src/content/docs/index.ts، وتصنيف كل مقال في المدونة وتاريخه ووقت قراءته هي JOURNAL_ARTICLES في src/content/journal/index.ts، وتاريخ كل إصدار وأنواع تغييراته هي RELEASES في src/content/changelog/index.ts.
يعمل بحث التوثيق في المتصفح على كل مقالات لغة الصفحة.
يُحفظ تصنيف المدونة وبحثها وصفحتها في العنوان بالأسماء category وq وpage، ونوع الإصدار في سجل التغييرات بالاسم type، فيمكن مشاركة القائمة المصفّاة وإعادة تحميلها.
يصف التوثيق Northstack نفسه: أعد كتابته أو احذفه ليناسب منتجك.

نموذج التواصل

اسم (من 2 إلى 120 حرفًا)، وبريد العمل، وموضوع (الترخيص أو الإعداد أو سؤال عن المنتج)، ورسالة من 20 إلى 2,000 حرف، ثم أرسل الرسالة. تخزّن واجهة API كل رسالة في جدول contact_messages، وعندما يكون CONTACT_INBOX مضبوطًا في .env الخاص بها تحيلها إلى ذلك العنوان بالبريد. ليس في لوحة التحكم صفحة تعرضها.

يحمل النموذج حقلًا مخفيًا يصطاد الروبوتات (الحقل المملوء يُجاب عنه كأنه أُرسل ولا يُخزَّن في أي مكان)، ويرسل الرسالة نفسها مرة واحدة فقط مهما تكررت المحاولة، ويقبل خمس رسائل لكل عنوان في الساعة، وتطلب السادسة المحاولة لاحقًا. خلف خادم وكيل عكسي اضبط TRUST_PROXY=1 في .env الخاص بواجهة API، وإلا يتشارك كل الزوار حصة الوكيل.

إعدادات البريد

محركات البحث

تضبط كل صفحة عنوانها ووصفها وعنوانها الأساسي وبدائل اللغات وبطاقة المشاركة، وتبنيها من NEXT_PUBLIC_SITE_URL، لذلك اضبطه على عنوانك الحقيقي قبل البناء.
يسرد /sitemap.xml الصفحة الرئيسية والأسعار والتوثيق والمدونة وسجل التغييرات والتواصل والصفحات القانونية، وكل مقال في التوثيق والمدونة، كلًّا باللغتين مع بديله. ويسمح /robots.txt بكل صفحة ويشير إلى خريطة الموقع.
صفحة الدفع وصفحات العودة منها وصفحات الخطأ موسومة بـ noindex.
لا تُحمَّل أي علامة تحليلات أو إعلانات.

من دون واجهة API

عند البناء مع ترك NEXT_PUBLIC_API_BASE_URL فارغًا، أو التشغيل بلا .env، يعمل الموقع على بياناته التجريبية المدمجة: يجيب نموذج التواصل ودفع الترخيص داخل المتصفح، ويفتح الطلب دفع الاختبار الخاص بالموقع، ويعرض إيصاله مفتاح ترخيص، ولا يُرسل شيء إلى أي مكان. ويقول ذلك إشعار بيانات تجريبية في أسفل كل صفحة.