Refactor Docker Compose file naming to avoid V2 precedence conflict

[devondragon]

Summary

• Renames compose.yaml → compose.dev.yaml (dev dependencies for bootRun) and docker-compose.yml → compose.yaml (full deployable stack) to resolve Docker Compose V2 precedence conflict
• Adds spring.docker.compose.file=compose.dev.yaml to application-local.yml-example so Spring Boot finds the dev compose file
• Updates README.md with compose file descriptions and Docker Compose V2 CLI syntax

Closes #68

Test plan

• Verify ./gradlew bootRun with local profile picks up compose.dev.yaml and starts the dev database
• Verify docker compose up --build uses compose.yaml and starts the full stack (app + db + mail)
• Verify docker compose -f docker-compose-keycloak.yml up --build still works for the Keycloak stack

[Copilot]

Pull request overview

Refactors Docker Compose file naming to avoid Docker Compose V2 precedence issues by separating the dev-only Compose stack used by Spring Boot from the full deployable stack, and updates documentation/configuration accordingly.

Changes:

• Renames/migrates dev-only Compose setup into compose.dev.yaml and makes compose.yaml the full deployable stack.
• Updates application-local.yml-example to point Spring Boot Docker Compose integration at compose.dev.yaml.
• Updates README and CHANGELOG with the new filenames and Docker Compose V2 CLI syntax.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/main/resources/application-local.yml-example	Adds spring.docker.compose.file=compose.dev.yaml to direct Spring Boot to the dev Compose file.
docker-compose.yml	Removes the legacy full-stack Compose file (migrated to compose.yaml).
compose.yaml	Becomes the default full-stack Compose file (app + DB + mailserver).
compose.dev.yaml	Adds a dev-only Compose file (database only) for bootRun/local development.
README.md	Updates Compose usage docs (file descriptions + docker compose CLI syntax).
CHANGELOG.md	Documents the Compose naming refactor.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

application-local.yml-example is currently invalid YAML: logging.level.org.springframework.web is set to the scalar DEBUG but then filter: is indented beneath it. YAML scalars can’t have child keys, so Spring won’t be able to parse this file when someone copies it to application-local.yml. Restructure the logging section (e.g., make web: a map containing filter, or flatten the key) so the example config is parseable.

[Copilot]

compose.dev.yaml uses mariadb:12.2 while the other compose stacks (compose.yaml, docker-compose-keycloak.yml) use mariadb:11.6.2. Using different major/minor versions between local bootRun and the full stack can cause schema/behavior drift and “works locally but not in Docker” issues. Consider aligning the MariaDB image version across compose files (or document why they intentionally differ).

Suggested change

	image: mariadb:12.2
	image: mariadb:11.6.2

[Copilot]

The myapp-main healthcheck runs curl, but the Dockerfile installs and uses wget for health checks (and doesn’t install curl explicitly). This can make the Compose healthcheck fail and mark the app as unhealthy even when it’s running. Update the Compose healthcheck to use wget (or install curl in the image) so the healthcheck command matches what’s available in the container.

Suggested change

	test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
	test: ["CMD", "wget", "-qO-", "http://localhost:8080/actuator/health"]