Skip to content

القوالب المتوفرة

يوفر FORGE مجموعة من القوالب الجاهزة للاستخدام لتسريع تطوير أنواع مختلفة من التطبيقات.

نظرة عامة على القوالب

┌─────────────────────────────────────────────────────────────────┐
│                      القوالب المتوفرة                           │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐       │
│  │   CRM    │  │ Helpdesk │  │Appointment│  │Invoicing │       │
│  │  إدارة   │  │  الدعم   │  │  الحجز   │  │ الفوترة  │       │
│  │ العملاء  │  │  الفني   │  │          │  │          │       │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘       │
│                                                                 │
│  ┌──────────┐  ┌──────────┐                                    │
│  │Inventory │  │Subscript.│                                    │
│  │ المخزون  │  │الاشتراكات│                                    │
│  └──────────┘  └──────────┘                                    │
│                                                                 │
│  جميع القوالب ترث من: القالب الأساسي (base)                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

1. قالب CRM (إدارة علاقات العملاء)

نظام متكامل لإدارة العملاء والمبيعات.

الميزات

الميزةالوصف
العملاء المحتملونتتبع العملاء المحتملين وتحويلهم
جهات الاتصالإدارة بيانات التواصل
الشركاتربط جهات الاتصال بالشركات
الصفقاتتتبع فرص المبيعات
المهامجدولة المتابعات
الملاحظاتتوثيق التفاعلات
قمع المبيعاتتصور مراحل البيع

النماذج

yaml
models:
  - Lead           # Potential customers
  - Contact        # Contacts
  - Company        # Companies
  - Deal           # Deals
  - DealStage      # Deal stages
  - Task           # Tasks
  - Note           # Notes
  - Activity       # Activities

مخطط قاعدة البيانات

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Company   │────▶│   Contact   │────▶│    Lead     │
└─────────────┘     └─────────────┘     └─────────────┘
       │                   │                   │
       │                   ▼                   │
       │            ┌─────────────┐            │
       └───────────▶│    Deal     │◀───────────┘
                    └─────────────┘

              ┌────────────┼────────────┐
              ▼            ▼            ▼
       ┌──────────┐ ┌──────────┐ ┌──────────┐
       │   Task   │ │   Note   │ │ Activity │
       └──────────┘ └──────────┘ └──────────┘

الاستخدام

bash
forge new my-crm --template crm

نقاط النهاية

POST   /api/admin/leads              # إنشاء عميل محتمل
GET    /api/admin/leads              # قائمة العملاء المحتملين
POST   /api/admin/leads/{id}/convert # تحويل إلى جهة اتصال
GET    /api/admin/deals              # قائمة الصفقات
PUT    /api/admin/deals/{id}/stage   # تحديث مرحلة الصفقة
GET    /api/admin/pipeline           # قمع المبيعات
GET    /api/admin/reports/sales      # تقارير المبيعات

2. قالب Helpdesk (نظام الدعم الفني)

نظام تذاكر الدعم الفني للعملاء.

الميزات

الميزةالوصف
التذاكرإنشاء وتتبع تذاكر الدعم
الأولوياتعاجل، عالي، متوسط، منخفض
الحالاتجديد، مفتوح، قيد العمل، مغلق
التصنيفاتتنظيم التذاكر بالفئات
الإسنادتعيين التذاكر للوكلاء
الردودسلاسل المحادثات
قاعدة المعرفةمقالات المساعدة الذاتية
SLAاتفاقيات مستوى الخدمة

النماذج

yaml
models:
  - Ticket              # Tickets
  - TicketReply         # Replies
  - TicketCategory      # Categories
  - TicketPriority      # Priorities
  - TicketStatus        # Statuses
  - KnowledgeBase       # Knowledge base
  - KBCategory          # KB categories
  - SLAPolicy           # SLA policies

سير العمل

