docs: documentação de arquitetura completa + mapeamento de dados (docs/documentacao/)#64
Merged
Merged
Conversation
…agramas Amplia docs/documentacao/ para cobrir o repositorio inteiro em todos os niveis: - diagramas/10 Modelo C4: Contexto -> Conteiner -> Componente (Rust, Python, SPA) - diagramas/11 Modelo de dados (ER): produto, ledger hash-chain, event store, telemetria/cache/regras, sessoes Postgres - diagramas/12 Maquinas de estado: RunStatus, permissao, handoff, verdict, degradacao 3-niveis do squad, ciclo do sidecar, sessao web (ator unico) - diagramas/13 Modulos por crate (Rust): estrutura interna dos 14 crates - diagramas/14 Modulos Python e frontend: 5 pacotes + 2 SPAs Total: 53 diagramas Mermaid cobrindo contexto -> conteiner -> componente -> modulo -> classe -> sequencia -> atividade -> estado -> dados -> implantacao. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E7hL6w2gjAe3em94iTbkEB
Adiciona docs/documentacao/dados/ com o documento-indice do dicionario de dados exaustivo do sistema: metodologia, taxonomia de direcao (entrada/saida/ intermediario/estado/config/wire), mapa global de fluxo de dados ponta a ponta, reservatorios de dados, catalogo de variaveis de ambiente e fronteiras wire. Os dicionarios por modulo (10-17: Rust por camada, Python, TypeScript/HTML) vem em commit seguinte (varredura linha-a-linha em andamento). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E7hL6w2gjAe3em94iTbkEB
…emais Mapeamento linha-a-linha de entrada/saida/intermediario de btv-domain, btv-schemas, btv-core, btv-llm, btv-server, btv-tui, btv-golden, btv-contract. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E7hL6w2gjAe3em94iTbkEB
Mapeamento linha-a-linha de entrada/saida/intermediario de btv-tools, btv-verify, btv-store, btv-proto, btv-sidecar e btv-cli (composition root). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E7hL6w2gjAe3em94iTbkEB
Mapeamento linha-a-linha de entrada/saida/intermediario dos 5 pacotes Python (squad/promptforge/review/proto-py/eval) e das 2 SPAs (web/, btv-web/). Completa a Parte III — mapeamento de dados do sistema inteiro. 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
Documentação de arquitetura completa do repositório, gerada por análise estática de todo o código-fonte (137
.rs, 89.py, 160.ts/.tsx) e dos contratos emschemas/. Tudo contido emdocs/documentacao/— nenhum código alterado.Conteúdo
Parte I — Diagramas UML (
diagramas/, 53 diagramas Mermaid):Parte II — Referência estrutural (
referencia/):Parte III — Mapeamento de dados (
dados/):wireAchados de arquitetura destacados
ProtocolPython ↔ camadaapi/TS)schemas/, com o único algoritmo duplicado (prompt-cache-key.v1) verificado por paridade de fixtures🤖 Generated with Claude Code
Generated by Claude Code