🧾 A interface mínima
A tela da Fábrica tem só quatro elementos. Essa pobreza é proposital: a promessa "entrada mínima, saída máxima" precisa parecer fácil. O cliente vê duas caixas e um botão — e recebe um pacote de consultoria.
📊 Os quatro elementos
- •Nome da empresa — o alvo da análise (ex.: "Stripe", "padaria do bairro").
- •Descrição — contexto curto: setor, modelo de negócio, porte.
- •Profundidade — alternador quick (~US$0,05) vs deep (~US$0,50).
- •Botão enviar — dispara o pipeline de 3 fases.
o alvo
o contexto
o custo
o gatilho
🚀 Rodar a webapp local
Um comando sobe um servidor Flask e abre o navegador. A partir daí, a Fábrica deixa de ser código e vira uma tela onde você (ou o cliente, numa demo) digita e clica.
// terminal — subir a interface web
source venv/bin/activate # macOS/Linux python -m strategy_factory.webapp # abre automaticamente em http://localhost:8888 # porta ocupada? ele acha outra, ou: --port 9000
💡 Dica prática
Não sabe rodar isso? Peça ao Claude Code: "suba a webapp da Fábrica e abra no navegador". Ele ativa o ambiente, instala o que faltar e resolve o erro de porta. Você só assiste a tela aparecer.
🎬 Por que rodar ao vivo importa
Numa reunião, digitar o nome do cliente e ver a Fábrica trabalhar na hora é prova irrefutável. Vale mais que qualquer slide explicando "como funciona" — porque acontece na frente dele.
servidor local
porta padrão
no navegador
prova na hora
📡 Progresso em tempo real + download
Enquanto o pipeline roda, a tela não fica congelada. O servidor usa Server-Sent Events (SSE) para empurrar cada etapa ao navegador. No fim, todos os assets aparecem prontos para baixar.
POST /start
O envio dispara o pipeline numa thread em segundo plano e o navegador é levado à página de progresso.
GET /progress/{job_id} (SSE)
Um fluxo de eventos transmite "pesquisando…", "sintetizando…", "gerando…" — a barra avança em tempo real.
Resultados + download
Ao concluir, os arquivos (markdown, PPTX, DOCX, PNGs) ficam disponíveis para baixar individualmente ou em pacote.
💡 Por que SSE e não só "aguarde"
Uma barra que avança gera confiança: o usuário vê que algo real acontece, não uma tela travada. Em pipelines de minutos, feedback ao vivo é o que separa "profissional" de "será que quebrou?".
eventos ao vivo
rastreia a sessão
roda em fundo
assets prontos
🗂️ Organizar o pacote por pastas
A saída não é um amontoado de arquivos: vem estruturada em output/{empresa}/ com subpastas por tipo. Um pacote organizado transmite cuidado — e cuidado é parte do que o cliente compra.
// estrutura gerada por empresa
output/stripe/ ├── markdown/ # 15 documentos .md ├── presentations/ # 2 decks .pptx ├── documents/ # 2 relatórios .docx (Relatório + SOW) ├── mermaid_images/ # diagramas estado atual vs futuro (.png) ├── research_cache.json └── state.json # progresso e custo total
✓ Pacote bem organizado
- ✓Subpastas claras por tipo de entregável
- ✓Nomes numerados na ordem de leitura
- ✓Decks e relatórios no topo, anexos abaixo
✗ Pacote bagunçado
- ✗15 arquivos soltos na mesma pasta
- ✗Nomes técnicos crus (deliverable_07_v2.md)
- ✗Sem indicação de por onde começar
15 docs
2 decks
relatório + SOW
progresso
🎨 Marca: deixar com a sua cara
O pacote é o seu produto, não o da ferramenta open source. Trocar logo, cores e capa transforma "uns arquivos gerados" em "o entregável da [seu nome] Consultoria". A marca é o que o cliente lembra.
Logo e capa
Adicione seu logo no slide de capa do deck e na primeira página dos documentos Word. Identidade já na abertura.
Paleta de cores
No pptx_generator.py, os RGBColor definem a paleta dos slides. Ajuste para as suas cores de marca.
Rodapé e contato
Rodapé com seu nome, site e contato em cada página. O cliente sabe a quem voltar quando quiser mais.
// o que pedir ao Claude Code
No gerador de PPTX, troque a paleta para azul-marinho (#0B1F3A) e dourado (#C9A24B), ponha meu logo "logo.png" na capa e um rodapé com "Acme Consultoria de IA · acme.com.br".
na capa
RGBColor
seu contato
seu produto
📬 Hospedar / entregar o pacote
O último toque é a entrega. Compactar, hospedar e mandar com uma nota curta de leitura guiada faz o cliente sentir que comprou um serviço, não que ganhou uma pasta de arquivos.
🗜️ Compactar
Um .zip com a pasta organizada, nomeado pelo cliente e data: acme-estrategia-ia-2026.zip.
☁️ Hospedar
Subir num Drive, Notion ou pasta com link compartilhável. O cliente acessa de qualquer lugar.
📝 Nota guiada
Mensagem curta: "comece pelo Executive Summary, depois o roadmap. SOW anexo para a proposta."
💡 Dica de entrega
Nunca mande "tá aí, segue o link". Mande a leitura guiada: por onde começar, o que cada peça responde e qual é o próximo passo. A curadoria da entrega é parte do serviço — e prepara o terreno para o fechamento.
pacote único
acesso fácil
leitura guiada
é um serviço
✅ Resumo do módulo
🎯 Missão 5.1 — Pacote com a sua identidade
Gere e empacote um pacote com a sua cara:
- Suba a webapp e rode 1 empresa em modo quick.
- Troque logo, cores e rodapé do deck para a sua marca.
- Organize a pasta e compacte em um .zip nomeado.
- Escreva a nota de leitura guiada (3-4 linhas).
Sucesso: um .zip com a sua identidade e uma nota de entrega. O que você ganhou: um entregável que já parece seu produto — pronto para mandar a um cliente.
Próximo módulo:
5.2 — Posicionamento, oferta e preço (nicho, produtizar e quanto cobrar)