مصمم العروض

مصمم العروض في Doggy هو أداة مرئية لتخطيط الصفحات، ويدعم التصميم بالسحب والإفلات وربط مصادر البيانات والمعاينة الفورية والتعزيز بالذكاء الاصطناعي وإدارة الإصدارات.

نظرة عامة

يعتمد نظام العروض على الكيانات التالية (src/Entity/Platform/):

• View.php: تعريف العرض (تكوين التخطيط، مصدر البيانات، معلومات الإصدار)
• ViewField.php: تكوين كل حقل داخل العرض

نقطة دخول الإدارة في App\Controller\Admin\Platform\ViewEditorController، ونقطة دخول API في ViewEditorApiController.

بنية العرض

View
├── 布局配置（栅格行/列）
├── 字段绑定（ViewField）
│   ├── 数据表格
│   ├── 表单
│   ├── 统计卡片
│   └── 文本内容
├── 数据源配置
└── 版本目录（1_0/, 2_0/...）

طريقة الاستخدام

1. ادخل إلى منصة منخفضة الكود ← إدارة العروض (/admin/platform/view)
2. انقر إنشاء عرض جديد
3. حرّر تخطيط العرض (editor.html.twig)
4. هيّئ خصائص المكوّنات ومصادر البيانات
5. معاينة النتيجة (editor_section_properties.html.twig)
6. احفظ وانشر

التعزيز بالذكاء الاصطناعي

يتكامل محرر العرض بعمق مع AI 助手:

• لوحة AI العائمة: تفتح عبر الزر العائم في الزاوية السفلية لجميع الصفحات
• تسجيل السياق: يسجل المحرر سياق view_editor تلقائيًا
• العمليات باللغة الطبيعية: "غيّر هذا النص إلى نمط عنوان"
• استدعاء الأدوات: view.getInfo، view.updateSectionConfig، view.updateFieldConfig، view.listEntityFields
• التعرف على النية + الوكلاء الفرعيون: إنشاء عروض نماذج/تقارير/صفحات هبوط وغيرها بنقرة واحدة (انظر AI 视图增强)

كما يدعم مساعدة تخطيط Tailwind CSS (استنادًا إلى وقت تشغيل Twind):

• تخطيط سريع: flex/grid/المسافات/العرض والارتفاع وغيرها من class utility
• التعايش مع الأنماط المضمنة inline style الحالية دون تعارض
• تحميل الواجهة الأمامية للإنتاج عند الحاجة دون خطوة بناء

ربط مصادر البيانات

يتم تكوين مصدر بيانات العرض عبر كيان DataSource.php، ويدعم:

• مصدر بيانات الكيان: ربط بيانات النموذج الديناميكي
• مصدر بيانات API: استدعاء واجهات API مخصصة
• مصدر بيانات ثابت: بيانات ثابتة

توليد الكود

بعد حفظ العرض، يولّد النظام ملفات قوالب Twig المقابلة في دليل templates/views/:

templates/views/
├── hello/
│   └── 1_0/
│       ├── hello.html.twig
│       └── hello.design.twig
└── 组织架构/
    └── post_management/
        └── 1_0/
            ├── post_management.html.twig
            └── post_management.design.twig

يمكن استخدام القوالب المولّدة مباشرة أو تطويرها ثانويًا.

إدارة الإصدارات

يدعم العرض إدارة متعددة الإصدارات (يقابل كل إصدار مجموعة مستقلة من ملفات twig):

• تبديل الإصدار: تفعيل إصدار كالإصدار الحالي
• إضافة إصدار: النسخ من الإصدار الحالي أو إنشاء إصدار فارغ جديد
• حذف العرض يرسله إلى سلة المهملات (قابل للاستعادة)
• يعمل المحرر حسب الإصدار، مع إمكانية التحديد الصريح عبر ?version=...

الخدمات ذات الصلة

• FormFieldBuilderService.php: بناء حقول النماذج
• ViewFolderType.php، ViewType.php: تعريف أنواع النماذج
• AiChatController.php: واجهة محادثة AI
• ViewAiTaskApiController.php: واجهة مهام التعزيز بالذكاء الاصطناعي