docs: entrega e atalho de deploy

README.md

@@ -88,3 +88,8 @@ Jest na API: frete, papéis, tenancy, chat, dashboard. A cobertura mede regra de
 - [Arquitetura](docs/ARCHITECTURE.md)
 - [Decisões](docs/DECISIONS.md)
 - [Testes](docs/TESTING.md)
+- [Entrega e CI](docs/CI.md)
+
+## Entrega
+
+Push em `main` sobe a demo na hora. Neste desafio isso basta; em produção o caminho é **merge request → pipeline (testes e build) → merge → deploy**. Detalhes em [docs/CI.md](docs/CI.md).

docs/CI.md

@@ -0,0 +1,14 @@
+# Entrega
+
+Neste desafio o push em `main` atualiza a demo na hora (webhook no servidor). É um atalho para apresentar o sistema.
+
+O fluxo adequado em time seria outro:
+
+1. Branch a partir de `main`
+2. Merge request / pull request
+3. Pipeline na MR: lint, `npm test`, build das imagens
+4. Review
+5. Merge em `main`
+6. Só então o deploy
+
+Nada iria para o ambiente público sem revisão e sem os testes passarem. Aqui não há runner de CI na VPS (1 vCPU / 4 GB); por isso o atalho.