Resumo Executivo da Ferramenta

Versão: 0.7.0 Canal: internal Atualizado: 2026-02-28

Releases

Release selecionado: v0.7.0.md

# Release v0.7.0 - Hotmart enriquecido + timeline de vendas

## Entregas
- Schema de transacoes expandido com dados do comprador, endereco, produto, pagamento e valores.
- Persistencia local com migracao automatica de colunas.
- Filtro por origem mantido (`escritorio` / `educacao`).
- Dashboard de linha do tempo (30 dias): total de eventos e aprovados.
- KPI de volume, aprovados, bruto e liquido no modulo Transacoes.
- Endpoint de timeline: `GET /hotmart/transactions_timeline`.

## Supabase
- SQL atualizado em `docs/supabase/hotmart_transactions.sql` com todos os campos.
- Com chave anon/publishable nao e possivel executar DDL diretamente via REST.

Guia do Usuário

# Guia do Usuario - Growth Agent

## O que e a ferramenta
Growth Agent e um orquestrador de marketing e growth que transforma um prompt livre em plano de acao executavel.

## Como funciona
1. Voce envia um prompt no Chat.
2. O Planner define quais agentes e ferramentas chamar.
3. O Executor roda a cadeia, guarda memoria por thread e gera artefatos.
4. O sistema retorna resposta final + trace + relatorio consolidado.

## Agentes
- strategic_agent: define estrategia, angulo, hipoteses e proximos testes.
- diagnostic_agent: identifica gargalos de funil e causa raiz.
- production_agent: transforma estrategia em ativos prontos.
- research_agent: pesquisa concorrencia e sinais de mercado.

## Ferramentas
- Meta Ads Library / Marketing API (quando configurado)
- ClickUp (quando configurado)
- Sistema de relatorios em /outputs
- Memoria por thread em /memory/threads

## O que pode fazer hoje
- Diagnosticar performance com contexto de marca fixo.
- Gerar estrategia estruturada e planos de teste.
- Produzir ativos (copy, estrutura, variacoes).
- Consolidar historico de conversas e outputs por thread.

## Limites e governanca
- Dependencias externas exigem tokens validos.
- Recomendacoes financeiras/comerciais sem garantia de resultado.
- Promessas devem respeitar restricoes legais configuradas no contexto de marca.

Fluxo operacional (orquestrador)

Prompt Planner Diagnóstico Estratégia/Produção Executor Output

CHANGELOG

# Changelog

## v0.7.0 - 2026-02-28
- Schema Hotmart expandido com campos de comprador, endereco, produto, pagamento e valores.
- Migracao automatica do banco local (`memory/hotmart_transactions.db`) para novas colunas.
- Modulo Transacoes com tabela ampliada e filtro por origem.
- Dashboard de linha do tempo de vendas (30 dias) com total e aprovados.
- Endpoint `GET /hotmart/transactions_timeline`.
- SQL Supabase atualizado em `docs/supabase/hotmart_transactions.sql`.

## v0.6.0 - 2026-02-28
- Novo modulo `Transacoes` na interface para monitorar eventos Hotmart.
- Webhooks de ingestao criados para duas origens:
  - `/webhooks/hotmart/escritorio`
  - `/webhooks/hotmart/educacao`
- Persistencia local em `memory/hotmart_transactions.db`.
- Filtro por origem (`escritorio`/`educacao`) na tabela do modulo.
- SQL de criacao da tabela Supabase em `docs/supabase/hotmart_transactions.sql`.
- Campo extra de contexto: `origin_account`; payload completo preservado em JSON.

## v0.5.0 - 2026-02-28
- Aba Historico com visualizacao de threads, conversas, relatorios e variaveis consolidadas.
- Aba Resumo com guia executivo, versao atual, releases e diagrama de fluxo da arquitetura.
- Estrutura de versionamento em docs/version.json + docs/releases.
- Script de versao: scripts/new_version.py.