Arquitetura¶
| Documento | Visão |
|---|---|
system-context.md | Quem usa o sistema e com que outros sistemas ele conversa (C4 nível 1) |
containers.md | Os apps do monorepo, o worker da fila e os serviços de apoio, e como se comunicam (C4 nível 2) |
components.md | As camadas internas da API, o worker e a composição do web (C4 nível 3) |
data-model.md | As tabelas de hoje e suas relações, multi-tenancy, remoção lógica e o mecanismo de isolamento |
deployment.md | Topologia de produção, dev-remote e local — containers, serviços nativos, rede, TLS, e o deploy pelo /ship |
structurizr/workspace.dsl | O modelo C4 completo em Structurizr DSL, fonte dos três primeiros diagramas |
Diagramas de fluxo, jornada, sequência e estado (não-C4) vivem junto do documento que descrevem — a maioria dentro de cada specification.md — e usam Mermaid diretamente no Markdown. Esta pasta cobre a arquitetura estrutural do sistema, que muda pouco e serve de referência transversal.
Revisão de 2026-10-15. Os documentos foram conferidos contra o código depois das specs 0043 a 0057: entraram o worker
arqcom Redis, as consultas de crédito à API Full, a cobrança automática com os jobs agendados, o acerto com a imobiliária, a remoção lógica e os usuários da imobiliária. O ambientedev-remotedeixou de ter Caddy e banco em container — verdeployment.md.