PTENES
MÓDULO 1.3

🖥️ Tu primer informe (modo web)

Llegó la hora de generar de verdad. Este módulo te guía por el camino más fácil: la interfaz web. Inicias la app con un comando, conoces cada parte de la pantalla, escribes el nombre de la empresa, sigues las 3 fases en vivo y descargas el paquete listo: apuntando y haciendo clic, sin memorizar comandos.

6
Temas
30
Minutos
⬆
Principiante
🛠️
Práctica
⌨️ 1 comando ...webapp 🌐 navegador localhost:8888 🔍 Investigación ✍️ Síntesis 🏗️ Generación 📥 Descargar paquete listo Un comando abre el navegador, que ejecuta las 3 fases y devuelve los archivos para descargar.

Diagrama ilustrativo — del comando a la descarga: la app web se encarga de las tres fases y entrega el paquete al final.

Contenido detallado

1

▶️ Iniciar la app web

El modo web es la forma más amigable de usar la herramienta, y se despliega con un solo comando. Justo después, el navegador se abre solo en la página de la herramienta.

⌨️ Iniciando la interfaz

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

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

Este es el único comando que necesitas para usar la herramienta en la web.

✓ Cómo debe ser

  • ✓El venv está activo (aparece (venv) en la línea)
  • ✓Ejecutas el comando y el navegador se abre solo
  • ✓La página carga en localhost:8888

✗ Si algo se bloquea

  • ✗"¿Puerto en uso"? Encuentra otro por su cuenta — o usa --port 9000
  • ✗¿Error de "módulo"? El venv no está activado
  • ✗¿No se abrió nada? Escribe la dirección manualmente en la barra del navegador

💡 Consejo — deja la terminal abierta

Mientras usas la interfaz, el terminal debe permanecer abierto ejecutando el comando: es lo que mantiene la app en funcionamiento. Para apagarla después, basta con cerrar el terminal o presionar Ctrl+C en él.

2

🧭 Recorrido por la interfaz

Antes de ejecutarlo, conviene conocer la pantalla. Es simple a propósito: básicamente un campo, un selector, un campo opcional y un botón. Conocer cada parte te da confianza para el primer análisis.

localhost:8888
Nombre de la empresa (obligatorio)
Stripe
Modo
Quick (rápido) Comprehensive
Contexto (opcional)
fintech, B2B, pagos...
Iniciar análisis →

Recreación ilustrativa de la pantalla: no es una captura real de la app.

📋 Las cuatro partes de la pantalla

  • Campo de empresa — dónde escribes el nombre (único obligatorio)
  • Selector de modo — Quick (rápido y económico) o Comprehensive (en profundidad)
  • Campo de contexto — consejos opcionales sobre el sector, el tamaño y el modelo de negocio
  • Botón de inicio — inicia el análisis y comienza las 3 fases
3

🏷️ Escribir el nombre de la empresa

Este es el único campo obligatorio. Escribe el nombre de la empresa que quieres analizar — por ejemplo, "Stripe". Es el punto de partida de todo el análisis.

📂 El nombre se convierte en la carpeta de los 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)

El nombre que escribes se convierte en el nombre de la carpeta (en minúsculas) donde se guarda todo.

✓ Buenos ejemplos

  • ✓El nombre conocido de la empresa: "Stripe", "Nubank"
  • ✓El nombre con el que la conoce el mercado
  • ✓Una empresa por análisis

✗ Evita

  • ✗Nombres vagos o abreviaturas poco conocidas
  • ✗Dejar el campo en blanco (es obligatorio)
  • ✗Mezclar varias empresas en el mismo campo

💡 Consejo — ¿nombre ambiguo? Usa el contexto

Si el nombre puede prestarse a confusión (hay más de una empresa con ese nombre), no te preocupes: el campo de contexto, en el próximo tema, ayuda a indicar exactamente qué empresa quieres.

4

💬 Agregar contexto

