خارطة الطريق
تتتبع هذه الصفحة حالة التطوير الحالية، والميزات المكتملة، والعمل الجاري، والرؤية طويلة المدى لـ FORGE. المشروع في مرحلة تطوير مبكرة -- الأمور تتحرك بسرعة.
الإصدار الحالي
FORGE v0.1.0 -- تطوير مبكر
التقدم العام: ================--------- ~70%
المرحلة 1: أساس CLI ==================== 100%
المرحلة 2: خلفية Rust ==================== 100%
المرحلة 3: واجهة Next.js ==================== 100%
المرحلة 4: ميزات موسعة ==================== 100%
المرحلة 5: خلفيات إضافية -------------------- 0%
المرحلة 6: واجهات إضافية -------------------- 0%دليل الحالة
| الشارة | المعنى |
|---|---|
| مُطلق | مكتمل، ومختبر، ومتوفر في الإصدار الحالي |
| قيد التنفيذ | يتم تطويره بنشاط |
| مخطط | مصمم ومجدول لإصدار مستقبلي |
| استكشاف | قيد البحث؛ الجدول الزمني والجدوى سيُحددان |
مُطلق
هذه الميزات مُنفذة بالكامل، ومختبرة، وجزء من كل مشروع مولّد.
أساس CLI
| الميزة | الوصف |
|---|---|
| إنشاء المشروع | forge new يولّد مشاريع full-stack كاملة |
| إدارة المضيفين | forge hosts:add/remove يدير إدخالات /etc/hosts |
| شهادات SSL | forge ssl:install/generate/trust لـ HTTPS المحلي عبر mkcert |
| تكوين Docker | docker-compose.yml مولّد مع PostgreSQL, Redis, Caddy |
| محرك توليد الكود | تقديم قوالب Tera مع سياق المشروع |
الخلفية (Rust + Axum)
| الميزة | الوصف |
|---|---|
| المصادقة | JWT مع رموز وصول/تجديد، تسجيل الدخول، التسجيل، إعادة تعيين كلمة المرور |
| دعم OTP | مصادقة كلمة المرور لمرة واحدة عبر الهاتف |
| RBAC | التحكم في الوصول المستند إلى الأدوار مع صلاحيات دقيقة |
| إدارة المستخدمين | CRUD كامل مع حذف ناعم، تعيين الأدوار |
| إدارة الأدوار | إنشاء وتحرير وحذف الأدوار مع تعيين الصلاحيات |
| نظام CMS | صفحات محتوى مع ترجمات JSONB، SEO، نص غني |
| نظام القوائم | تنقل هرمي مع تحكم بالرؤية |
| إدارة الوسائط | رفع ملفات متعدد الأشكال، متغيرات الصور، تخزين S3/محلي |
| الإعدادات | إعدادات مفتاح-قيمة مع تشفير للبيانات الحساسة |
| تعدد اللغات | اللغات، الترجمات، كشف اللغة لكل طلب |
| توثيق API | مواصفات OpenAPI مولّدة تلقائياً مع Swagger UI و ReDoc |
| API الملف الشخصي | عرض/تحرير ملف المستخدم، رفع الصورة الرمزية، تغيير كلمة المرور |
| طبقة قاعدة البيانات | SQLx مع الترحيلات، البيانات الأولية، مفاتيح UUID أساسية |
الواجهة الأمامية (Next.js)
| الميزة | الوصف |
|---|---|
| لوحة التحكم الإدارية | إحصائيات، صفحات إدارة المستخدم/الدور/الصلاحية |
| إدارة المحتوى | إنشاء وتحرير وعرض وحذف المحتوى مع محرر نص غني |
| إدارة القوائم | إدارة عناصر القائمة مع تسلسل أب/ابن هرمي |
| تطبيق الويب | صفحات عامة، محتوى ديناميكي، تدفقات المصادقة |
| i18n | واجهة متعددة اللغات مع دعم RTL، تبديل اللغة |
| تدفقات المصادقة | تسجيل الدخول، التسجيل، نسيت/إعادة تعيين كلمة المرور، تحقق OTP |
| صفحات الملف الشخصي | عرض/تحرير الملف، تغيير كلمة المرور، رفع الصورة الرمزية |
| التنقل الديناميكي | قوائم معروضة من الخادم مع تصفية الرؤية |
| مكتبة المكونات | مكونات shadcn/ui مع Tailwind CSS |
| جلب البيانات | TanStack Query لإدارة حالة الخادم |
البنية التحتية
| الميزة | الوصف |
|---|---|
| Docker Compose | تكوينات التطوير والإنتاج |
| Caddy Reverse Proxy | HTTPS تلقائي، توجيه النطاقات الفرعية |
| SSL المحلي | شهادات موثوقة عبر mkcert |
قيد التنفيذ
هذه الميزات يتم تطويرها بنشاط.
جداول البحث
بيانات مرجعية قابلة للتكوين (الدول، الحالات، الفئات) مخزنة في جدول lookups واحد مع دعم هرمي وترجمات.
الحالة: ================--------- ~80%
[x] ترحيل قاعدة البيانات والنموذج
[x] نقاط نهاية CRUD الخلفية
[x] صفحات الإدارة (قائمة، إنشاء، تحرير)
[ ] تكامل API العام
[ ] مكون القائمة المنسدلة للواجهةتسجيل التدقيق
تتبع شامل للنشاط لجميع عمليات الإدارة.
الحالة: ==============----------- ~70%
[x] مخطط قاعدة البيانات (جدول audit_logs)
[x] وسيط خلفي للتسجيل التلقائي
[x] عارض سجل التدقيق للإدارة
[ ] وظيفة التصدير (CSV/JSON)
[ ] التصفية حسب نطاق التاريخ
[ ] جدول زمني للنشاط الخاص بالمستخدممفاتيح API
إدارة مفاتيح API للأطراف الثالثة مع تحديد المعدل والإلغاء.
الحالة: =============----------- ~65%
[x] مخطط قاعدة البيانات (جدول api_keys)
[x] توليد المفاتيح والتجزئة
[x] وسيط لمصادقة مفتاح API
[ ] صفحات إدارة المسؤول
[ ] تطبيق تحديد المعدل
[ ] لوحة تحليلات الاستخداممخطط
هذه الميزات مصممة وسيتم تنفيذها في الإصدارات القادمة.
قوالب إضافية
القوالب تضيف ميزات خاصة بالمجال فوق التطبيق الأساسي.
| القالب | الوصف | الأولوية |
|---|---|---|
| CRM | جهات الاتصال، الشركات، الصفقات، خطوط الأنابيب، النشاطات | عالية |
| Helpdesk | التذاكر، SLAs، قاعدة المعرفة، بوابة العملاء | عالية |
| Invoicing | الفواتير، المدفوعات، إدارة الضرائب، توليد PDF | متوسطة |
| Blog | المقالات، الفئات، الوسوم، التعليقات، موجز RSS | متوسطة |
| E-Commerce | المنتجات، السلة، الدفع، إدارة الطلبات | منخفضة |
كل قالب يتبع عقد القالب ويتضمن:
- ترحيلات قاعدة البيانات
- نماذج ومعالجات ومسارات الخلفية
- صفحات لوحة تحكم الإدارة
- صفحات تطبيق الويب
- بيانات أولية للصلاحيات
- بيانات أولية للترجمات
تكاملات المزودين
مزودي خدمات قابلين للتبديل لاحتياجات البنية التحتية الشائعة.
| الفئة | المزودون | الحالة |
|---|---|---|
| SMS | Twilio, Vonage, Unifonic, MessageBird | مخطط |
| SMTP, SendGrid, Mailgun, AWS SES | مخطط | |
| Storage | محلي, AWS S3, MinIO, Google Cloud Storage | مخطط |
| Payments | Stripe, HyperPay, PayTabs, Checkout.com | مخطط |
عقود المزودين
كل مزود ينفذ عقداً مشتركاً (واجهة)، لذا التبديل من مزود لآخر هو تغيير تكوين -- وليس تغيير كود. انظر نمط المزود للتفاصيل.
تحسينات CLI
| الميزة | الوصف |
|---|---|
forge add:template | تثبيت قالب في مشروع موجود |
forge add:provider | إضافة تكامل مزود (SMS، email، إلخ.) |
forge generate:model | توليد نموذج جديد مع ترحيل ومعالج ومسارات |
forge generate:crud | توليد CRUD كامل لكيان مخصص |
forge validate | التحقق من الكود المولّد مقابل العقود |
forge update | تطبيق تغييرات القوالب الأصلية على المشاريع الموجودة |
استكشاف
هذه أفكار قيد البحث. الجدول الزمني والجدوى لم يُحددا بعد.
خلفيات إضافية
| الخلفية | اللغة | الإطار | ملاحظات |
|---|---|---|---|
| Laravel | PHP | Laravel 11+ | نفس عقود API، لغة مختلفة |
| FastAPI | Python | FastAPI + SQLAlchemy | لفرق نظام Python البيئي |
| Node.js | TypeScript | NestJS أو Hono | لفرق نظام JavaScript البيئي |
WARNING
الخلفيات الإضافية ستولّد نفس نقاط نهاية API بالضبط مع نفس صيغ الاستجابة، وتدفق المصادقة، ورموز الأخطاء. التصميم القائم على العقود يضمن أن تطبيقات الواجهة تعمل بشكل متطابق بغض النظر عن الخلفية العاملة.
واجهات إضافية
| الواجهة | الإطار | ملاحظات |
|---|---|---|
| Nuxt.js | Vue 3 + Nuxt 3 | بديل نظام Vue البيئي |
| Angular | Angular 17+ | خيار موجه للمؤسسات |
| Vanilla | HTML + CSS + JS | بدون إطار، مواقع ثابتة |
الرؤية طويلة المدى
┌───────────────────────────────────────────────────────────────────────┐
│ رؤية FORGE طويلة المدى │
├───────────────────────────────────────────────────────────────────────┤
│ │
│ سوق القوالب │
│ سجل عام حيث ينشر المطورون ويثبتون القوالب. │
│ قوالب مساهمة من المجتمع لحالات استخدام متخصصة (عيادات، │
│ مدارس، عقارات، إلخ.). │
│ │
│ باني مرئي │
│ واجهة مستخدم في المتصفح لتصميم التطبيقات. اختر الخلفية، │
│ الواجهة، القوالب، والمزودين بصرياً. كوّن النماذج │
│ والعلاقات بالسحب والإفلات. ولّد الكود بنقرة واحدة. │
│ │
│ نشر السحابة │
│ نشر بأمر واحد لمزودي السحابة: │
│ forge deploy:aws - نشر إلى AWS (ECS, RDS, S3) │
│ forge deploy:gcp - نشر إلى Google Cloud (Cloud Run, SQL) │
│ forge deploy:do - نشر إلى DigitalOcean (App Platform) │
│ forge deploy:railway - نشر إلى Railway │
│ │
│ نظام الإضافات │
│ بنية إضافات تسمح للمطورين بتوسيع FORGE دون تعديل │
│ النواة. يمكن للإضافات إضافة أوامر وقوالب ومزودين │
│ ومولّدات. │
│ │
│ محرك الترقية │
│ نظام ترقية ذكي يطبق تغييرات القوالب الأصلية │
│ على المشاريع الموجودة مع الحفاظ على التعديلات المخصصة. │
│ دمج ثلاثي بين القالب القديم والقالب الجديد وكود المستخدم. │
│ │
│ دعم قواعد بيانات متعددة │
│ دعم MySQL وSQLite وMongoDB بالإضافة إلى PostgreSQL. │
│ كل مولد خلفية ينتج الاستعلامات المناسبة وصيغة │
│ الترحيل. │
│ │
└───────────────────────────────────────────────────────────────────────┘الجدول الزمني للإصدارات
التالي جدول زمني تقديري، وليس التزاماً. قد تتغير التواريخ بناءً على ملاحظات المجتمع وتوفر المساهمين.
| الإصدار | الهدف | الميزات الرئيسية |
|---|---|---|
| v0.1.0 | الربع الأول 2026 | أساس CLI، خلفية Rust، واجهة Next.js، القالب الأساسي |
| v0.2.0 | الربع الثاني 2026 | جداول البحث، تسجيل التدقيق، مفاتيح API، عقود المزودين |
| v0.3.0 | الربع الثالث 2026 | قالب CRM، مزودي SMS/email، أوامر forge add |
| v0.4.0 | الربع الرابع 2026 | قالب Helpdesk، مزودي التخزين، مزودي الدفع |
| v1.0.0 | 2027 | API مستقر، خلفيات متعددة، سوق القوالب |
DANGER
FORGE برنامج ما قبل 1.0. واجهات API وهيكل الكود المولّد قد يتغيران بين الإصدارات الثانوية. ثبّت إصدار FORGE في مشاريع الإنتاج وراجع سجلات التغييرات قبل الترقية.
كيفية المساهمة
FORGE مفتوح المصدر ويرحب بمساهمات من جميع الأنواع:
- أبلغ عن الأخطاء -- قدّم مشكلة مع خطوات إعادة الإنتاج
- اقترح ميزات -- افتح نقاشاً مع حالة استخدامك
- قدّم كوداً -- انظر دليل المساهمة لتعليمات الإعداد
- اكتب التوثيق -- حسّن موقع التوثيق هذا
- أنشئ قوالب -- ابنِ قوالب خاصة بالمجال للمجتمع
- اختبر وقدّم ملاحظات -- جرّب FORGE على مشاريع حقيقية وشارك تجربتك
قرارات الهندسة
قرارات هندسية رئيسية توجه التطوير:
| القرار | المبرر |
|---|---|
| القائم على العقود | يتيح تبادل الخلفية/الواجهة |
| قوالب Tera | يولّد كود نظيف وأصيل (ليس تجميع سلاسل) |
| مفاتيح UUID أساسية | لا تخمين معرف تسلسلي، آمن للأنظمة الموزعة |
| ترجمات JSONB | نمط جدول واحد، لا عبء join، مخطط مرن |
| وسائط متعددة الأشكال | جدول وسائط واحد يخدم جميع النماذج بدون أعمدة مفاتيح أجنبية |
| تطبيقات admin/web منفصلة | نشر مستقل، تدفقات مصادقة مختلفة، كود أنظف |
| monorepo workspace | أنواع مشتركة بين الصناديق، خط بناء واحد |
انظر أيضاً
- المقدمة -- ما هو FORGE ولماذا يوجد
- المساهمة -- كيف تساهم في المشروع
- نظام القوالب -- كيف يعمل محرك القوالب
- نمط المزود -- تصميم مزود الخدمة القابل للتبديل