README

PSFS Core

PSFS is a lightweight PHP framework for MVC/API applications (Twig + Propel + Symfony components).

5-minute setup

Prerequisites:

• Docker + Docker Compose
• Git

docker compose up -d
docker compose ps
docker exec core-php-1 php -v
docker exec core-php-1 composer install --no-interaction --prefer-dist

If your PHP container name is not core-php-1:

docker compose ps
docker ps --format '{{.Names}}'

Daily command map

# Run key tests
docker exec core-php-1 php vendor/bin/phpunit --no-coverage --filter '/(AuthApiTest|RequestResponseSecurityContractTest)/'

# List PSFS CLI commands
docker exec core-php-1 php src/bin/psfs list

# Security local pre-check (act)
act push --container-architecture linux/amd64

Choose your path

Onboarding path

1. Read Operations Playbook
2. Read DTO Validation Engine
3. Execute the "First day" flow
4. Use troubleshooting matrix when blocked

Core contributor path

1. Read Operations Playbook
2. Read DTO Validation Engine
3. Read Propel Workflow
4. Run key tests and validate changes in Docker

Propel models and migrations

For operational Propel flow (schema, model generation context, migration execution, rollback, failure modes), see:

• Propel Workflow

Documentation index

• Operations Playbook
• DTO Validation Engine
• Propel Workflow

Rules

• Run project commands inside Docker containers.
• Keep command blocks explicitly tagged as validated or example-only.