Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 13, 2026

Implements Docker-based local development setup for BackOffice, matching the FrontOffice pattern but simplified for BackOffice's architecture.

Implementation

Infrastructure

  • Dockerfile: Ubuntu 22.04, PHP 8.1, Apache, Node.js 15, Composer, Xdebug
  • docker-compose.dev.yml: 2 services (app + MariaDB 10.11)
  • docker-entrypoint.sh: Automated initialization - dependencies, database bootstrap, frontend builds
  • Named volumes for vendor/ and node_modules/ performance optimization

Developer Tools

  • docker-dev.sh: Wrapper commands (start, stop, logs, shell, db, reset)
  • README.docker.md: Comprehensive workflow guide
  • INSTALL/INSTALL.docker.md: Quick reference

Security

  • Uses MYSQL_PWD environment variable to avoid password exposure in process lists
  • Consistent utf8mb4 charset across all database operations

Usage

./docker-dev.sh start
# Access http://localhost:5002

Key Differences from FrontOffice

  • Simpler: No stats service (PostgreSQL), no mailcatcher
  • Uses ng_backoffice instead of ng_client
  • Uses monarc_master database instead of monarc_cli
  • Port 5002 (vs FrontOffice's 5001)
Service Port Purpose
monarc 5002 PHP/Apache application
db 3306 MariaDB 10.11
Original prompt

This section details on the original issue you should resolve

<issue_title>Dockerized BackOffice</issue_title>
<issue_description>We need to be able to run the application locally with docker-compose.dev.yml</issue_description>

<agent_instructions>The same way as it was currently done for the FrontOffice application, but here is more simple set of services.
monarc-project/MonarcAppFO#587</agent_instructions>

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


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 4 commits January 13, 2026 10:53
Co-authored-by: ruslanbaidan <3246171+ruslanbaidan@users.noreply.github.com>
Co-authored-by: ruslanbaidan <3246171+ruslanbaidan@users.noreply.github.com>
- Use MYSQL_PWD environment variable to avoid exposing passwords in process list
- Use utf8mb4 charset consistently with MariaDB configuration
- Load environment variables from .env in docker-dev.sh db command

Co-authored-by: ruslanbaidan <3246171+ruslanbaidan@users.noreply.github.com>
- Use MYSQL_PWD in docker-dev.sh db command to avoid password exposure
- Add explanatory comment for --ignore-platform-req flag

Co-authored-by: ruslanbaidan <3246171+ruslanbaidan@users.noreply.github.com>
Copilot AI changed the title [WIP] Add support for Dockerized BackOffice application Add Docker development environment for BackOffice Jan 13, 2026
Copilot AI requested a review from ruslanbaidan January 13, 2026 11:00
@ruslanbaidan ruslanbaidan marked this pull request as ready for review January 14, 2026 13:26
@ruslanbaidan ruslanbaidan merged commit c1f736e into master Jan 14, 2026
3 checks passed
@ruslanbaidan ruslanbaidan deleted the copilot/dockerize-backoffice-application branch January 14, 2026 13:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Dockerized BackOffice

2 participants