شغّل نشاط الحجز محليًا

1. 01

   نزّل قالبك

   افتح صفحة «قوالبي» ونزّل ملف ZIP الخاص بحزمتك.

   • قوالبي

   0:00 / 0:06

   النتيجة المتوقعة: يوجد في مجلد التنزيلات ملف اسمه مثل hollina-vacation-rental-full-stack-….zip.

   أنجزت هذه الخطوة
2. 02

   فك الضغط وافتح المجلد

   افتح طرفية في المكان الذي يوجد فيه ملف ZIP، وفك ضغطه، وادخل إلى المجلد hollina-vacation-rental-full-stack. على Windows يمكنك فك الضغط من File Explorer بدلًا من ذلك، ثم فتح طرفية في المجلد.

   الطرفيةنسخ

   unzip -q hollina-vacation-rental-full-stack-*.zip
   cd hollina-vacation-rental-full-stack

   0:00 / 0:06

   النتيجة المتوقعة: يعرض المجلد admin-dashboard وback-end وstorefront وdocker-compose.yml، إلى جانب README.md وQUICKSTART.md وLICENSE.md.

   تواجه مشكلة؟

   أنجزت هذه الخطوة
3. 03

   شغّل التطبيقات

   ابنِ واجهة API وموقع الإقامات ولوحة تحكم الحجوزات وشغّلها. لا شيء يلزم ضبطه أولًا. أول تشغيل يبني ثلاث صور ويملأ قاعدة البيانات بالشركة التجريبية، وهذا يستغرق بضع دقائق؛ والتشغيلات التالية تستغرق ثوانيَ.

   الطرفيةفي hollina-vacation-rental-full-stackنسخ

   docker compose up --build

   المنفذ مستخدم بالفعل؟

   إذا توقف التشغيل برسالة ports are not available أو address already in use أو port is already allocated فهناك برنامج آخر يستخدم 3030 أو 3031 أو 8000. أوقفه، أو أنشئ ملفًا باسم .env في المجلد hollina-vacation-rental-full-stack، بجوار docker-compose.yml، فيه المنفذ الذي تحتاجه، مثل ADMIN_PORT=3041 (وSITE_PORT للموقع وAPI_PORT لواجهة API). شغّل docker compose up --build مرة أخرى وافتح التطبيق على منفذه الجديد.

   المنفذ مستخدم بالفعل

   0:00 / 0:08

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

   تواجه مشكلة؟

   أنجزت هذه الخطوة
4. 04

   افتح موقع الإقامات

   افتح localhost:3030محلي. الإنجليزية على /en والعربية على /ar. لا حسابات في الموقع: تُحفظ الإقامات في متصفح الزائر، ويجد الضيف حجزه من جديد بمرجعه والبريد الإلكتروني الذي استُخدم فيه. وبدون مفاتيح دفع يقبل المحاكي المرفق كل حجز بالبطاقة أو PayPal، فيعمل إتمام الطلب كله؛ ورقم البطاقة الذي ينتهي بـ 0 يُرفض ليُظهر مسار الفشل.

   0:00 / 0:25

   النتيجة المتوقعة: يفتح الموقع على صفحته الرئيسية مع الإقامات التجريبية وصورها والوجهات.

   تواجه مشكلة؟

   أنجزت هذه الخطوة
5. 05

   سجّل الدخول إلى لوحة تحكم الحجوزات

   افتح localhost:3031محلي. سجّل الدخول بـ admin@hollina.example وكلمة المرور Admin@123. للمدير اكتب manager@hollina.example مع Manager@123. غيّر كلمتي المرور قبل أن يصبح التطبيق متاحًا من الإنترنت.

   0:00 / 0:09

   النتيجة المتوقعة: تفتح لوحة التحكم على نظرتها العامة، مع إشغال هذا الشهر وإيراداته، ووصول اليوم ومغادرته، وأحدث الحجوزات.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

جولة سريعة

كيف تبدو الشركة التجريبية بعد تشغيل كل شيء.

تضيف البيانات الأولية 14 إقامة (12 منشورة ومسودتان) مع 42 صورة، و6 وجهات، و18 مرفقًا، و60 حجزًا على امتداد السنة، و8 نطاقات محظورة، و12 سؤالًا من الضيوف، و24 تقييمًا، و6 أسئلة للصفحة الرئيسية، فتفتح كل شاشة وهي ممتلئة. تُحفظ التواريخ كإزاحات عن يوم تعبئة البيانات، فتجد قاعدة بيانات جديدة وصولًا اليوم دائمًا. هذه حسابات تجريبية محلية فقط.

أوقف التطبيقات وأعد تشغيلها

اضغط Ctrl+C في الطرفية لإيقاف التطبيقات، أو شغّل هذا من المجلد hollina-vacation-rental-full-stack. بياناتك، أي قاعدة البيانات والملفات المرفوعة، محفوظة في وحدة التخزين hollina-data.

docker compose down

أعد التشغيل بالأمر نفسه في الخطوة 3. من دون --build يعيد استخدام الصور التي بنيتها مسبقًا.

