Plan: Sistema de Auto-Informes — Workspace

Fecha: 12-04-2026 Prioridad: Post Fase 3 del SaaS Roadmap Dependencias: perf_review y finops_report (ya implementados v1.0.53)

Objetivo

Generar informes automáticos de rendimiento, costes y estado del SaaS, accesibles desde el workspace web. Informes legibles por todo el equipo (Edu, Dani, Txell) sin necesidad de terminal.

Fase A — API de informes en CreaRack Pro

Exponer los datos de los management commands como endpoints JSON.

Nuevos endpoints en CreaRack Pro:

Endpoint	Método	Descripción
`/api/workspace/perf-review`	GET	Datos de rendimiento: queries lentas, DB stats, bloat, tenant usage
`/api/workspace/finops`	GET	Costes: servidores, servicios, variables, métricas de uso
`/api/workspace/perf-review?ai=true`	GET	Idem + análisis Gemini
`/api/workspace/finops?ai=true`	GET	Idem + análisis Gemini

Auth: mismo WORKSPACE_API_KEY que ya usa /api/workspace/metrics.

Archivos a modificar:

Nuevo core/api/reports.py — reutiliza lógica de los management commands
config/urls.py — registrar nuevas rutas

Fase B — Almacenamiento de informes en Workspace D1

Guardar cada informe generado para histórico y comparación.

Nueva tabla D1:

CREATE TABLE reports (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    type TEXT NOT NULL,          -- 'perf_weekly', 'finops_monthly'
    title TEXT NOT NULL,
    data TEXT NOT NULL,          -- JSON completo del informe
    ai_analysis TEXT DEFAULT '', -- Texto del análisis Gemini
    period TEXT NOT NULL,        -- '2026-W15', '2026-04'
    created_at TEXT DEFAULT (datetime('now'))
);

Nueva CF Function: POST /api/reports/generate — llama a CreaRack Pro, guarda en D1.

Fase C — Página /reports en Workspace

Página web con visualización de informes.

Secciones:

Informe semanal (rendimiento)

Top 5 queries lentas con tendencia (mejor/peor que semana anterior)
DB stats: tamaño, conexiones, bloat
Uso por tenant: racks, dispositivos, media, storage
Análisis Gemini: recomendaciones priorizadas
Badge: “Todo OK” / “Revisar” / “Acción requerida”

Informe mensual (FinOps)

Desglose de costes con gráfico (ECharts pie/bar)
Comparativa con mes anterior (flechas arriba/abajo)
Métricas de crecimiento: nuevos usuarios, nuevos targets, storage
Análisis Gemini: recomendaciones de optimización
Coste por cliente (si hay datos suficientes)

Historial

Lista de todos los informes pasados
Click para abrir cualquiera
Comparar dos informes lado a lado

Acciones

“Generar informe ahora” — botón manual
“Descargar PDF” — export del informe actual
“Enviar por email” — envia resumen a Edu/Txell via Resend

Componentes React:

ReportsPage.tsx — página principal con tabs (Semanal/Mensual/Historial)
PerfReportCard.tsx — visualización del informe de rendimiento
FinOpsReportCard.tsx — visualización del informe financiero
ReportTimeline.tsx — historial con timeline

Fase D — Automatización

Cron semanal (rendimiento)

Lunes 09:00 — Hetzner staging llama a POST /api/reports/generate?type=perf_weekly
Genera informe con análisis Gemini
Guarda en D1

Cron mensual (FinOps)

Día 1 de cada mes 09:00 — POST /api/reports/generate?type=finops_monthly
Genera informe con análisis Gemini
Guarda en D1

Notificación (opcional)

Tras generar informe, enviar email resumen via Resend
Destinatarios: Edu + Txell
Asunto: “CreaRack — Informe semanal W15” o “CreaRack — FinOps Abril 2026”
Cuerpo: resumen ejecutivo + link al informe completo en workspace

Fase E — Informe ejecutivo para Txell

Informe simplificado mensual orientado a negocio:

Estado general del sistema (verde/amarillo/rojo)
Clientes activos y crecimiento
Coste total y tendencia
Incidentes del mes (si los hubo)
Próximas acciones recomendadas

Generado por Gemini a partir de los datos técnicos, redactado en español coloquial.

Navegación

Añadir “Informes” al sidebar del workspace, entre “Worklog” y “Mantenimiento”.

Esfuerzo estimado

Fase	Sesiones	Dependencia
A — API endpoints	1	Ninguna
B — D1 storage	0.5	Fase A
C — Página /reports	2	Fases A + B
D — Crons automáticos	0.5	Fase C
E — Informe ejecutivo	1	Fase D
Total	~5 sesiones

Stack

Backend: Django Ninja endpoints (CreaRack Pro) + CF Functions (Workspace)
IA: Gemini 3 Flash Preview (análisis y redacción)
Frontend: React islands en Astro (misma arquitectura que dashboard/maintenance)
Storage: Cloudflare D1 (tabla reports)
Gráficos: ECharts (si se reutiliza del observatory) o inline SVG simple
Email: Resend (ya integrado en CreaRack Pro)

Mantenido por: Equipo CreaRack

Véase también

[[crearack-tech—architecture—saas-metrics-architecture]] — arquitectura de métricas SaaS
[[crearack-tech—architecture—saas-roadmap-2026]] — roadmap SaaS 2026
[[crearack-tech—architecture—realtime-monitoring-plan]] — plan de monitorización en tiempo real
[[workspace-tech—tecnico—ai-workflow]] — workflow IA del workspace
[[feature—workspace—pulse-tiempo-real]] — Pulse del workspace en tiempo real