النموذج الديناميكي

محرك النموذج الديناميكي هو جوهر منصة Doggy منخفضة الكود، حيث يقوم بتمييز حقول الأعمال عبر خاصية @Ef مع PHP 8 Attributes، ويولّد تلقائيًا ترحيلات قاعدة البيانات وواجهة برمجة التطبيقات وواجهة الإدارة.

نظرة عامة

يعتمد نظام النموذج الديناميكي على خاصيتين أساسيتين:

Ef: تمييز مجموعات الحقول والخصائص الوصفية لحقول الأعمال
EfGroup: تعريف مجموعات الحقول

يتم تعريف الخصائص في src/Annotation/Ef.php وsrc/Annotation/EfGroup.php:

php

// src/Annotation/Ef.php
class Ef
{
    public $value = [];

    public function __construct(array $data)
    {
        $this->value['group'] = $data['group'] ?? null;
        $this->value['bf'] = $data['isBF'] ?? false;
    }
}

تعريف نموذج

php

namespace App\Entity\Organization;

use App\Annotation\Ef;
use App\Entity\Traits\CommonTrait;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
#[ORM\Table(name: 'org_department')]
class Department
{
    use CommonTrait;

    #[ORM\Id]
    #[ORM\Column(type: 'uuid', unique: true)]
    #[ORM\GeneratedValue(strategy: 'CUSTOM')]
    #[ORM\CustomIdGenerator(class: 'doctrine.uuid_generator')]
    private $id;

    #[Ef(displayName: '部门名称', required: true)]
    #[ORM\Column(length: 100)]
    private string $name;

    #[Ef(displayName: '部门编码', searchable: true)]
    #[ORM\Column(length: 50, nullable: true)]
    private ?string $code = null;
}

إدارة الكيانات

يمكن عرض الكيانات وإدارتها في لوحة الإدارة ضمن منصة منخفضة الكود ← إدارة الكيانات (App\Controller\Admin\Platform\EntityController):

دليل الكيانات الرئيسي

الدليل	الكيانات	الوصف
`Entity/Organization/`	Department, Company, Corporation, Employee, Position, PositionLevel	الهيكل التنظيمي والموظفون
`Entity/Platform/`	Entity, EntityProperty, View, ViewField, DataGrid, Menu, DataSource	محرك منخفض الكود
`Entity/Security/`	PasswordPolicy, PasswordStrengthRule, PasswordResetMethod, WebauthnCredential	نظام الأمان
`Entity/Storage/`	File, StorageConfig, UploadSession	تخزين الملفات
`Entity/System/`	AuditLog, Task, TaskLog, EmailConfig, EmailTemplate, EmailLog, SystemCalendarEvent	البنية الأساسية

CommonTrait

تجمع جميع الكيانات القدرات التالية عبر CommonTrait (src/Entity/CommonTrait.php):

php

trait CommonTrait
{
    use SoftDeleteableEntity;    // 软删除（deletedAt 字段）
    use TimestampableEntity;     // 时间戳（createdAt, updatedAt）
    use BlameableEntity;        // 操作人（createdBy, updatedBy）

    #[ORM\ManyToOne(targetEntity: Corporation::class)]
    private $corporation;

    #[ORM\ManyToOne(targetEntity: Company::class)]
    private $company;
}

التوليد التلقائي

بعد تعريف النموذج، تتعامل أوامر مثل EfInitEntityCommand تلقائيًا مع:

توليد ملفات ترحيل قاعدة البيانات
عرض واجهة CRUD
قواعد التحقق من البيانات
فحوصات الصلاحيات

لوحة الإدارة

يمكن إجراء عمليات مرئية من خلال منصة منخفضة الكود ← إدارة الكيانات (/admin/platform/entity):

تحرير خصائص الكيان (EntityProperty)
إدارة مجموعات الخصائص (EntityPropertyGroup)
توليد الترحيلات بنقرة واحدة
تكوين العلاقات

النموذج الديناميكي ​

نظرة عامة ​

تعريف نموذج ​

إدارة الكيانات ​

دليل الكيانات الرئيسي ​

CommonTrait ​

التوليد التلقائي ​

لوحة الإدارة ​