MÓDULO 1.3

🖥️ Seu primeiro relatório (modo web)

Chegou a hora de gerar de verdade. Este módulo te leva pelo caminho mais fácil: a interface web. Você sobe o app com um comando, conhece cada parte da tela, digita o nome da empresa, acompanha as 3 fases ao vivo e baixa o pacote pronto — apontando e clicando, sem decorar comandos.

6
Tópicos
30
Minutos
Iniciante
🛠️
Prática
⌨️ 1 comando ...webapp 🌐 navegador localhost:8888 🔍 Pesquisa ✍️ Síntese 🏗️ Geração 📥 Download pacote pronto Um comando abre o navegador, que roda as 3 fases e devolve os arquivos para baixar.

Diagrama ilustrativo — do comando ao download: o app web cuida das três fases e entrega o pacote no fim.

Conteúdo detalhado

1

▶️ Ligar o app web

O modo web é o jeito mais amigável de usar a ferramenta — e sobe com um único comando. Logo depois, o navegador abre sozinho na página da ferramenta.

⌨️ Subindo a interface

# lembre de ativar o venv antes
python -m strategy_factory.webapp

# o navegador abre em:
http://localhost:8888

Esse é o único comando que você precisa para usar a ferramenta pela web.

✓ Como deve ser

  • O venv está ativo (aparece (venv) na linha)
  • Você roda o comando e o navegador abre sozinho
  • A página carrega em localhost:8888

✗ Se algo travar

  • "Porta em uso"? Ele acha outra sozinho — ou use --port 9000
  • Erro de "módulo"? O venv não está ativado
  • Nada abriu? Digite o endereço na barra do navegador à mão

💡 Dica — deixe o terminal aberto

Enquanto você usa a interface, o terminal precisa continuar aberto rodando o comando — é ele que mantém o app no ar. Para desligar depois, basta fechar o terminal ou apertar Ctrl+C nele.

2

🧭 Tour da interface

Antes de rodar, vale conhecer a tela. Ela é simples de propósito: basicamente um campo, um seletor, um campo opcional e um botão. Conhecer cada parte deixa você confiante para a primeira análise.

localhost:8888
Nome da empresa (obrigatório)
Stripe
Modo
Quick (rápido) Comprehensive
Contexto (opcional)
fintech, B2B, pagamentos...
Iniciar análise →

Recriação ilustrativa da tela — não é um screenshot real do app.

📋 As quatro partes da tela

  • Campo de empresa — onde você digita o nome (único obrigatório)
  • Seletor de modo — Quick (rápido e barato) ou Comprehensive (aprofundado)
  • Campo de contexto — dicas opcionais sobre setor, porte, modelo de negócio
  • Botão iniciar — dispara a análise e começa as 3 fases
3

🏷️ Digitar a empresa

Este é o único campo obrigatório. Escreva o nome da empresa que quer analisar — por exemplo, "Stripe". É o ponto de partida de toda a análise.

📂 O nome vira a pasta dos resultados

# você digita:        Stripe
# os arquivos vão para:
output/stripe/
├── markdown/        (15 documentos)
├── presentations/   (2 apresentações)
├── documents/       (2 relatórios)
└── mermaid_images/  (diagramas)

O nome digitado vira o nome da pasta (em minúsculas) onde tudo é salvo.

✓ Bons exemplos

  • O nome conhecido da empresa: "Stripe", "Nubank"
  • O nome como o mercado a chama
  • Uma empresa por análise

✗ Evite

  • Nomes vagos ou abreviações pouco conhecidas
  • Deixar o campo em branco (é obrigatório)
  • Misturar várias empresas no mesmo campo

💡 Dica — nome ambíguo? Use o contexto

Se o nome puder confundir (existe mais de uma empresa com ele), não se preocupe: o campo de contexto, no próximo tópico, ajuda a apontar exatamente qual empresa você quer.

4

💬 Adicionar contexto

O campo de contexto é opcional, mas faz diferença. Com algumas dicas — setor, porte, modelo de negócio — você ajuda a Perplexity a pesquisar com muito mais precisão.

