Add Docker development environment for MonarcAppFO

[Copilot]

Provides a Docker-based development setup as a faster, more portable alternative to Vagrant while maintaining identical functionality.

Implementation

Core Infrastructure

• Dockerfile: Ubuntu 22.04 with PHP 8.1, Apache, Node.js 15, Composer, Xdebug
• Dockerfile.stats: Python/Poetry container for stats service
• docker-compose.dev.yml: Orchestrates 5 services (app, MariaDB, PostgreSQL, stats, mailcatcher)
• Entrypoint scripts handle initialization: database setup, dependency installation, frontend builds

Configuration

• .env.dev: Template with development defaults
• .dockerignore: Excludes build artifacts, dependencies
• Named volumes for vendor/ and node_modules/ to optimize performance

Developer Experience

• docker-dev.sh: Helper script with commands (start, stop, logs, shell, db, reset, stats-key)
• README.docker.md: Comprehensive guide covering workflow, troubleshooting, common tasks
• INSTALL/INSTALL.docker.md: Quick reference

Usage

./docker-dev.sh start
# Access http://localhost:5001 (admin@admin.localhost / admin)

Or directly:

cp .env.dev .env
docker compose -f docker-compose.dev.yml up -d --build

Services

Service	Port	Purpose
monarc	5001	PHP/Apache application
db	3306	MariaDB 10.11
postgres	5432	PostgreSQL 15 (stats)
stats-service	5005	Python/Flask API
mailcatcher	1080	Email testing

Performance

• Startup: ~2-3 min (vs 10-15 min Vagrant)
• Resource usage: Container-level isolation vs full VM
• Live code editing with volume mounts

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Dockerize the setup of FrontOffice</issue_title>
<issue_description>### Discussed in #509

^{Originally posted by bwmravec October 26, 2023}
Describe the solution you'd like
I'm wondering if there is a plan to dockerize the setup of MonarcAppFO with automated builds through github?

<agent_instructions>We need the dockerized version of the FrontOffice and BackOffice applications for the development purposes (docker-compose.dev.yml)
Similar to what is done with the Vagrant use.
The BackOffice app is similar and located here:
https://github.com/monarc-project/MonarcAppBO</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Dockerize the setup of FrontOffice #512

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.