Handoff — Arquitetura C4 e Sustentação Operacional
Versão: 1.1
Data: 2026-07-23
Origem: Pacote Arquitetura C4 Arah (modelo C4, monetização, operação multi-instância, cockpit do implementador) + evolução Inteligência Territorial / World Monitor
Este diretório concentra a documentação interativa de handoff que define o que sustenta operacionalmente a plataforma — além das funcionalidades comunitárias do backlog original — e a trilha de inteligência territorial regenerativa.
Inteligência Territorial (NOVO · 2026-07)
Pacote completo (Hub + 11 decks + notas de pesquisa):
→ inteligencia-territorial/README.md
→ Realinhamento no backlog: REALINHAMENTO_INTELIGENCIA_TERRITORIAL.md
Os decks C4 e Backlog Atualizado em arquitetura-c4/ foram atualizados com o container Intelligence e o bloco TI-0…TI-7.
Documentos interativos (HTML)
Abra no navegador (servidor local ou extensão Live Server). Todos compartilham o design system Arah em _ds/.
| Documento | Arquivo | Público |
|---|---|---|
| Operação por agentes | Operacao por Agentes - Arah.dc.html | Engenharia, Cursor, PM |
| Arquitetura C4 | Arquitetura C4 Arah.dc.html | Backend, mobile, arquitetura |
| Plano operacional & pipelines | Plano Operacional e Pipelines - Arah.dc.html | DevOps/SRE, plataforma |
| Operação, instâncias & federação | Anexo Handoff - Operacao Instancias e Federacao.dc.html | Backend, infra, plataforma |
| Adendo de monetização | Adendo de Monetizacao - Handoff Arah.dc.html | Produto, backend, financeiro |
| Cockpit do implementador | Cockpit do Implementador Arah.dc.html | Frontend web, produto |
| Programa de implementadores | Programa de Implementadores Arah.dc.html | Produto, operação, site |
| Backlog atualizado (impacto) | Backlog Atualizado - Arah.dc.html | Planejamento, PM |
Uso no site e portal de implementadores
Estes HTMLs podem ser:
- Embutidos ou linkados no portal institucional (
frontend/arah.siteou equivalente) na seção Para implementadores - Referenciados no DevPortal (
frontend/devportal/) como documentação de arquitetura e operação - Publicados como artefatos estáticos no wiki interno
Para servir localmente:
cd docs/handoff/arquitetura-c4
python -m http.server 8080
# Abrir http://localhost:8080/Arquitetura%20C4%20Arah.dc.html
- docs/ops/AGENT_OPERATION.md — infraestrutura implementada
- AGENTS.md — manual dos agentes
Integração com o backlog
Ordem de execução: infraestrutura de agentes (PR 1–4) → depois Onda S / FASE52+ → trilha TI em paralelo aos P0 de economia local (17–19), sem competir por squad.
Realinhamentos oficiais:
- REALINHAMENTO_SUSTENTACAO_OPERACIONAL.md — ondas S0–S4, fases 52–61
- REALINHAMENTO_INTELIGENCIA_TERRITORIAL.md — trilha TI-0…TI-7 (âncoras FASE23/24/44/53)
- Fases 52–61 — épicos de sustentação
- TI0…TI7 — incrementos de inteligência territorial
Princípios (resumo)
- Morador nunca paga — cobrança só em atividade comercial e serviços opcionais
- Núcleo aberto — receita por operação e serviço, não paywall de funcionalidade essencial
- Território como fronteira de dados — federação opt-in; Core coordena, não possui conteúdo
- Transparência por padrão — taxa, split e repasses visíveis antes e depois do pagamento
- A sustentação não atrasa o comunitário — viabiliza financiá-lo; funcionalidades ganham ganchos de receita
- Inteligência com revisão humana — fonte visível; contestação; sem decisão opaca de IA; Territory neutro
Referências cruzadas: Roadmap · Backlog API · Modelo de domínio · ADRs