┌─────────────────────────────────────────────────────────────────┐
│                    سير عمل التذكرة                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌────────┐    ┌────────┐    ┌────────┐    ┌────────┐         │
│  │ جديد   │───▶│ مفتوح  │───▶│ قيد    │───▶│ مغلق   │         │
│  │  New   │    │  Open  │    │ العمل  │    │ Closed │         │
│  └────────┘    └────────┘    └────────┘    └────────┘         │
│       │              │              │              │            │
│       │              │              │              │            │
│       ▼              ▼              ▼              ▼            │
│  ┌─────────────────────────────────────────────────┐           │
│  │              إشعارات تلقائية                     │           │
│  │  - البريد الإلكتروني                            │           │
│  │  - إشعارات داخل التطبيق                         │           │
│  └─────────────────────────────────────────────────┘           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

الاستخدام

bash
forge new my-helpdesk --template helpdesk

نقاط النهاية

# التذاكر
POST   /api/tickets                  # إنشاء تذكرة (عام)
GET    /api/admin/tickets            # قائمة التذاكر
PUT    /api/admin/tickets/{id}       # تحديث التذكرة
POST   /api/admin/tickets/{id}/reply # إضافة رد
PUT    /api/admin/tickets/{id}/assign # إسناد لوكيل

# قاعدة المعرفة
GET    /api/kb/articles              # المقالات العامة
GET    /api/kb/search                # البحث
GET    /api/admin/kb/articles        # إدارة المقالات

3. قالب Appointment (نظام الحجز)

نظام جدولة وحجز المواعيد.

الميزات

الميزةالوصف
الخدماتتعريف الخدمات المتاحة
مقدمو الخدمةإدارة الموظفين
المواعيدحجز وإلغاء المواعيد
التقويمعرض الجدول الزمني
التوفرإعداد أوقات العمل
التذكيراتإشعارات تلقائية
الدفعتكامل مع بوابات الدفع

النماذج

yaml
models:
  - Service           # Services
  - Provider          # Service providers
  - Appointment       # Appointments
  - TimeSlot          # Time slots
  - Availability      # Availability
  - Booking           # Bookings
  - Reminder          # Reminders

التقويم

┌─────────────────────────────────────────────────────────────────┐
│                       يناير 2025                                │
├─────────────────────────────────────────────────────────────────┤
│  الأحد   الإثنين   الثلاثاء   الأربعاء   الخميس   الجمعة   السبت │
├─────────────────────────────────────────────────────────────────┤
│                              1         2         3         4    │
│                           [محجوز]   [متاح]    [متاح]   [عطلة]  │
├─────────────────────────────────────────────────────────────────┤
│    5         6         7         8         9        10        11│
│ [عطلة]   [متاح]    [متاح]   [محجوز]   [متاح]    [عطلة]  [عطلة] │
└─────────────────────────────────────────────────────────────────┘

الاستخدام

bash
forge new my-booking --template appointment

نقاط النهاية

# الخدمات
GET    /api/services                 # الخدمات المتاحة
GET    /api/services/{id}/providers  # مقدمو الخدمة

# التوفر
GET    /api/availability             # الأوقات المتاحة
GET    /api/providers/{id}/slots     # فترات المزود

# الحجوزات
POST   /api/bookings                 # إنشاء حجز
GET    /api/bookings/{id}            # تفاصيل الحجز
DELETE /api/bookings/{id}            # إلغاء الحجز

# لوحة التحكم
GET    /api/admin/appointments       # جميع المواعيد
PUT    /api/admin/appointments/{id}  # تحديث الموعد

4. قالب Invoicing (نظام الفوترة)

نظام إنشاء وإدارة الفواتير.

الميزات

الميزةالوصف
العملاءإدارة بيانات العملاء
المنتجاتكتالوج المنتجات والخدمات
الفواتيرإنشاء وإرسال الفواتير
عروض الأسعارعروض قابلة للتحويل
المدفوعاتتتبع المدفوعات
الضرائبحساب الضرائب
القوالبقوالب PDF مخصصة

