Consola + sitio público

Dos lugares donde Letaido coloca lo que construye: uno para tu equipo, otro para todos los demás.

1. La consola (interna)

La consola es una aplicación web exclusiva para miembros donde Letaido publica herramientas internas. Piensa en ella como el panel de control privado de tu equipo.

Accesible solo para miembros del espacio de trabajo. Los visitantes anónimos se encuentran con una pantalla de inicio de sesión.
La aplicación lee la identidad desde las cabeceras de autenticación, por lo que cada página sabe quién la está viendo (propietario, administrador, miembro, espectador).
Acceso a la base de datos: lectura/escritura completa a console_db y console_site_db. No puede acceder a site_db.

Crear una página de consola cuando:

La salida es solo para tu equipo.
Necesita consultar datos internos, llamar a conectores o mostrar controles.
Los clientes nunca deberían verla.

Informes, aplicaciones, artefactos

Todo lo que Letaido crea en la Consola se divide en una de tres categorías. La página de inicio de la Consola tiene una pestaña para cada una (Informes, Aplicaciones, Artefactos) más una pestaña de Inicio que enumera todo junto, lo más reciente primero, con la categoría como una etiqueta junto al título.

Categoría	Qué es	Qué hace tu equipo con ello	Ejemplos
Reports	Gráficos, tablas y vistas de datos filtrados	Abrirlo, leer los números, filtrar, salir	Ahrefs Brand Authority, AI Visibility, Rank Monitor
Applications	Herramientas multipágina y flujos de trabajo complejos	Pegar una entrada, ejecutar un proceso, obtener una salida, volver a ejecuciones anteriores	Battlecard Generator, AI Visibility Dashboard, Paid Ads Campaign Builder
Artifacts	Elementos únicos: un gráfico, una tabla, un fragmento de texto	Echarle un vistazo, copiarlo, compartirlo, seguir adelante	Vista previa de correo electrónico, bloque de página de inicio, sección AEO 101, Ahrefs Feature Library

Informes

Un informe es algo que abres para ver el estado de algo. El valor está en los datos mostrados; la interacción principal es leer o filtrar. Los informes se actualizan desde sus fuentes de datos según una programación o bajo demanda. Se encuentran en /reports/<slug>/.

Solicita un informe cuando la respuesta a "¿por qué existe esto?" sea "para que podamos ver X de un vistazo" (el estado de nuestras clasificaciones, la cuota de voz de esta semana, el delta de autoridad de marca de este mes).

Aplicaciones

Una aplicación es algo que usas para trabajar. El valor está en el flujo de trabajo; la interacción principal es crear, editar o producir. Las aplicaciones reciben datos de entrada, ejecutan pipelines de varios pasos, almacenan resultados y permiten que tu equipo vuelva a ejecuciones anteriores. Se encuentran en /applications/<slug>/.

Solicita una aplicación cuando la respuesta a "¿por qué existe esto?" sea "para que podamos hacer X repetidamente sin tener que reconstruir el flujo de trabajo cada vez" (generar una ficha de batalla, ejecutar un brief de campaña, producir un texto).

Artefactos

Un Artefacto es una única pieza de salida que insertas una vez y referencias después. Es pequeño, autónomo y no vale la pena envolverlo en una aplicación o informe completo. Los Artefactos se encuentran en /artifacts/<slug>/.

Solicita un Artefacto cuando la respuesta a "¿por qué existe esto?" sea "para que el equipo tenga un lugar donde verlo" (una vista previa de un bloque de página de inicio, el correo electrónico de esta semana, una biblioteca de funcionalidades, un documento de una página para ventas).

¿No estás seguro de cuál quieres?

Describe el resultado y el agente elige el bucket correcto.

"Muéstrame la autoridad de marca semanal por competidor". → Informe.
"Créame una herramienta donde pegue la URL de un competidor y obtenga una ficha de batalla". → Aplicación.
"Genera una vista previa del boletín de la próxima semana". → Artefacto.

2. El sitio público (externo)

El sitio público es la parte de tu espacio de trabajo a la que puede acceder internet abierto, completamente aislada de la consola que usa tu equipo. Existe para servir contenido a personas fuera de tu espacio de trabajo.

Patrón de URL: /<route> para todo. Patrones convencionales: /u/<token> para informes compartidos únicos, /r2s/<token> para ejecuciones revisadas, /docs/<slug> para esta documentación.
La visibilidad se controla mediante un interruptor a nivel de espacio de trabajo (consulta Modos más abajo).
Acceso a la base de datos: lectura/escritura site_db (es su propietaria). Lectura/escritura console_site_db. No puede acceder a console_db.

Crea una página de sitio público cuando: - Un cliente, prospecto o visitante anónimo necesite ver algo. - Quieras una URL que se pueda compartir fuera del correo electrónico o Slack. - Los datos ya se hayan generado (en la consola o mediante un trabajo) y solo los estés sirviendo.

Tres modos para el sitio público

El sitio público tiene tres estados, que un propietario o administrador puede cambiar desde la interfaz del espacio de trabajo. El agente en sí no puede cambiarlos.

off: nginx devuelve 403 a todo el mundo. El proceso Flask sigue ejecutándose; no le llega ningún tráfico.
authorized: los miembros del espacio de trabajo y los invitados explícitamente invitados pueden verlo. Útil para revisar antes de un lanzamiento.
open: cualquiera con la URL puede verlo. Trata a cada visitante como no confiable.

Cuando el modo es open, el agente aplica valores predeterminados adicionales: validación de Pydantic en cada entrada del visitante, sin llamadas de conector por visitante (se almacena en caché en site_db en su lugar), aprobaciones de conector separadas para la superficie del sitio, y la salida visible se desinfecta antes de la persistencia.

Comunicación entre superficies

La consola y el sitio público se ejecutan en procesos diferentes. Aún pueden cooperar, pero solo a través de un canal explícito: la base de datos console_site_db.

La consola escribe datos (un informe, un resumen, un artefacto) en una tabla.
El sitio público lee esa tabla y la renderiza en una URL protegida por token.
El sitio puede escribir señales de interacción (por ejemplo, "el visitante hizo clic") que la consola lee.

El agente NO intenta hacer pasar una consulta de Console por una ruta pública. El REVOKE está en la capa de base de datos; fallaría de todos modos, y además sería un diseño incorrecto.