Installation

Ce guide vous aidera à réaliser l'installation et la configuration initiale de Doggy Framework.

Prérequis

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

Structure des répertoires

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/                # 入口文件

Installation des dépendances d'environnement

PostgreSQL

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

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

Créer la base de données :

createdb app

Hub Mercure

Le Hub Mercure est intégré à FrankenPHP et peut être utilisé simplement en le configurant via le Caddyfile, sans installation supplémentaire. Voir Configuration Mercure.

Démarrer l'application

L'application s'exécute sur la machine hôte via FrankenPHP :

# 开发环境
symfony serve

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

FrankenPHP lit automatiquement la configuration du Caddyfile et écoute sur http://localhost:8000.

Initialiser la base de données

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

Initialiser les données de base

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

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

Comptes par défaut

Rôle	Nom d'utilisateur	Mot de passe initial
Administrateur système	admin	admin123
Agent de sécurité et de confidentialité	security	security123
Auditeur de sécurité	auditor	auditor123

⚠️ Tous les mots de passe par défaut doivent être modifiés en production.

Accès

• Application : http://localhost:8000
• Interface d'administration : http://localhost:8000/admin
• Connexion : http://localhost:8000/login

Étape suivante

• Modèle dynamique — découvrez le système d'annotations @Ef
• Structure organisationnelle — construisez l'arborescence organisationnelle de l'entreprise
• WebAuthn — configurez la connexion sans mot de passe