النماذج

yaml
models:
  - Client            # Clients
  - Product           # Products
  - Invoice           # Invoices
  - InvoiceItem       # Invoice items
  - Quote             # Quotes
  - Payment           # Payments
  - Tax               # Taxes
  - InvoiceTemplate   # Invoice templates

حالات الفاتورة

┌─────────────────────────────────────────────────────────────────┐
│                      حالات الفاتورة                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌────────┐    ┌────────┐    ┌────────┐    ┌────────┐         │
│  │ مسودة  │───▶│ مرسلة  │───▶│ مدفوعة │    │ ملغاة  │         │
│  │ Draft  │    │  Sent  │    │  Paid  │    │Cancelled│         │
│  └────────┘    └────────┘    └────────┘    └────────┘         │
│                      │              ▲                           │
│                      │              │                           │
│                      ▼              │                           │
│                ┌────────┐    ┌─────┴────┐                      │
│                │ متأخرة │───▶│ مدفوعة   │                      │
│                │Overdue │    │ جزئياً   │                      │
│                └────────┘    └──────────┘                      │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

الاستخدام

bash
forge new my-invoicing --template invoicing

نقاط النهاية

# العملاء
GET    /api/admin/clients            # قائمة العملاء
POST   /api/admin/clients            # إنشاء عميل

# الفواتير
GET    /api/admin/invoices           # قائمة الفواتير
POST   /api/admin/invoices           # إنشاء فاتورة
GET    /api/admin/invoices/{id}/pdf  # تحميل PDF
POST   /api/admin/invoices/{id}/send # إرسال بالبريد

# المدفوعات
POST   /api/admin/invoices/{id}/payment # تسجيل دفعة
GET    /api/admin/payments           # جميع المدفوعات

# عروض الأسعار
POST   /api/admin/quotes             # إنشاء عرض
POST   /api/admin/quotes/{id}/convert # تحويل لفاتورة

5. قالب Inventory (إدارة المخزون)

نظام إدارة المخزون والمستودعات.

الميزات

الميزةالوصف
المنتجاتكتالوج المنتجات
المستودعاتمواقع التخزين المتعددة
المخزونتتبع الكميات
الحركاتاستلام وصرف
التحويلاتنقل بين المستودعات
الجردعمليات الجرد
التنبيهاتتنبيهات نقص المخزون

النماذج

yaml
models:
  - Product           # Products
  - Category          # Categories
  - Warehouse         # Warehouses
  - Stock             # Stock
  - StockMovement     # Stock movements
  - Transfer          # Transfers
  - Inventory         # Inventory
  - Supplier          # Suppliers
  - PurchaseOrder     # Purchase orders

حركات المخزون

┌─────────────────────────────────────────────────────────────────┐
│                      حركات المخزون                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────────┐                      ┌──────────────┐        │
│  │   استلام    │ ────────────────────▶ │   المخزون   │        │
│  │   Receive   │        +qty           │    Stock     │        │
│  └──────────────┘                      └──────────────┘        │
│                                               │                 │
│                                               │ -qty            │
│                                               ▼                 │
│  ┌──────────────┐                      ┌──────────────┐        │
│  │    صرف     │ ◀──────────────────── │   المخزون   │        │
│  │   Issue    │                       │    Stock     │        │
│  └──────────────┘                      └──────────────┘        │
│                                                                 │
│  ┌──────────────┐     تحويل          ┌──────────────┐        │
│  │  مستودع A  │ ────────────────────▶ │  مستودع B  │        │
│  │ Warehouse A │                      │ Warehouse B │        │
│  └──────────────┘                      └──────────────┘        │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

الاستخدام

bash
forge new my-inventory --template inventory

نقاط النهاية

# المنتجات
GET    /api/admin/products           # قائمة المنتجات
POST   /api/admin/products           # إنشاء منتج

