MANUAL DE USO E EXECUÇÃO — TAVO REAL GLOBAL AUTO

 📘 MANUAL DE USO E EXECUÇÃO — TAVO REAL GLOBAL AUTO V3.0, elaborado em formato institucional, completo e pronto para integrar o Painel TAVO 2.0 e sua documentação técnica interna.

TAVO REAL GLOBAL AUTO V3.0

Sistema Autônomo de Previsão de Ciclos Econômicos e Valuation Monetário Global

📅 Versão: 3.0 | 🧠 Autor: Dante Vitoriano Locatelli

📍 Compatível com: Sistema TAVO 2.0 (painel + IA analítica)

💻 Ambientes Suportados: Windows, Linux, macOS

1. OBJETIVO DO SISTEMA

O TAVO REAL GLOBAL AUTO V3.0 é o núcleo preditivo do Sistema TAVO 2.0, capaz de:

• Captar dados monetários reais e auditáveis (FRED + LBMA).
• Calcular em tempo quase real o índice fiduciário global (Sₒ).
• Identificar fases dos ciclos econômicos (I–V) com base em ΔSₒ.
• Gerar sinais operacionais automáticos (↑, →, ↓).
• Exportar resultados em Excel e CSV para o painel TAVO.
• Operar de forma autônoma, reprodutível e escalável.

2. ESTRUTURA DE ARQUIVOS

/TAVO_ENGINE_V3/

│

├── tavo_auto_update.py           → Script principal (executável)

├── requirements.txt              → Dependências mínimas

├── config_tavo.json              → Parâmetros configuráveis

│

├── outputs/

│   ├── TAVO_REAL_GLOBAL_AUTO_V3.xlsx

│   ├── export_calculos_global.csv

│   └── logs/

│       └── tavo_run_YYYYMMDD.txt

│

└── install_and_run.bat           → Instalação e execução automática (Windows)

3. INSTALAÇÃO

🪟 Windows

1. Baixe a pasta completa /TAVO_ENGINE_V3/.
2. Abra o Prompt de Comando (CMD).
3. Acesse a pasta com:

cd caminho\para\TAVO_ENGINE_V3

3. 
   
4. Execute:

install_and_run.bat

🐧 Linux / macOS

1. No terminal:

cd /caminho/para/TAVO_ENGINE_V3

pip install -r requirements.txt

python tavo_auto_update.py

4. DEPENDÊNCIAS

O sistema utiliza apenas bibliotecas livres e leves:

pandas>=1.5.0

numpy>=1.21.0

yfinance>=0.2.0

openpyxl>=3.0.0

matplotlib>=3.5.0

Instalação manual:

pip install -r requirements.txt

5. EXECUÇÃO

🔹 Execução única

python tavo_auto_update.py

🔹 Execução agendada (automática)

Linux / macOS (cron)

0 9 1 * * python /TAVO_ENGINE_V3/tavo_auto_update.py

Executa todo dia 1º do mês às 09h.

Windows (Agendador de Tarefas)

• Criar tarefa → Executar:

python C:\TAVO_ENGINE_V3\tavo_auto_update.py

• 
  
• Frequência: mensal / semanal conforme desejado.

6. ENTRADA DE DADOS

O sistema coleta automaticamente as séries oficiais:

Série	Fonte	Código FRED	Unidade	Conversão
M2 USA	FRED	M2SL	Bilhões USD	→ trilhões
Fed (BCB EUA)	FRED	WALCL	Milhões USD	→ trilhões
ECB	FRED	ECBASSETSW	Bilhões EUR	→ trilhões USD
BoJ	FRED	JPNASSETSW	Trilhão JPY	→ trilhões USD
BoE	FRED	BOEASSETSW	Bilhões GBP	→ trilhões USD
Dívida EUA	FRED	GFDEBTN	Milhões USD	→ trilhões
Ouro	LBMA/FRED	GOLDAMGBD228NLBM	USD/oz	—

💡 Caso alguma fonte falhe, o sistema usa fallback automático com o último valor válido.

7. CÁLCULOS INTERNOS

Fórmula Principal

Sₒ = 100 × [\ln(M2/BCB) + \ln(Dívida/BCB)]

onde:

• BCB = Fed + ECB + BoJ + BoE (normalizado na base 2010-01).
• ΔSₒ = variação percentual mensal do Sₒ.

Fases Econômicas

Fase	ΔSₒ	Interpretação
I. Expansão	0 ≤ ΔSₒ < 5	Crescimento monetário
II. Excesso	ΔSₒ ≥ 5	Liquidez em abundância
III. Saturação		ΔSₒ
IV. Correção	-5 ≤ ΔSₒ < 0	Contração monetária
V. Reequilíbrio	ΔSₒ < -5	Ajuste pós-crise

8. SAÍDAS

📘 TAVO_REAL_GLOBAL_AUTO_V3.xlsx

Arquivo mestre com 6 a 8 abas:

Aba	Conteúdo
1. Dados_Reais	Séries econômicas coletadas
2. Cálculos	Sₒ, ΔSₒ, Fases e Sinais
3. Pivot_Fase_Ano	Contagem de meses por fase e ano
4. Backtests	Precisão e MAPE por corte histórico
5. Portfolio_Fases	Alocação recomendada
6. Resumo_Executivo	Indicadores e recomendações finais

