Informes

El sistema de Reports de Workspace genera informes automaticos sobre el estado del proyecto, la infraestructura y la actividad del equipo. Los informes combinan datos reales con analisis de inteligencia artificial para ofrecer una vision contextualizada y accionable.

Que son los informes

Un informe es un documento generado periodicamente que resume:

• Estado de la infraestructura (servidores, servicios, uptime)
• Actividad del equipo (commits, tareas completadas, despliegues)
• Metricas del proyecto (endpoints, tests, cobertura)
• Incidencias y alertas del periodo

Cada informe incluye datos crudos y un analisis generado por IA que interpreta los datos, detecta tendencias y sugiere acciones.

Acceder a los informes

1. Ve a Reports en el menu lateral
2. Veras la lista de informes generados, ordenados por fecha
3. Haz clic en cualquier informe para ver su contenido completo

Estructura de un informe

Cada informe tiene estas secciones:

Resumen ejecutivo

Parrafo breve con las conclusiones principales. Ideal para una lectura rapida de 30 segundos.

Estado de infraestructura

• Uptime de servidores en el periodo
• Incidencias detectadas y su duracion
• Uso de recursos (CPU, memoria, disco)
• Estado de los contenedores Docker

Actividad del equipo

• Commits realizados por cada miembro del equipo
• Tareas creadas y completadas
• Pull requests mergeados
• Despliegues a produccion

Metricas del proyecto

• Numero de endpoints API
• Estado de la suite de tests
• Version actual desplegada
• Cambios significativos en el codebase

Analisis IA

La inteligencia artificial analiza los datos del informe y proporciona:

• Interpretacion: Que significan los numeros en contexto
• Tendencias: Si las cosas van mejor o peor que en periodos anteriores
• Sugerencias: Acciones recomendadas basadas en los datos

Generacion automatica

Los informes se generan automaticamente mediante cron jobs (tareas programadas):

Los scripts de generacion recopilan datos de todas las fuentes (GitHub, servidores, Workspace) y los envian al modelo de IA para el analisis.

Analisis con Gemini

El analisis de IA utiliza Google Gemini para interpretar los datos:

Tono del analisis

Puedes configurar el tono del analisis segun tu preferencia:

El toggle de tono se configura en los ajustes del informe. Cambia como la IA redacta el analisis pero no afecta a los datos subyacentes.

Que analiza la IA

• Compara metricas actuales con periodos anteriores
• Identifica anomalias (picos de errores, caidas de uptime)
• Correlaciona eventos (ej. “tras el despliegue del jueves, los errores 500 aumentaron un 15%”)
• Sugiere acciones priorizadas

Almacenamiento

Los informes se almacenan en la base de datos D1 de Cloudflare:

• Cada informe es un registro con metadatos (fecha, tipo, periodo) y contenido (HTML/Markdown)
• Los informes se conservan indefinidamente
• Puedes buscar informes anteriores por fecha o tipo

Crear un informe manual

Ademas de la generacion automatica, puedes crear un informe bajo demanda:

1. Ve a Reports
2. Pulsa Generar informe
3. Selecciona el periodo y tipo de informe
4. El sistema recopila los datos y genera el analisis
5. El informe estara disponible en unos segundos

Compartir informes

Los informes estan disponibles para todos los miembros del equipo con acceso al Workspace. Al ser documentos HTML, puedes:

• Leerlos directamente en el navegador
• Copiar secciones para enviar por email
• Referenciarlos en notas o tareas del Workspace

Buenas practicas

1. Revisar el informe diario cada manana como parte de tu rutina
2. Usar el analisis IA como punto de partida, no como conclusion final — la IA da contexto pero tu conoces los detalles
3. Crear informes manuales antes de reuniones importantes para tener datos frescos
4. Comparar informes semanales para detectar tendencias que no se ven dia a dia
5. Actuar sobre las sugerencias de la IA — si no las vas a usar, ajusta los parametros para que sean mas relevantes

Véase también

• [[workspace—dashboard]] — dashboard
• [[workspace—que-es-workspace]] — qué es Workspace
• [[crearack-tech—architecture—auto-reports-plan]] — plan de auto-reports
• [[workspace-tech—tecnico—ai-workflow]] — AI workflow
• [[workspace—noticias-alertas]] — noticias y alertas