CreaRack-SL

Plan: Sistema de Auto-Informes — Workspace

Vista limpiaEditar
Funcionalidadactiveverificado 2026-04-15#architecture#reports#gemini#observability#cron#d1#workspace#saas-roadmap-2026

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:

EndpointMétodoDescripción
/api/workspace/perf-reviewGETDatos de rendimiento: queries lentas, DB stats, bloat, tenant usage
/api/workspace/finopsGETCostes: servidores, servicios, variables, métricas de uso
/api/workspace/perf-review?ai=trueGETIdem + análisis Gemini
/api/workspace/finops?ai=trueGETIdem + 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.

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

Esfuerzo estimado

FaseSesionesDependencia
A — API endpoints1Ninguna
B — D1 storage0.5Fase A
C — Página /reports2Fases A + B
D — Crons automáticos0.5Fase C
E — Informe ejecutivo1Fase 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

Referenciado desde

Inicio
Yo