متى تُصدّر
هناك أربعة أسباب شائعة لتنزيل ملف ZIP من مشروعك في مايندلاب:
1
مغادرة مايندلاب
تريد امتلاك الكود المُولّد واستضافته بنفسك أو متابعة التطوير خارج المنصّة.
2
التسليم لفريق تطوير
يحتاج مصمّموك أو مهندسوك إلى المصدر الخام لمراجعته أو توسيعه أو دمجه مع الأنظمة القائمة.
3
التطوير المحلّي
تريد تشغيل التطبيق على جهازك الخاص، وربط قاعدة بيانات محلّية، والتكرار دون استهلاك أرصدة البناء.
4
النسخ الاحتياطي
تريد أرشيفًا لكود المشروع في لحظة زمنية محدّدة، مخزّنًا في مكان تتحكّم به.
كيف تُصدّر
1
افتح إعدادات المشروع
انقر على أيقونة الترس في الزاوية العلوية اليمنى من شاشة البناء، أو انتقل إلى إعدادات المشروع من الشريط الأيسر.
2
اذهب إلى تبويب Export
اختر تبويب "Export" في الشريط الجانبي للإعدادات.
3
انقر على Download ZIP
انقر على زرّ Download ZIP. يحزم مايندلاب أحدث لقطة ويقدّم التنزيل فورًا — دون أي انتظار.
يمكنك أيضًا تصدير أي إصدار سابق بفتح سجلّ الإصدارات، واختيار اللقطة التي تريدها، ثم اختيار تصدير هذا الإصدار من قائمة اللقطة.
ما الذي في ملف ZIP
الأرشيف مشروع قائم بذاته بالبنية التالية:
text
your-project-name/
├── frontend/ # React app (Vite)
├── backend/ # FastAPI app
├── migrations/ # Alembic SQL migration files
├── Dockerfile # Multi-stage production image
├── docker-compose.yml # Orchestrates frontend + backend + PostgreSQL
└── .env.example # All required environment variables (no secrets)
ℹملاحظة..env.example يسرد كل متغيّر بيئة مطلوب مع وصف لكلٍّ منه. انسخه إلى .env واملأ قيمك قبل تشغيل التطبيق.
التشغيل محليًا عبر Docker Compose
أسرع طريق إلى نسخة محلّية قيد التشغيل هو Docker Compose. تحتاج إلى تثبيت Docker Desktop (أو Docker Engine مع إضافة Compose).
bash
# 1. Copy environment variables
cp .env.example .env
# Edit .env and fill in required values
# 2. Start all services
docker compose up --build
بعد اكتمال البناء، تتوفّر الواجهة الأمامية على http://localhost:5173 وواجهة برمجة تطبيقات الخادم على http://localhost:8000. تعمل قاعدة بيانات PostgreSQL على المنفذ 5432 (محليًا فقط، وغير مكشوف للعامة).
التشغيل بدون Docker
إن كنت تفضّل تشغيل كل خدمة مباشرةً، فستحتاج إلى Node 20+، وPython 3.11+، وقاعدة بيانات PostgreSQL قيد التشغيل.
bash
# Frontend
cd frontend
npm install
npm run dev
# Backend (in a separate terminal)
cd backend
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload
وجّه متغيّر البيئة DATABASE_URL إلى نسخة PostgreSQL المحلّية لديك، ثم شغّل عمليات الترحيل:
bash
cd backend
alembic upgrade head
الكود ملكك
الكود المُصدَّر من مايندلاب ملكك — لا شرط إسناد، ولا قيد ترخيص، ولا اعتماد على اتصال خارجي. يمكنك تعديله أو بيعه أو فتح مصدره أو تسليمه لعميل دون أي التزام تجاه مايندلاب.
الاستثناء الوحيد هو مكتبات الطرف الثالث المُضمّنة في الكود المُولّد، والتي تحمل تراخيصها مفتوحة المصدر الخاصة بها (MIT، Apache 2.0، إلخ). وهي مدرجة في frontend/package.json وbackend/requirements.txt.