# المخزون
GET    /api/admin/stock              # مستويات المخزون
GET    /api/admin/stock/low          # منتجات ناقصة
POST   /api/admin/stock/receive      # استلام مخزون
POST   /api/admin/stock/issue        # صرف مخزون

# التحويلات
POST   /api/admin/transfers          # إنشاء تحويل
PUT    /api/admin/transfers/{id}     # تحديث التحويل

# الجرد
POST   /api/admin/inventory          # بدء جرد
PUT    /api/admin/inventory/{id}     # تحديث الجرد
POST   /api/admin/inventory/{id}/complete # إتمام الجرد

6. قالب Subscriptions (الاشتراكات)

نظام إدارة الاشتراكات والدفع المتكرر.

الميزات

الميزةالوصف
الخططتعريف خطط الاشتراك
الاشتراكاتإدارة اشتراكات العملاء
الفواتيرفوترة تلقائية
الدفعتكامل مع Stripe
الترقيةتغيير الخطط
الإلغاءسياسات الإلغاء
التجاربفترات تجريبية

النماذج

yaml
models:
  - Plan              # Plans
  - PlanFeature       # Plan features
  - Subscription      # Subscriptions
  - SubscriptionItem  # Subscription items
  - Invoice           # Invoices
  - Payment           # Payments
  - UsageRecord       # Usage records

دورة الاشتراك

┌─────────────────────────────────────────────────────────────────┐
│                      دورة الاشتراك                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌────────┐    ┌────────┐    ┌────────┐    ┌────────┐         │
│  │ تجربة  │───▶│ نشط   │───▶│ متأخر  │───▶│ ملغى   │         │
│  │ Trial  │    │ Active │    │Past Due│    │Canceled │         │
│  └────────┘    └────────┘    └────────┘    └────────┘         │
│       │              │              │                           │
│       │              │              │                           │
│       │              ▼              │                           │
│       │        ┌────────┐          │                           │
│       └───────▶│ ملغى   │◀─────────┘                           │
│                │Canceled │                                      │
│                └────────┘                                       │
│                                                                 │
│  الفوترة التلقائية:                                             │
│  ┌─────────┐    ┌─────────┐    ┌─────────┐                     │
│  │ الشهر 1 │───▶│ الشهر 2 │───▶│ الشهر 3 │───▶ ...            │
│  │  فاتورة │    │  فاتورة │    │  فاتورة │                     │
│  └─────────┘    └─────────┘    └─────────┘                     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

الاستخدام

bash
forge new my-saas --template subscriptions

نقاط النهاية

# الخطط (عام)
GET    /api/plans                    # الخطط المتاحة

# الاشتراكات
POST   /api/subscriptions            # إنشاء اشتراك
GET    /api/subscriptions/current    # الاشتراك الحالي
PUT    /api/subscriptions/upgrade    # ترقية الخطة
PUT    /api/subscriptions/downgrade  # تخفيض الخطة
DELETE /api/subscriptions            # إلغاء الاشتراك

# الدفع
POST   /api/subscriptions/payment-method # تحديث طريقة الدفع
GET    /api/invoices                 # فواتير المستخدم

# لوحة التحكم
GET    /api/admin/subscriptions      # جميع الاشتراكات
GET    /api/admin/mrr                # الإيراد الشهري المتكرر
GET    /api/admin/churn              # معدل الإلغاء

مقارنة القوالب

القالبالجداولنقاط النهايةحالات الاستخدام
Base1735+أساس لأي مشروع
CRM2550+إدارة المبيعات
Helpdesk2245+دعم العملاء
Appointment2040+حجز المواعيد
Invoicing1835+الفوترة
Inventory2348+إدارة المخزون
Subscriptions1938+SaaS

دمج القوالب

يمكنك دمج ميزات من قوالب متعددة:

bash
# Create project with base template
forge new my-project

# Add CRM features
forge template add crm --features leads,deals

# Add invoicing features
forge template add invoicing --features invoices,payments

المزيد من المعلومات

Released under the MIT License.