cleverage/ui-process-bundle#99 - Allow running the demo on PostgreSQL instead of MySQL

[njoubert-cleverage]

Description

Allow running the demo on PostgreSQL instead of MySQL, for cleverage/ui-process-bundle#99 (migrations fixed on PostgreSQL by cleverage/ui-process-bundle#100). MySQL stays the default database; the database is chosen when installing the project, before the first make start.

• .docker/compose.yaml, all commented out:
  • x-base-postgres block and postgres service (healthcheck, port ${POSTGRES_PORT:-5432}), using the same process_bundle_demo_data volume as mysql
  • in the depends_on of php-fpm: postgres, to use instead of mysql
• .docker/postgres/Dockerfile: postgres:${POSTGRES_VERSION:-16} image with the host UID / GID, as the mysql one
• .env: its DATABASE_URL (postgresql://app:app@postgres:5432/app?serverVersion=16&charset=utf8), commented out
• .docker/php/Dockerfile: pdo_pgsql extension (libpq-dev)
• migrations/Version20241210154810.php: PostgreSQL branch for the author / book tables (the MySQL SQL is unchanged)
• docs/postgresql.md: configuration when installing the project (comment mysql / uncomment postgres in the services and in the depends_on of php-fpm, DATABASE_URL in .env.local, make start), variables, psql; noted at the top of README.md and in docs/index.md

Checked with a fresh installation following docs/postgresql.md (isolated copy of the project, separate Docker project and volume): make start (images built, PostgreSQL 16 container running with the host UID, 8 migrations, fixtures), demo.doctrine.database.* / demo.doctrine.entitymanager.* / demo.logger processes (finish, logs stored), UI login, launch from the UI consumed by the execute_process worker. The default MySQL installation still runs.

Merge once a release of cleverage/ui-process-bundle includes cleverage/ui-process-bundle#100 (the demo requires ^3.0: with v3.0.2, the migrations fail on PostgreSQL; MySQL is not affected).

Requirements

• Documentation updates
  • Reference
  • Changelog
• Unit tests

Breaking changes

None: MySQL stays the default database. The PHP image gets the pdo_pgsql extension.

🤖 Generated with Claude Code