docs: Parte IV — mapeamentos operacionais (dependências, perf, falhas, cobertura, flags, schema, custos, segurança)#65
Merged
Conversation
…cao/ Oito mapas para operacao, evolucao e risco, ancorados por analise estatica (grep de Cargo/pyproject/package/proto/env/cfg). Numeros de runtime NAO medidos ficam marcados ⟨medir⟩, nunca fabricados (regra "Nada Fake"). - 01 Dependencias de build e features (grafo + tabela de impacto; feature `pg`) - 02 Caminho critico de performance (pipeline sync/async/bloqueante; k6/bench reais) - 03 Failure modes e propagacao de erro (enums reais + fluxograma fail-closed/degrada/retry) - 04 Cobertura de testes por caminho (presenca/tipo; % real via tarpaulin/pytest-cov) - 05 Feature flags e variaveis de ambiente (todas as env vars + grafo de interdependencia) - 06 Migracao de schema DB/protobuf/JSON (buf breaking, migrations_pg, ADRs 0027/0030/0032) - 07 Custos por operacao (tabela de precos real embutida + alavancas; $/fluxo via telemetria) - 08 Dados sensiveis e seguranca (fluxo de keys/PII, criptografia, lacunas GDPR honestas) Nenhum codigo alterado — so docs/documentacao/. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E7hL6w2gjAe3em94iTbkEB
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Resumo
Adiciona a Parte IV — Mapeamentos operacionais em
docs/documentacao/mapeamentos/: oito mapas para operação, evolução e risco do sistema. Nenhum código alterado — sódocs/documentacao/.Os oito mapas
pgPrincípio "Nada Fake"
Vários mapas pedem dados de runtime (p99, cache hit ratio, custo em $, % de cobertura) que não são estáveis por análise estática. Esses números não foram inventados: aparecem marcados
⟨medir⟩com o comando/telemetria para obtê-los. O que é estático e real (sync/async, enums de erro, env vars, modelo de custo, presença de teste) está mapeado integralmente.🤖 Generated with Claude Code
Generated by Claude Code