[ADR] Bind Mount Standardization for Docker Compose

[josecelano]

Overview

This task creates an Architectural Decision Record (ADR) documenting the decision to use bind mounts exclusively for all Docker Compose volume mounts, replacing the current mix of named volumes and bind mounts.

This ADR must be created before implementing the bind mount changes (Phase 0) to establish the rationale and ensure alignment.

Specification

See detailed specification: docs/issues/288-adr-bind-mount-standardization.md

🏗️ Architecture Requirements

DDD Layer: N/A (documentation only)
Module Path: docs/decisions/
Pattern: Architectural Decision Record (ADR)

Module Structure Requirements

• Follow ADR conventions (see docs/decisions/README.md)
• Use ADR template structure (Title, Status, Context, Decision, Consequences)
• Register in ADR index

Architectural Constraints

• ADR must be created before implementation begins
• ADR must reference the refactoring plan
• ADR must document all alternatives considered

Anti-Patterns to Avoid

• ❌ Implementing changes before documenting the decision
• ❌ Incomplete rationale (must include all 9 reasons)
• ❌ Missing alternatives section

Implementation Plan

Phase 1: Create ADR Document

• Create docs/decisions/bind-mount-standardization.md
• Write Context section with all 9 reasons (observability, backup, restore, consistency, portability, debugging, dev experience, architecture simplification, security visibility)
• Write Decision section stating the choice
• Write Alternatives section with 3 rejected options
• Write Consequences section (positive and negative)
• Reference the refactoring plan

Phase 2: Register and Verify

• Add entry to ADR index in docs/decisions/README.md
• Run linters: cargo run --bin linter all
• Verify links work correctly

Acceptance Criteria

Note for Contributors: These criteria define what the PR reviewer will check. Use this as your pre-review checklist before submitting the PR to minimize back-and-forth iterations.

Quality Checks:

• Pre-commit checks pass: ./scripts/pre-commit.sh

Task-Specific Criteria:

• ADR file exists at docs/decisions/bind-mount-standardization.md
• All 9 reasons are documented in Context section
• All 3 alternatives are documented with rejection rationale
• Consequences section includes both positive and negative impacts
• ADR references the refactoring plan
• ADR is registered in docs/decisions/README.md index
• All markdown linting passes

Related

• Parent: [Epic] Docker Compose Topology Domain Model Refactoring #287 (Epic: Docker Compose Topology Domain Model Refactoring)
• Refactoring Plan: docs/refactors/plans/docker-compose-topology-domain-model.md
• Specification: docs/issues/288-adr-bind-mount-standardization.md

Notes

• This is a documentation-only task - no code changes
• This ADR supersedes the volume recommendations in grafana-integration-pattern.md
• The ADR establishes the foundation for Phase 0 implementation
• Estimated effort: ~1 hour