docker compose up

شغّل موقع الإقامات

هذه الحزمة هي موقع الإقامات وحده. يقرأ كل شيء من واجهة Hollina API، لذلك شغّل واجهة API أولًا. ما لم تبنِه بعنوان آخر، يتوقع الموقع أن تكون واجهة API على http://localhost:8000. واجهة API حزمة منفصلة وليست في هذا التنزيل.

1. 01

   نزّل قالبك

   افتح «قوالبي» ونزّل ملف ZIP الخاص بموقع الإقامات.

   • قوالبي

   0:00 / 0:06

   أنجزت هذه الخطوة
2. 02

   فك الضغط وافتح المجلد

   الطرفيةنسخ

   unzip -q hollina-website-*.zip
   cd hollina-website

   0:00 / 0:05

   النتيجة المتوقعة: يحتوي المجلد على Dockerfile وpackage.json.

   تواجه مشكلة؟

   أنجزت هذه الخطوة
3. 03

   ابنِ الصورة

   قيم NEXT_PUBLIC_* تُدمج في JavaScript الذي يحمّله المتصفح، لذلك هي معاملات بناء. بدونها يستخدم الموقع واجهة API على http://localhost:8000/api ويسمّي نفسه http://localhost:3030. أما لواجهة API في مكان آخر فمرّر عنوانها.

   الطرفيةفي hollina-websiteنسخ

   docker build -t hollina-website .

   مع واجهة API ونطاق خاصين بك:

   الطرفيةفي hollina-websiteنسخ

   docker build -t hollina-website --build-arg NEXT_PUBLIC_API_BASE_URL=https://api.your-company.com/api --build-arg NEXT_PUBLIC_SITE_URL=https://www.your-company.com --build-arg NEXT_PUBLIC_MEDIA_HOSTNAME=media.your-company.com .

   0:00 / 0:08

   تواجه مشكلة؟

   أنجزت هذه الخطوة
4. 04

   شغّله

   داخل الحاوية يكون localhost هو الحاوية نفسها، لذلك يخبر API_INTERNAL_URL خادم الموقع أين يجد واجهة API على جهازك، لعناوين الصفحات، والعرض الأول للصفحة الرئيسية وصفحات الإقامات، وخريطة الموقع. يجعل --add-host الاسم host.docker.internal يعمل على Linux؛ وهو موجود أصلًا في Docker Desktop. إذا كان المنفذ 3030 مشغولًا فغيّر الرقم الذي على يسار -p، مثل -p 3041:3030، وافتح ذلك المنفذ بدلًا منه، وأضف http://localhost:3041 إلى CORS_ORIGIN في واجهة API.

   الطرفيةفي hollina-websiteنسخ

   docker run -p 3030:3030 -e API_INTERNAL_URL=http://host.docker.internal:8000/api --add-host=host.docker.internal:host-gateway hollina-website

   0:00 / 0:12

   النتيجة المتوقعة: يفتح localhost:3030محلي الموقع مع الإقامات القادمة من واجهة API لديك. الإنجليزية على /en والعربية على /ar.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

شغّل لوحة تحكم الحجوزات

هذه الحزمة هي لوحة تحكم الحجوزات وحدها. كل شاشة تقرأ من واجهة Hollina API، لذلك شغّل واجهة API أولًا. ما لم تبنِها بعنوان آخر، تتوقع لوحة التحكم أن تكون واجهة API على http://localhost:8000. واجهة API حزمة منفصلة وليست في هذا التنزيل.

1. 01

   نزّل قالبك

   افتح «قوالبي» ونزّل ملف ZIP الخاص بلوحة تحكم الحجوزات.

   • قوالبي

   0:00 / 0:06

   أنجزت هذه الخطوة
2. 02

   فك الضغط وافتح المجلد

   الطرفيةنسخ

   unzip -q hollina-booking-dashboard-*.zip
   cd hollina-booking-dashboard

   0:00 / 0:06

   النتيجة المتوقعة: يحتوي المجلد على Dockerfile وpackage.json.

   تواجه مشكلة؟

   أنجزت هذه الخطوة
3. 03

   ابنِ الصورة

   بدون معاملات بناء تستخدم لوحة التحكم واجهة API على http://localhost:8000/api. لواجهة API في مكان آخر مرّر عنوانها، وعنوانها بدون /api للإشعارات المباشرة، وعنوان الموقع لرابط «العودة إلى الموقع» ولرابط «عرض الإقامة» في محرر الإقامة.

   الطرفيةفي hollina-booking-dashboardنسخ

   docker build -t hollina-dashboard .

   مع واجهة API خاصة بك:

   الطرفيةفي hollina-booking-dashboardنسخ

   docker build -t hollina-dashboard --build-arg NEXT_PUBLIC_API_BASE_URL=https://api.your-domain.com/api --build-arg NEXT_PUBLIC_WEBSOCKET_BASE_URL=https://api.your-domain.com --build-arg NEXT_PUBLIC_MEDIA_HOSTNAME=api.your-domain.com --build-arg NEXT_PUBLIC_SITE_URL=https://your-domain.com .

   0:00 / 0:08

   تواجه مشكلة؟

   أنجزت هذه الخطوة