📊 export_calculos_global.csv

Formato simples para integração no Painel TAVO 2.0:

Data	Ouro_USD_oz	Sₒ_Global	ΔSₒ	Fase	Sinal
2025-10-31	2750	394.1	1.1	I. Expansão	↑

🪵 logs/tavo_run_YYYYMMDD.txt

Registro automático de cada execução (hora, duração, status, erros).

9. LEITURA OPERACIONAL (INTERPRETAÇÃO)

Fase	Estratégia	Posição Ouro	Posição Ações	Política
I. Expansão	Crescimento saudável	15–25%	40–50%	Moderada
II. Excesso	Liquidez exagerada	50–60%	20–25%	Contracionista
III. Saturação	Mercado neutro	30–35%	30–35%	Estável
IV. Correção	Contração fiduciária	10–20%	45–50%	Restritiva
V. Reequilíbrio	Retomada	20–25%	45–50%	Acomodativa

10. EXEMPLO DE EXECUÇÃO

Terminal:

🚀 INICIANDO TAVO ENGINE 3.0 - REAL GLOBAL AUTO

📡 Coletando dados de todas as fontes...

✅ M2SL: 680 observações

✅ WALCL: 680 observações

✅ ECBASSETSW: 680 observações

🧮 Calculando índices Sₒ...

📊 Classificando fases...

💾 Gerando arquivo final...

✅ export_calculos_global.csv criado com sucesso!

📅 Período: 1970-01 → 2025-10

📈 Fase Atual: I. Expansão Inicial ↑

💰 Ouro: $2,750/oz

📉 Sₒ Global: 394.1

🎯 Precisão média: 73.6%

💡 Recomendação: COMPRA AGRESSIVA

11. INTEGRAÇÃO COM PAINEL TAVO 2.0

Função	Entrada	Saída
Atualização automática	tavo_auto_update.py	export_calculos_global.csv
Ingestão de dados	export_calculos_global.csv	Banco TAVO_DB
Exibição visual	Dashboard IA / Streamlit	Sₒ, ΔSₒ, Fases, Alertas
Log de auditoria	logs/	Histórico de execução

💡 Dica:Configure o painel para importar o CSV diário ou mensalmente, lendo os campos Data, Sₒ_Global, Fase e Sinal.

12. SEGURANÇA E AUDITORIA

• Cada execução gera log com:
  
• Data e hora
• Status da coleta
• Séries falhadas e fallbacks usados
• Duração total
• 
  
• Os arquivos são imutáveis após gravação (checksum hash).
• Auditor pode reproduzir qualquer análise via python tavo_auto_update.py --replay <data> (versão futura).

13. MANUTENÇÃO

Tarefa	Frequência	Comando
Atualizar bibliotecas	3 meses	pip install --upgrade -r requirements.txt
Limpar cache antigo	6 meses	del outputs\*.bak
Backup dos logs	Mensal	Copiar /logs para diretório seguro
Reprocessar histórico completo	Sob demanda	python tavo_auto_update.py --rebuild

14. RECOMENDAÇÃO DE USO

• Executar 1x por mês (após o dia 10), quando todos os dados FRED estão publicados.
• Monitorar ΔSₒ mensal e alertas de mudança de fase.
• Usar os pesos de portfólio dinâmico no Painel TAVO 2.0.
• Gerar relatórios automáticos com IA (TAVO Report Module).

15. PRÓXIMOS MÓDULOS (PLANO DE EXPANSÃO)

Módulo	Descrição	Status
PBoC Integration	Inclusão da China no BCB Global	🚧 Em desenvolvimento
SNB Integration	Inclusão da Suíça (ouro como ativo de reserva)	🚧 Planejado
TAVO API REST	Comunicação com painel via JSON	⚙️ Beta
Streamlit Dashboard	Visualização em tempo real	⚙️ Beta
Fundo Quantitativo TAVO	Aplicação prática do portfólio dinâmico	🎯 Estratégico

16. SUPORTE E CONTROLE DE VERSÃO

Item	Valor
Versão atual	3.0 (Outubro/2025)
Próxima release	3.1 (com PBoC e SNB)
Autor	Dante Vitoriano Locatelli
Revisor Técnico	Grok Analytical Systems
Local	São Paulo – Resende – Global Cloud Node
Licença	Creative Commons BY-NC-SA 4.0
Sistema-Base	TAVO 2.0 (Painel e IA analítica)

17. CONCLUSÃO

TAVO REAL GLOBAL AUTO V3.0 representa o ponto de maturidade do sistema de leitura fiduciária global.

Ele une ciência, autonomia e previsibilidade — o mundo quantificado como espelho monetário.

Com ele, o Sistema TAVO 2.0 se torna autossuficiente para:

• Analisar o passado com precisão,
• Prever o presente com confiança,
• E antecipar o futuro com base em dados reais.

📘 Assinado digitalmente:

Dante Vitoriano Locatelli

Criador do Sistema TAVO

Data: 31 de Outubro de 2025

Versão: V3.0 – Real Global Auto