ADR-011: Padrão Docker + Dev Container

Resumo publicável desta decisão arquitetural.

Status: Aceita

Contexto

Projetos Moodle, WordPress e outros precisam de setup Docker padronizado que funcione com Dev Containers (PHPStorm, VS Code), separe DEV/BUILD/PROD, e injete secrets via 1Password.

Decisão

Dockerfile multi-stage (builder → production → development). Compose base + override gitignored + devcontainer commitado. Workspace em /workspace, Xdebug controlável sem rebuild, Composer dentro do container, secrets via op run / --mount=type=secret / OP Connect. .dockerignore rigoroso. Makefile com comandos dev padronizados.

Consequências

Estrutura previsível entre projetos. Dev Containers funcionam em PHPStorm e VS Code. Imagem prod limpa. Secrets nunca no repo.