المستنداتمتقدمإعداد المطورين

إعداد المطورين

أعدّ قاعدة كود Draftly محليًا للتطوير أو الاستضافة الذاتية.

المتطلبات المسبقة

لتشغيل Draftly محليًا تحتاج: - Node.js 18+ مع npm أو pnpm - مشروع Firebase ‏(مع تفعيل Firestore وAuth وStorage) - مفاتيح API: ‏Google Gemini، وFal.ai (اختياري)، وAPI-Easy (لفيديو Veo وصور Nano Banana) - حساب Dodo Payments (لويب هوك الفوترة — اختياري للتطوير)

الاستنساخ والتثبيت

bash

git clone https://github.com/draftly-space/draftly-client.git
cd draftly-client
npm install
cp .env.example .env.local

عدّل .env.local بإعدادات Firebase ومفاتيح API الخاصة بك، ثم شغّل خادم التطوير.

متغيرات البيئة

المتغير	الوصف	مطلوب
`GOOGLE_AI_KEY`	مفتاح Gemini API لتوليد HTML الموقع	نعم
`NEXT_PUBLIC_FIREBASE_*`	إعدادات عميل Firebase ‏(6 متغيرات)	نعم
`FIREBASE_SERVICE_ACCOUNT`	‏Firebase Admin SDK JSON ‏(base64)	نعم
`FAL_KEY`	‏Fal.ai — صور Seedream، تمديد فيديو LTX	للوسائط الكاملة
`APIEASY_KEY`	‏API-Easy — فيديو Veo 3.1، صور Nano Banana	للفيديو
`DODO_PAYMENTS_KEY`	سر ويب هوك فوترة Dodo Payments	للفوترة
`CLOUDFLARE_ZONE_ID`	منطقة Cloudflare لتطهير ذاكرة CDN عند النشر	لـ CDN

تشغيل خادم التطوير

bash

npm run dev

افتح http://localhost:3000. منشئ 3D على http://localhost:3000/3d-builder.

السابقمفتاح API مخصص