💬 Contexto: O sistema da Chapecoense travou na hora da venda de ingressos para o jogo mais importante do ano. O técnico corrigiu o problema em duas horas. Três meses depois, o mesmo problema voltou — e o técnico que tinha resolvido estava de férias. Ninguém sabia o que tinha sido feito. O sistema ficou fora do ar por seis horas. Isso poderia ter sido evitado com uma única página de documentação.

💡 O que não está escrito, não existe

Quando um técnico resolve um problema sem documentar, ele resolve para si mesmo. No dia seguinte, com outro chamado, outro técnico, outro horário — o conhecimento some.

Documentar falhas não é burocracia. É o que separa uma equipe que aprende dos erros de uma equipe que os repete.

Documentação de falhas é o registro estruturado de problemas ocorridos em um sistema — incluindo o que aconteceu, por que aconteceu, como foi resolvido e o que pode ser feito para evitar que aconteça de novo.

🔍 Por que documentar falhas?

flowchart LR
    A([🐛 Falha ocorre]):::red --> B([🔧 Técnico resolve]):::gray
    B --> C{Documentou?}:::gray

    C -->|Não| D([😰 Próxima vez: Iniciar do zero]):::red
    C -->|Sim| E([😌 Próxima vez: consultar o histórico]):::green

    D --> F([⏱️ Horas perdidas replicando diagnóstico]):::red
    E --> G([⚡ Resolução rápida com base no histórico]):::green

    classDef red   fill:#F5C4B3,stroke:#993C1D,color:#4A1B0C
    classDef green fill:#C0DD97,stroke:#3B6D11,color:#173404
    classDef gray  fill:#D3D1C7,stroke:#5F5E5A,color:#2C2C2A

Uma boa base de documentação de falhas serve para:

• ⚡ Resolver mais rápido — consultar o histórico antes de investigar do zero
• 🔁 Evitar recorrências — identificar padrões e atacar a causa raiz
• 👥 Transferir conhecimento — qualquer técnico da equipe consegue dar continuidade
• 📊 Embasar melhorias — dados reais sobre o que mais falha orientam o plano de manutenção
• 📜 Comprovar o trabalho — registro formal do que foi feito para o cliente ou gestor

🗂️ Classificação de falhas

Antes de documentar, é preciso classificar. Nem toda falha é igual — e a classificação ajuda a priorizar e a encontrar padrões.

Por gravidade

flowchart TD
    G1([🔴 Crítica]):::red --> T1([Sistema indisponível ou dados em risco]):::red
    G2([🟠 Alta]):::amber --> T2([Função principal impactada]):::amber
    G3([🟡 Média]):::yellow --> T3([Função secundária impactada]):::yellow
    G4([🟢 Baixa]):::green --> T4([Inconveniência sem impacto operacional]):::green

    classDef red    fill:#F5C4B3,stroke:#993C1D,color:#4A1B0C
    classDef amber  fill:#FAC775,stroke:#854F0B,color:#412402
    classDef yellow fill:#C0DD97,stroke:#3B6D11,color:#173404
    classDef green  fill:#9FE1CB,stroke:#0F6E56,color:#04342C