Installation

Guide to installing and configuring Doggy Framework.

Prerequisites

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

Directory Structure

my-app/
├── Caddyfile              # FrankenPHP config (Mercure Hub, compression, cache)
├── config/
│   ├── bundles.php
│   ├── packages/          # 31 bundle config files
│   └── 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, etc.
│   └── ...
├── templates/             # 143 Twig templates
└── public/                # Entry point

Installing Dependencies

PostgreSQL

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

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

Create the database:

createdb app

Mercure Hub

The Mercure Hub is built into FrankenPHP and configured via the Caddyfile — no separate installation needed. See Mercure Setup.

Starting the Application

# Development
symfony serve

# Production (FrankenPHP Worker mode)
cd my-app && php -d variables_order=EGPCS bin/runtime -vvv

FrankenPHP reads Caddyfile config automatically and listens on http://localhost:8000.

Initialize Database

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

Initialize Base Data

# Initialize admin accounts (three officers)
php bin/console app:init-officers

# Generate static menu
php bin/console app:ef:init-admin-menu

Default Accounts

Role	Username	Initial Password
System Admin	admin	admin123
Security Officer	security	security123
Auditor	auditor	auditor123

⚠️ Change all default passwords in production.

Access

• Application: http://localhost:8000
• Admin Panel: http://localhost:8000/admin
• Login: http://localhost:8000/login

Next Steps

• Dynamic Model — Learn the @Ef annotation system
• Organization — Build your org tree
• WebAuthn — Configure passwordless login