docs: documentação única da stack — deploy/infra/projetos + regras (LEIA-PRIMEIRO)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 17:31:50 +02:00
commit c0ca88c028
14 changed files with 582 additions and 0 deletions
@@ -0,0 +1,42 @@
+# LEIA PRIMEIRO
+
+> Documentação **única e oficial** da stack (Clube67 / ScoreOdonto e demais projetos).
+> Repositório (fonte da verdade): **`git.clube67.com/ruicesar/Documentos-Unicos`**.
+> **Leia este arquivo antes de qualquer outra coisa.**
+
+---
+
+## Regras obrigatórias
+
+1. **Idioma: PORTUGUÊS.** Tudo — explicações, documentos, comentários, commits, conversas — em português. Sem exceção.
+
+2. **Fonte única.** Este repositório é a documentação oficial e vigente. Qualquer `.md` fora daqui que divergir **não vale**.
+
+3. **Uma situação = um arquivo.** Organização em **pastas por tipo**; dentro, **um `.md` por situação**. **Nunca** misturar situações num mesmo arquivo. Situação nova = arquivo novo (ou pasta nova de tipo).
+
+4. **Atualizar = REESCREVER o arquivo da situação** (nunca "v2" ao lado). O arquivo descreve o **estado ATUAL real**, nunca o desejado.
+
+5. **Versão antiga → `desuso/`.** Antes de reescrever, copie a versão anterior para `desuso/` com data no nome e aviso **EM DESUSO** no topo.
+
+6. **Cada projeto só tem um `LEIA.md`** na raiz, que **aponta** para este repositório — **nunca** guarda documentação própria espalhada.
+
+7. **`desuso/` é só CONSULTA.** Em dúvida, **consulte o `desuso/`** para entender o histórico / tirar dúvida ou como base para **corrigir/melhorar**. Mas ele **nunca** é instrução vigente: **toda instrução nova ou atualizada vai na doc oficial** (fora do `desuso/`).
+
+8. **Sempre testar em `https://dev.<projeto>`** antes de qualquer coisa.
+
+9. **Sempre pedir aprovação** do administrador antes de ir para **produção** ou implementar **novas melhorias/implementações**.
+
+10. **Antes de anotar, checar duplicação.** Verifique se o tema **já existe** aqui — não duplicar. **Prefira sempre doc UNIVERSAL** (serve a todos os projetos). Se um projeto **for diferente**: **cite o que o torna diferente** e crie a doc específica dele em `projetos/<projeto>/` — para a **doc universal ficar sempre alinhada** (não poluída com exceções).
+
+---
+
+## Organização deste repositório
+
+| Pasta | Conteúdo |
+|---|---|
+| `deploy/` | Deploy (universal): `modelo`, `subir-release`, `rollback`, `versionamento`. |
+| `infra/` | Infraestrutura (universal): `maquinas-e-rede`, `ambiente-dev`. |
+| `projetos/<projeto>/` | **Só o que DIFERE** do universal, por projeto (cita o delta + referencia o universal). |
+| `desuso/` | Histórico/obsoletos (datado, "EM DESUSO"). Só consulta. |
+
+> Tipo de assunto novo (ex.: segurança, banco, monitoramento)? Crie uma **pasta nova** aqui com os `.md` das situações.