التثبيت

سيساعدك هذا الدليل على إتمام تثبيت Doggy Framework والتكوين الأولي.

المتطلبات الأساسية

• PHP >= 8.2
• ext-ctype, ext-iconv
• PostgreSQL >= 14
• Composer >= 2.5

بنية الدلائل

my-app/
├── Caddyfile              # FrankenPHP 配置（含 Mercure Hub、压缩、缓存）
├── config/
│   ├── bundles.php
│   ├── packages/          # 31 个 Bundle 配置文件
│   └── services.yaml
├── src/
│   ├── Annotation/        # Ef.php, EfGroup.php
│   ├── Entity/            # Organization, Platform, Security, Storage, System, Traits
│   ├── Controller/        # Admin, Api, Security
│   ├── Service/           # AI, Storage, Security, Task, Platform 等
│   └── ...
├── templates/             # 143 个 Twig 模板
└── public/                # 入口文件

تثبيت تبعيات البيئة

PostgreSQL

# macOS
brew install postgresql@14
brew services start postgresql@14

# Ubuntu/Debian
sudo apt install postgresql-14
sudo systemctl start postgresql

إنشاء قاعدة البيانات:

createdb app

Mercure Hub

Mercure Hub مدمج في FrankenPHP ويمكن استخدامه بمجرد تكوينه عبر Caddyfile دون تثبيت إضافي. انظر تكوين Mercure.

تشغيل التطبيق

يعمل التطبيق على الجهاز المضيف عبر FrankenPHP:

# 开发环境
symfony serve

# 生产环境（FrankenPHP Worker 模式）
cd my-app && php -d variables_order=EGPCS bin/runtime -vvv

يقرأ FrankenPHP التكوين تلقائيًا من Caddyfile ويستمع على http://localhost:8000.

تهيئة قاعدة البيانات

php bin/console doctrine:database:create
php bin/console doctrine:migrations:migrate
php bin/console doctrine:fixtures:load

تهيئة البيانات الأساسية

# 初始化管理员账号（三员）
php bin/console app:init-officers

# 生成静态菜单
php bin/console app:ef:init-admin-menu

الحسابات الافتراضية

الدور	اسم المستخدم	كلمة المرور الأولية
مدير النظام	admin	admin123
مسؤول الأمان والسرية	security	security123
مدقق الأمان	auditor	auditor123

⚠️ يجب تغيير جميع كلمات المرور الافتراضية في بيئة الإنتاج.

الوصول

• التطبيق: http://localhost:8000
• لوحة الإدارة: http://localhost:8000/admin
• تسجيل الدخول: http://localhost:8000/login

الخطوة التالية

• النموذج الديناميكي — التعرف على نظام الخاصية @Ef
• الهيكل التنظيمي — بناء شجرة المؤسسة التنظيمية
• WebAuthn — تكوين تسجيل الدخول بدون كلمة مرور