Getting Started

مرحبًا بك في HosteDay 👋

HosteDay هي منصة SaaS لإنشاء Backends وREST APIs جاهزة للعمل خلال دقائق بدون الحاجة لإعداد سيرفرات أو كتابة CRUD يدوي.

بمجرد إنشاء مشروع جديد، تقوم المنصة تلقائيًا بتوفير:

  • REST API جاهز
  • Authentication
  • قاعدة بيانات مستقلة
  • CRUD Endpoints تلقائية
  • API Tester مدمج
  • Runtime Routing
  • Auto HTTPS
  • Isolation لكل مشروع

ما الذي ستبنيه؟

في هذا الدليل ستتعلم كيف:

  1. إنشاء مشروع جديد
  2. إنشاء قاعدة بيانات
  3. توليد API تلقائي
  4. اختبار الـ API
  5. استخدام الـ Token Authentication

إنشاء أول مشروع

بعد تسجيل الدخول إلى لوحة التحكم:

  1. انتقل إلى صفحة Projects
  2. اضغط على Create Project
  3. أدخل اسم المشروع

مثال:

my-first-api

بعد الإنشاء ستقوم HosteDay تلقائيًا بـ:

  • إنشاء بيئة تشغيل مستقلة
  • إنشاء قاعدة بيانات خاصة بالمشروع
  • إعداد الـ API
  • تفعيل HTTPS
  • ربط المشروع بالبنية السحابية

إنشاء أول جدول

انتقل إلى:

Database → Tables

ثم قم بإنشاء جدول جديد.

مثال:

products

إضافة الحقول

أضف الحقول المطلوبة للجدول.

مثال:

Field Type
title string
price integer
description text
image string

بعد الحفظ ستقوم المنصة تلقائيًا بإنشاء:

  • Migration
  • Model
  • Controller
  • API Routes
  • CRUD Endpoints

بدون أي كود يدوي.


الـ API التي تم إنشاؤها

بمجرد إنشاء الجدول تصبح الـ Endpoints جاهزة مباشرة.

إنشاء عنصر جديد

POST /api/products

Request:

{
    "title": "iPhone 15",
    "price": 1200,
    "description": "Apple device"
}

جلب جميع العناصر

GET /api/products

Response:

[
    {
        "id": 1,
        "title": "iPhone 15",
        "price": 1200
    }
]

تحديث عنصر

PUT /api/products/1

حذف عنصر

DELETE /api/products/1

Authentication

توفر HosteDay نظام Authentication مدمج لكل مشروع.

تسجيل الدخول

POST /api/auth/login

Request:

{
    "email": "admin@example.com",
    "password": "password"
}

Response:

{
    "token": "YOUR_ACCESS_TOKEN"
}

استخدام الـ Token

قم بإرسال الـ Token داخل Header:

Authorization: Bearer YOUR_ACCESS_TOKEN

اختبار الـ API

توفر المنصة API Tester مدمج يسمح لك بـ:

  • إرسال الطلبات مباشرة
  • عرض Responses
  • اختبار Authentication
  • نسخ Request Headers
  • تحويل الاستجابة إلى Flutter/Dart Code

Runtime Dynamic Routing

تعتمد HosteDay على Dynamic Runtime Routing مما يسمح بـ:

  • تعديل الـ Routes مباشرة
  • إضافة Endpoints جديدة
  • تحديث الـ Controllers
  • تطبيق التغييرات فورًا

بدون إعادة تشغيل السيرفر.


العزل والحماية

كل مشروع داخل HosteDay يعمل داخل بيئة معزولة بالكامل:

  • Docker Container مستقل
  • قاعدة بيانات مستقلة
  • مستخدم Database منفصل
  • HTTPS تلقائي
  • Token Protection
  • Runtime Isolation

النسخ الاحتياطي

توفر المنصة نظام Backup تلقائي يدعم:

  • النسخ اليومية
  • النسخ الأسبوعية
  • Backup لقواعد البيانات
  • Backup للملفات
  • Restore سريع

الخطوة التالية

يمكنك الآن متابعة الأدلة التالية:

  • What is HosteDay
  • Generate First API
  • Authentication
  • API Testing
  • Dynamic Endpoints
  • Multi-Tenant Architecture
  • Backups
  • Security

لماذا HosteDay؟

HosteDay ليست مجرد CRUD Generator، بل منصة متكاملة لبناء وتشغيل APIs مع:

  • Multi-Tenant Architecture
  • Docker Isolation
  • Dynamic Runtime APIs
  • Auto HTTPS
  • Distributed Infrastructure
  • Horizontal Scaling
  • Built-in API Engine

مما يسمح لك ببناء Backend Production-Ready خلال دقائق بدل ساعات أو أيام.