4. 04

   شغّلها وسجّل الدخول

   إذا كان المنفذ 3031 مشغولًا فغيّر الرقم الذي على يسار -p، مثل -p 3041:3031، وافتح ذلك المنفذ بدلًا منه، وأضف http://localhost:3041 إلى CORS_ORIGIN في واجهة API (واضبط FRONTEND_URL عليه، وهو العنوان الذي تتصل منه الإشعارات المباشرة).

   الطرفيةفي hollina-booking-dashboardنسخ

   docker run -p 3031:3031 hollina-dashboard

   0:00 / 0:12

   النتيجة المتوقعة: يفتح localhost:3031محلي نموذج تسجيل الدخول. سجّل الدخول بـ admin@hollina.example وكلمة المرور Admin@123، وتقبلهما واجهة API المعبأة بالبيانات.

   تواجه مشكلة؟

   أنجزت هذه الخطوة

شغّل واجهة API

هذه الحزمة هي واجهة NestJS API وحدها، على ملف SQLite محفوظ في وحدة تخزين Docker مع الملفات المرفوعة. موقع الإقامات ولوحة تحكم الحجوزات حزمتان منفصلتان وليستا في هذا التنزيل.

1. 01

   نزّل قالبك

   افتح صفحة «قوالبي» ونزّل ملف ZIP الخاص بواجهة API.

   • قوالبي

   0:00 / 0:06

   أنجزت هذه الخطوة
2. 02

   فك الضغط وافتح المجلد

   الطرفيةنسخ

   unzip -q hollina-backend-*.zip
   cd hollina-backend

   0:00 / 0:05

   النتيجة المتوقعة: يحتوي المجلد على Dockerfile وdocker-entrypoint.sh وpackage.json.

   تواجه مشكلة؟

   أنجزت هذه الخطوة
3. 03

   ابنِ الصورة

   الطرفيةفي hollina-backendنسخ

   docker build -t hollina-api .

   0:00 / 0:08

   تواجه مشكلة؟

   أنجزت هذه الخطوة
4. 04

   شغّلها مع الشركة التجريبية

   تحصل وحدة التخزين الجديدة على جداول فارغة وبلا حسابات ما لم تطلب الشركة التجريبية، لذلك أبقِ -e SEED_DEMO_DATA=true في أول تشغيل. تحفظ وحدة التخزين hollina-api-data قاعدة البيانات والملفات المرفوعة بين التشغيلات. إذا كان المنفذ 8000 مشغولًا فغيّر الرقم الذي على يسار -p، مثل -p 8010:8000، وأضف -e PUBLIC_MEDIA_URL=http://localhost:8010/media لتستخدمه عناوين الصور أيضًا. وعندها يجب أن تشير واجهتاك الأماميتان إلى http://localhost:8010/api.

   الطرفيةفي hollina-backendنسخ

   docker run -p 8000:8000 -v hollina-api-data:/data -e SEED_DEMO_DATA=true hollina-api

   0:00 / 0:09

   النتيجة المتوقعة: يجيب localhost:8000/api/healthمحلي بـ "status":"ok" و"database":"up".

   تواجه مشكلة؟

   أنجزت هذه الخطوة

تقبل الحاوية الموقع على http://localhost:3030 ولوحة التحكم على http://localhost:3031. على عناوين أخرى اضبط بـ -e كلًا من CORS_ORIGIN (العنوانان، مفصولان بفاصلة) وFRONTEND_URL (لوحة التحكم) وSITE_URL (الموقع، حيث تعيد معالجة الدفع الضيف). بدون مفاتيح دفع يسوّي المحاكي المرفق كل حجز بالبطاقة أو PayPal.

لتعطي الحاوية مفاتيحك الخاصة (Stripe وPayPal وR2 والذكاء الاصطناعي وMCP)، أنشئ .env من .env.example بالأمر cp .env.example .env، واملأه، وأضف --env-file .env -e NODE_ENV=production إلى docker run:

docker run -p 8000:8000 -v hollina-api-data:/data -e SEED_DEMO_DATA=true --env-file .env -e NODE_ENV=production hollina-api

القيمة المعطاة بـ -e تتغلب على الاسم نفسه في الملف، لذلك تعمل الحاوية في وضع الإنتاج مهما كان في .env، وتنقل المسارات النسبية في الملف (SQLITE_DATABASE وMEDIA_UPLOAD_DIR) إلى وحدة التخزين. بدون JWT_SECRET خاص بك، أو مع القيمة الموجودة في المثال، تولّد الحاوية سرًا وتحفظه في وحدة التخزين، فتبقى تسجيلات الدخول صالحة بعد إعادة التشغيل.

التالي

• اضبط متغيرات البيئة
• استقبل مدفوعات حقيقية
• شغّله من دون Docker
• أصلح مشكلة في الإعداد