Arquitetura — o que é automático, e onde o usuário entra
arquitetura/AUTOMACAO.md
title: ARQUITETURA — Automação e o papel do usuário
criado: 2026-09-17
status: 📐 DESENHO
Arquitetura — o que é automático, e onde o usuário entra
1. Papéis (definidos pelo usuário em 2026-09-17)
| Papel | Quem | O que faz |
|---|---|---|
| Agente de insights | USUÁRIO | Aponta onde buscar evidência ("olhe o Fed", "vá ao X", "veja esse .md"), traz material, define risco e horizonte |
| Analista / executor | Hermes | Busca, cruza, calcula, registra, monitora, alerta — e (fase final) executa |
| Decisor final | USUÁRIO | Aprova o que é executado com dinheiro real |
O usuário quer automação total — e vai atuar como fonte de direcionamento,
não como operador. Isso é compatível: a automação cuida do processo; o usuário
cuida do direcionamento.
2. 🪜 A ESCADA DE AUTOMAÇÃO (subir um degrau por vez)
| Nível | O que é | Risco | Pré-requisito |
|---|---|---|---|
| 0 | Conversa (o que temos hoje) | Nenhum | — |
| 1 | Análise + alertas automáticos — o bot analisa em agenda e te avisa | Nenhum | fontes definidas |
| 2 | Paper trading — simula e pontua, sem dinheiro | Nenhum | nível 1 + métricas |
| 3 | Execução assistida — o bot prepara a ordem, você confirma | Baixo | nível 2 validado |
| 4 | Execução automática — dentro de limites duros | Alto | nível 2 validado + limites + aceite explícito |
Regra: não pular degraus. O nível 4 só existe depois do 2 provar número.
3. O que é automatizável, por domínio
Tesouro Direto
- ✅ Análise: preço, taxa, net de custos, cenários, breakeven — tudo calculável
- ✅ Monitoramento: taxas do dia, alerta quando atingir alvo
- ⚠️ Execução: não há API oficial de negociação para pessoa física.
Automação exigiria navegador (login + 2FA) no site do Tesouro/corretora.
→ Tecnicamente possível (temos navegador + cofre de credenciais), mas é o
caminho de maior risco e menor necessidade. Começar por 1-3.
Cripto
- ✅ Análise: dados públicos e gratuitos
- ✅ Paper: simulação fiel
- ⚠️ Execução: existe API (ccxt) → realmente automatizável, mas exige
chaves com permissão de trade e limites duros de perda
4. Onde roda (no SEU ambiente)
Container Hermes (Docker/Coolify)
├── /opt/data/trading/ ← documentos, teses, decisões, scorecard
├── scripts/ ← cálculo e coleta (a construir)
├── cronjob ← análise agendada + alertas
└── navegador + cofre ← (só se precisar de execução via web)
Não precisa de máquina local nem Railway — ao contrário do material enviado.
5. Ciclo operacional proposto
USUÁRIO: aponta tema/fonte/arquivo
↓
HERMES: coleta (cascata de fontes §4 do CADERNO) → calcula → escreve a tese
↓
HERMES: registra no scorecard (data, preço, tese, invalidação)
↓
MONITOR: vigia o gatilho e a invalidação → alerta quando muda
↓
USUÁRIO: decide (ou, no nível 4, a regra decide dentro do limite)
↓
HERMES: fecha o loop — confere o resultado e pontua a tese
6. Regras de segurança (herdadas do material + próprias)
- Paper primeiro, sempre
- Risco só com aceite explícito e registrado
- Limite de perda duro (o bot não ultrapassa nem "na confiança")
- Uma variável por ciclo (ver
metodo/METODO.md§C1) - Contrato de dados: fonte que muda de formato ⇒ para e avisa
- Heartbeat: monitor silencioso ≠ monitor funcionando
- Tudo auditável: toda recomendação com data, preço e justificativa
7. Status
📐 Desenho. Nada implementado.
Próximo passo depende do usuário: definir nível-alvo e as primeiras fontes.
Gerado por Hermes Agent · gerado em 17/11/2026 19:01 · regras desta página · análise, não ordem — a decisão é sempre sua.