✍️ Exemplos de bom contexto

# exemplos de contexto útil
fintech, B2B, 200 funcionários
varejo de moda, e-commerce, mercado brasileiro
SaaS de RH, foco em PMEs, série A

Quanto mais específico, melhor o resultado — principalmente para empresas pouco conhecidas.

1

Diga o setor

Ex.: fintech, varejo, saúde, educação. Já restringe muito a pesquisa.

2

Indique o porte e o modelo

Ex.: B2B ou B2C, número de funcionários, estágio (startup, série A...).

3

Aponte o mercado, se ajudar

Ex.: mercado brasileiro, América Latina. Desfaz ambiguidade de nome.

💡 Dica — recomendado para empresas pouco conhecidas

Para marcas famosas, o nome sozinho já basta. Mas para empresas locais, novas ou de nome comum, o contexto é o que separa um relatório certeiro de um relatório genérico.

5

📊 Acompanhar o progresso

Depois de iniciar, uma barra mostra o avanço pelas três fases em tempo real. Você vê exatamente o que está acontecendo e percebe na hora quando o pacote ficou pronto.

1

Pesquisa — a Perplexity coleta dados

A barra mostra a coleta de informações sobre a empresa e o setor.

2

Síntese — o Gemini escreve

Você acompanha os documentos sendo gerados um a um.

3

Geração — os arquivos são montados

A última etapa monta apresentações, Word e diagramas, no seu computador.

⏱️ Quanto tempo leva

  • Modo Quick (rápido): cerca de 2 a 3 minutos
  • Modo Comprehensive (aprofundado): cerca de 5 a 10 minutos
  • Dica prática: não feche a aba até ver o pacote concluído

💡 Dica — a ordem importa

As fases rodam em sequência: a Síntese só começa quando a Pesquisa termina, e a Geração só no fim. Por isso a barra anda por etapas — é normal cada fase demorar um pouco antes de passar para a próxima.

6

📥 Baixar os arquivos

Este é o objetivo final: ter os arquivos em mãos. Ao terminar, a tela mostra links de download por entregável — e tudo também fica salvo na sua máquina.

🔗 Download na tela

Cada entregável (documentos, apresentações, Word e diagramas) tem o seu próprio link para baixar direto da interface.

💾 Salvo na sua máquina

Tudo também fica em output/nome-da-empresa/, mesmo que você feche o navegador.

👀 Ler na própria tela

Dá para visualizar o conteúdo dos documentos markdown direto na interface, antes de baixar.

📦 Pacote completo

15 documentos + 2 apresentações + 2 relatórios + diagramas, prontos para revisar e apresentar.

📂 Onde encontrar tudo no computador

output/stripe/
├── markdown/         (15 .md — os documentos de texto)
├── presentations/    (2 .pptx — resumo e completa)
├── documents/        (2 .docx — relatório e proposta)
└── mermaid_images/   (.png — os diagramas)

Mesmo sem baixar pela tela, os arquivos estão todos aqui.

🎯 Parabéns — você gerou seu primeiro relatório!

Com isso, você fechou o ciclo completo: entender, instalar e gerar. Na Trilha 2 você vai usar a ferramenta a fundo (linha de comando, modos e ajustes); na Trilha 3, vai explorar o que fazer com cada um dos 15 documentos.

🖥️ Resumo do Módulo

Ligar o app — python -m strategy_factory.webapp abre o navegador em localhost:8888 (ative o venv antes).
A interface — campo de empresa, seletor de modo, campo de contexto e botão iniciar.
Digitar a empresa — único campo obrigatório; o nome vira a pasta dos resultados (output/stripe/).
Contexto — opcional, mas melhora muito; informe setor, porte e modelo de negócio.
Progresso — barra ao vivo pelas 3 fases; Quick 2-3 min, Comprehensive 5-10 min.
Baixar — links por entregável; tudo salvo em output/nome-da-empresa/; markdown visível na tela.

Próximo Módulo:

Trilha 2 — Usar a Fundo — domine a linha de comando, os modos rápido e aprofundado, o uso de contexto e como retomar análises interrompidas.