أوامر التطوير

تغطي أوامر التطوير سير العمل اليومي — بدء الخدمات، ومراقبة التغييرات، والبناء للإنتاج، وتشغيل الاختبارات، وفرض جودة الكود.

forge serve

بدء خادم تطوير واحد أو أكثر. افتراضياً، تبدأ جميع الخدمات (API، web، admin) معاً، كل منها على منفذه الخاص.

الاستخدام

forge serve [OPTIONS]

الخيارات

الخيار	النوع	الافتراضي	الوصف
--service	string	all	الخدمة للتشغيل: api، web، admin، أو all.
--docker	flag	false	تشغيل الخدمات داخل حاويات Docker بدلاً من محلياً.
--port-api	number	8080	منفذ خادم Rust API.
--port-web	number	3000	منفذ واجهة Next.js الأمامية.
--port-admin	number	3001	منفذ واجهة الإدارة Next.js.

أمثلة

بدء كل شيء:

forge serve

بدء API فقط على منفذ مخصص:

forge serve --service api --port-api 9090

تشغيل جميع الخدمات عبر Docker:

forge serve --docker

نصيحة

عند التشغيل بدون --docker، تأكد من إمكانية الوصول إلى PostgreSQL محلياً. يقرأ FORGE عنوان URL لقاعدة البيانات من .env في جذر المشروع.

---

forge watch

بدء مراقب ملفات يُطلق إعادة البناء عند تغيير المصدر. مفيد عندما تحتاج تحكماً أدق من إعادة التحميل الساخن المُدمجة في forge serve.

الاستخدام

forge watch [OPTIONS]

الخيارات

الخيار	النوع	الافتراضي	الوصف
--target	string	all	هدف المراقبة: api، web، admin، أو all.
--clear	flag	false	مسح الطرفية قبل كل إعادة بناء.
--delay	number	300	تأخير الإلغاء بالمللي ثانية قبل إطلاق إعادة البناء.

أمثلة

# Watch API only with 500ms delay
forge watch --target api --delay 500 --clear

---

forge build

إنشاء بناء مُحسّن للإنتاج لخدمة واحدة أو أكثر.

الاستخدام

forge build [OPTIONS]

الخيارات

الخيار	النوع	الافتراضي	الوصف
--target	string	all	هدف البناء: api، web، admin، أو all.
--release	flag	false	تفعيل تحسينات وضع الإصدار (Rust --release، Next.js production).
--skip-types	flag	false	تخطي فحص أنواع TypeScript أثناء بناء الواجهة الأمامية.
--docker	flag	false	بناء صور Docker بدلاً من الملفات المحلية.

أمثلة

بناء إنتاج كامل:

forge build --release

صور Docker فقط:

forge build --docker --release

تحذير

خيار --skip-types يُعطّل فحوصات TypeScript الصارمة. استخدمه فقط للتكرار السريع — أبداً لبناءات الإنتاج.

---

forge test

تشغيل مجموعة الاختبارات لخدمة واحدة أو أكثر.

الاستخدام

forge test [OPTIONS]

الخيارات

الخيار	النوع	الافتراضي	الوصف
--service	string	all	الخدمة للاختبار: api، web، admin، أو all.
--coverage	flag	false	جمع مقاييس تغطية الكود.

أمثلة

# Run all tests with coverage
forge test --coverage

# Test API only
forge test --service api

---

forge lint

تشغيل المدققات عبر قاعدة الكود. يستخدم clippy لـ Rust و eslint لـ Next.js.

الاستخدام

forge lint [OPTIONS]

الخيارات

الخيار	النوع	الافتراضي	الوصف
--service	string	all	الخدمة للتدقيق: api، web، admin، أو all.
--fix	flag	false	إصلاح المشاكل القابلة للإصلاح تلقائياً.

أمثلة

# Lint everything and auto-fix
forge lint --fix

---

forge format

فحص أو تطبيق تنسيق الكود. يستخدم rustfmt لـ Rust و prettier لـ Next.js.

الاستخدام

forge format [OPTIONS]

الخيارات

الخيار	النوع	الافتراضي	الوصف
--service	string	all	الخدمة للتنسيق: api، web، admin، أو all.
--check	flag	false	الإبلاغ عن مشاكل التنسيق بدون كتابة التغييرات.

أمثلة

# Check formatting without modifying files
forge format --check

# Format admin panel only
forge format --service admin

نصيحة

شغّل forge format --check في CI لضمان تنسيق متسق عبر الفريق.

---

انظر أيضاً

• أوامر المشروع — إنشاء وإدارة المشاريع
• أوامر قاعدة البيانات — الترحيلات والبذر
• أوامر البنية التحتية — Docker، SSL، hosts