# 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.