El campo de contexto es opcional, pero marca la diferencia. Con algunos datos — sector, tamaño, modelo de negocio — ayudas a Perplexity a investigar con mucha más precisión.

✍️ Ejemplos de buen 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

Cuanto más específico, mejor el resultado, sobre todo para empresas poco conocidas.

1

Indica el sector

Ej.: fintech, comercio minorista, salud, educación. Ya limita mucho la investigación.

2

Indica el tamaño y el modelo

Ej.: B2B o B2C, número de empleados, etapa (startup, serie A...).

3

Indica el mercado, si ayuda

Ej.: mercado brasileño, América Latina. Deshace la ambigüedad del nombre.

💡 Consejo — recomendado para empresas poco conocidas

Para las marcas famosas, el nombre por sí solo basta. Pero para las empresas locales, nuevas o con nombres comunes, el contexto es lo que marca la diferencia entre un informe preciso y uno genérico.

5

📊 Sigue el progreso

Después de iniciar, una barra muestra el avance por las tres fases en tiempo real. Ves exactamente lo que está pasando y notas enseguida cuándo el paquete está listo.

1

Investigación — Perplexity recopila datos

La barra muestra la recopilación de información sobre la empresa y el sector.

2

Síntesis — Gemini escribe

Ves cómo se generan los documentos uno por uno.

3

Generación — se preparan los archivos

La última etapa crea presentaciones, documentos de Word y diagramas en tu computadora.

⏱️ Cuánto tiempo lleva

  • Modo Quick (rápido): alrededor de 2 a 3 minutos
  • Modo Comprehensive (detallado): alrededor de 5 a 10 minutos
  • Consejo práctico: no cierres la pestaña hasta ver que el paquete se haya completado

💡 Consejo — el orden importa

Las fases se ejecutan en secuencia: la Síntesis solo comienza cuando termina la Investigación, y la Generación solo al final. Por eso la barra avanza por etapas: es normal que cada fase tarde un poco antes de pasar a la siguiente.

6

📥 Descarga los archivos

Este es el objetivo final: tener los archivos a mano. Al terminar, la pantalla muestra enlaces de descarga para cada entregable — y todo también queda guardado en tu máquina.

🔗 Descarga en pantalla

Cada entregable (documentos, presentaciones, Word y diagramas) tiene su propio enlace para descargarlo directamente desde la interfaz.

💾 Guardado en tu máquina

Todo también queda en output/nome-da-empresa/, aunque cierres el navegador.

👀 Leer en la propia pantalla

Puedes ver el contenido de los documentos markdown directamente en la interfaz, antes de descargarlos.

📦 Paquete completo

15 documentos + 2 presentaciones + 2 informes + diagramas, listos para revisar y presentar.

📂 Dónde encontrar todo en la computadora

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)

Aunque no los descargues desde la pantalla, los archivos están todos aquí.

🎯 ¡Felicidades! Ya generaste tu primer informe.

Con esto, completaste el ciclo: entender, instalar y generar. En la Ruta 2 usarás la herramienta a fondo (línea de comandos, modos y ajustes); en la Ruta 3 explorarás qué hacer con cada uno de los 15 documentos.

🖥️ Resumen del módulo

✓
Conectar la app — python -m strategy_factory.webapp abre el navegador en localhost:8888 (activa el venv antes).
✓
La interfaz — campo de empresa, selector de modo, campo de contexto y botón de inicio.
✓
Escribe la empresa — único campo obligatorio; el nombre se convierte en la carpeta de resultados (output/stripe/).
✓
Contexto — opcional, pero mejora mucho los resultados; indica el sector, el tamaño y el modelo de negocio.
✓
Progreso — barra en vivo durante las 3 fases; Quick 2-3 min, Comprehensive 5-10 min.
✓
Descargar — enlaces por entregable; todo se guarda en output/nome-da-empresa/; el markdown está visible en pantalla.

Siguiente módulo:

Ruta 2 — Uso a fondo — domina la línea de comandos, los modos rápido y profundo, el uso del contexto y cómo reanudar análisis interrumpidos.