Feature Catalog — CreaRack Pro v1.0.51

Punto Cero: Inventario exhaustivo de todas las capacidades de la plataforma. Fecha de corte: 07-04-2026 Propósito: Documento de referencia para entender qué puede hacer CreaRack Pro hoy.

Resumen Ejecutivo

CreaRack Pro es una plataforma SaaS para diseño, gestión y monitorización de datacenters. Integra diseño visual de racks y planos, monitorización de red en tiempo real con IA, terminal SSH remoto, señalización digital y gestión ITSM — todo en una sola aplicación multi-tenant.

1. Rack Editor

Diseñador visual de racks de servidor con canvas Konva.js interactivo.

Capacidades

• Editor visual: Canvas 2D con drag & drop de dispositivos en slots U
• Dispositivos half-width: Soporte para dispositivos de medio ancho (izquierda/derecha en cada U)
• Biblioteca de stencils: Biblioteca de imágenes de dispositivos (sistema + custom por organización)
• Importación Visio: Pipeline de 2 pasos (analizar → confirmar) para importar .vssx/.vdx/.vss/.svg como stencils
• Templates de rack: Cualquier rack puede marcarse como template y aplicarse para crear nuevos racks pre-poblados
• Propiedades de dispositivo: IP de gestión (cifrada con Fernet), estado, categoría, datos custom en JSON
• Conexiones de puertos: Mapeo visual de conexiones puerto a puerto con metadatos de cable (tipo, color, longitud)
• Tabla de puertos: Vista de puertos por dispositivo con LEDs de estado, nombres de dispositivo conectado, navegación cross-rack
• SSH directo: Botón SSH en cada dispositivo que abre sesión de terminal
• SFTP integrado: Navegador de archivos remoto dentro del editor
• Config backups: Snapshots de configuración de dispositivos con diff, restore y SHA256 change detection
• Auto-Provision: Panel wizard para descubrimiento automático de dispositivos
• Undo/Redo: Historial completo de operaciones
• Exportación: CSV (inventario), JSON (rack individual), ZIP (backup completo cross-app)
• Etiquetas: Generación de datos para etiquetado físico de racks y dispositivos
• Papelera: Soft-delete con restauración
• Grupos de racks: Agrupación lógica con colores

Modelos

• Rack — Cabinet con nombre, ubicación, altura (U), potencia (kWh), estado, grupos, soft-delete, template flag
• Device — Dispositivo en rack con posición U, IP cifrada, estado, model_data JSON
• Stencil — Imagen de dispositivo (global o per-org), fabricante, categoría, altura U
• BoxCategory — Categorización de dispositivos
• RackGroup — Grupo lógico con color
• ConfigBackup — Snapshot de configuración con hash SHA256, tipo (auto/manual/pre-change)

2. Map Editor (Blueprints)

Editor de planos de infraestructura con canvas Konva.js infinito.

Capacidades

• Canvas infinito: Pan, zoom, multi-selección con Konva.js
• 9 herramientas de dibujo: Selección, Línea, Línea punteada, Rectángulo, Círculo, Flecha, Texto, Cable, Rack
• Colocación de racks: Drag & drop de racks existentes sobre el plano con posición y rotación
• Cables entre racks: Routing Manhattan (ortogonal) o Smooth (curvo) con pathfinding A*
• Anotaciones: Muros, zonas, etiquetas de texto, símbolos de red, bloques de título
• Catálogo de símbolos: Routers, switches, firewalls y otros símbolos de red arrastrables
• Imagen de fondo: Upload de planos escaneados como fondo con escala y opacidad configurables
• Auto-Plan AI: Sube una imagen de plano → la IA extrae racks, cables, muros y anotaciones automáticamente
• 3 proveedores IA: Gemini 3 Flash Preview (principal), DeepSeek V3 (fallback), Ollama (self-hosted)
• Prompts guardados: Sistema Save As para prompts de IA personalizados
• Clonación: Deep-copy completo de un plano con todas las colocaciones y anotaciones
• Configuración de cables: Estilo (spread, curvatura, grosor), modo de routing, modo oscuro
• Undo/Redo: Historial completo via MapHistoryAdapter
• Papelera: Soft-delete con restauración (cascadea a racks huérfanos)

Modelos

• Blueprint — Mapa con fondo, escala, opacidad, estilos de cable, routing mode, dark mode, soft-delete
• BlueprintPlacement — Posición (x,y) + rotación de un rack en un plano
• MapAnnotation — Anotación genérica (muro, texto, zona, símbolo, cable, título) como JSON
• AIPrompt — Prompt de IA guardado por organización

3. Network Observatory

Dashboard de monitorización de red en tiempo real con 4 ámbitos especializados.

Capacidades Generales

• Monitorización multi-protocolo: ICMP ping, SNMP v2c/v3, HTTP health checks
• Métricas en tiempo real: WebSocket push de latencia, pérdida, bandwidth, CPU, memoria, temperatura
• VictoriaMetrics: Almacenamiento time-series de largo plazo (180 días)
• Gráficas ECharts: CPU, memoria, bandwidth, latencia, disponibilidad, heatmaps, gauges
• Controles de gráficas: Zoom brush, data labels, pausa/reanudación, umbrales arrastrables
• Expert Charts: Vista expandida con gráficas sincronizadas
• Rankings: Ranking de dispositivos por rendimiento
• Alertas: Reglas configurables (latencia, pérdida, bandwidth, HTTP, down-duration) con severidad
• Eventos de alerta: Historial con acknowledgement y resolución
• Dashboard GridStack: Widgets arrastrables y redimensionables, layout persistido por usuario
• Notas por dispositivo: Anotaciones de operador
• Deep Discovery SNMP: Descubrimiento profundo de hardware por MIBs de fabricante
• Reportes: HTML + Print + CSV por dispositivo y fleet
• Heatmap de disponibilidad: Mapa de calor 24h cross-target

4 Ámbitos de Monitorización

Grupos de Dispositivos

• Crear grupos por ámbito (Wireless, UPS, Signage)
• Métricas agregadas por grupo (suma para conteo/throughput, media para dBm)
• Tabla SSID con conteo de clientes (Wireless)
• Stat cards por grupo con valores agregados

Modelos

• MonitoringTarget — Dispositivo monitorizado (1:1 por org+IP; sin campo scope desde Ficha Central F4 — la página la decide DeviceProfile.assigned_page), cacheo de último estado
• MetricSample — Dato crudo time-series
• AggregatedMetric — Agregado horario (avg/min/max)
• MonitoringAlert — Regla de alerta con 9 tipos de condición
• AlertEvent — Evento disparado con resolución y ACK

4. CreaRack Network Sentinel (CNS)

Sistema de inteligencia artificial para diagnóstico de incidentes de red.

Capacidades

• Diagnósticos IA: Generación automática de insights con caso CNS-XXXXXX
• Multi-proveedor IA: Claude (Anthropic), Gemini (Google), Ollama (self-hosted), reglas estáticas como fallback
• Ciclo de vida de insights: pending → executing → applied/acknowledged/failed/expired
• Dry-run: Preview de comandos sin ejecutar
• Aplicación de comandos: Ejecución de comandos CLI recomendados en dispositivos vía SSH
• Rollback: Comandos de reversión por insight
• Explain Q&A: Conversación de seguimiento con IA por insight
• Capa OSI: Clasificación por capa OSI del problema
• Nivel de riesgo: LOW / MEDIUM / HIGH con SLA deadlines
• Escalamiento: Escalamiento automático de insights no resueltos
• Auditoría completa: Trail de cada acción (created, applied, dry_run, rollback, expired)
• Validación de comandos: Guard de seguridad antes de ejecutar CLI
• Network Tutor: Tutor IA interactivo dentro del Observatory
• Scoped por ámbito: CNS funciona en Observatory, Wireless, UPS y Signage

Modelos

• AIInsight — Diagnóstico IA con caso, root cause, capa OSI, comandos, riesgo, SLA, estado
• AIInsightAuditLog — Trail de auditoría por acción
• InsightConversation — Hilo Q&A por insight

5. ITSM (IT Service Management)

Módulo completo de gestión de servicios IT integrado con CNS.

Capacidades

• SLA Policies: Políticas de tiempo de respuesta y resolución con detección de breach
• Canales de notificación: Configurables con test integrado
• Políticas de escalamiento: Cadenas de escalamiento automático
• Ventanas de mantenimiento: Programación de ventanas que suprimen alertas
• Grupos de incidentes: Correlación automática de alertas relacionadas
• Known Issues: Base de conocimiento de problemas conocidos
• Runbooks: Procedimientos operativos vinculables a insights
• Patrones: Detección de patrones recurrentes de fallos
• Analytics: Dashboards de métricas ITSM
• Reportes: Descarga de informes Markdown

Modelos

• SLAPolicy, NotificationChannel, EscalationPolicy, MaintenanceWindow
• IncidentGroup, KnownIssue, Runbook, InsightLink, Pattern

6. Auto-Provision Tool

Pipeline de descubrimiento y aprovisionamiento automático de dispositivos de red.

Capacidades

• Descubrimiento multi-protocolo: SNMP v2c/v3 + SSH (Scrapli) + LLDP/CDP neighbors
• Descubrimiento bulk: Múltiples IPs simultáneamente
• Deep Discovery: MIBs de fabricante para hardware detallado (CPU, memoria, VLANs, sensores, radios WiFi)
• SNMPv3 completo: Auth (MD5/SHA/SHA-256/SHA-512) + Priv (DES/AES-128/AES-192/AES-256)
• Scoring de confianza: 0-100% basado en datos recopilados
• Stencil matching: Fuzzy matching de fabricante/modelo con stencils del rack
• Base de fabricantes: 40+ vendor profiles pre-cargados (Cisco, Juniper, Xirrus, Cambium, SpinetiX, etc.)
• Fast Poll OIDs: OIDs ligeros para polling a 15 segundos
• MIBs custom: Upload de archivos ASN.1, compilación y uso en deep discovery
• MIB Assistant: Interpretación asistida por IA de MIBs y OIDs
• MAC OUI Lookup: Resolución de fabricante por prefijo MAC (base IEEE)
• Wizard de 3 destinos: Enviar dispositivos descubiertos a Racks, Wireless, Observatory y/o UPS simultáneamente
• Auto-clasificación: Clasificación automática del tipo de dispositivo

Modelos

• VendorProfile — Base de datos de fabricantes con patterns SNMP, OIDs, SSH commands
• CustomMib — MIB ASN.1 subido por usuario
• DeviceProfile — Perfil completo de dispositivo descubierto con scoring

7. Port Management

Gestión de conexiones de puertos y cableado.

Capacidades

• Conexiones port-to-port: Mapeo dispositivo-a-dispositivo y dispositivo-a-perfil descubierto
• Metadatos de cable: Tipo, color, longitud por conexión
• Auto-suggest LLDP/CDP: Sugerencia automática de puerto basada en datos LLDP/CDP
• Cable Report: Informe de planta de cables en JSON, Markdown y HTML standalone
• Topología Mermaid: Diagrama auto-generado de topología inter-rack
• Port Config Reader: Lectura de configuración de puertos vía SNMP y SSH en paralelo
• Cisco multi-slot: Soporte correcto de puertos en switches multi-slot
• SSH VLAN supplement: Lectura de VLANs por SSH cuando SNMP no las expone

Modelos

• PortConnection — Conexión de puerto con cable metadata, constraint XOR (un target por conexión)

8. Config Backup System

Backup y gestión de configuraciones de dispositivos de red.

Capacidades

• Backup por SSH: Trigger de backup de running-config vía SSH (Scrapli)
• Diff entre backups: Comparación visual de dos snapshots de configuración
• Restauración: Restore de configuración desde backup
• Change detection: Hash SHA256 para detectar cambios
• Tipos: auto, manual, pre-change
• Descarga: Download de configuración como archivo

9. Script Engine

Motor de ejecución de scripts en dispositivos de red.

Capacidades

• Templates reutilizables: Scripts guardados por fabricante y categoría
• Ejecución SSH: Ejecución remota en cualquier dispositivo gestionado
• Scripts semilla: Pack de scripts predefinidos para operaciones comunes
• Multi-vendor: Soporte Cisco IOS, JunOS, Aruba, Bash, Python
• Cluster execution: Ejecución simultánea en múltiples dispositivos

10. Terminal SSH

Terminal SSH completo en el navegador con multi-panel.

Capacidades

• Terminal xterm.js: Emulador de terminal completo en el navegador
• WebSocket SSH: Conexiones SSH vía Django Channels + asyncssh
• Multi-pane: Layouts de múltiples paneles con resize arrastrable
• Cluster Mode: Broadcast de comandos a múltiples hosts simultáneamente
• Conexión manual: Diálogo para SSH a cualquier host/puerto
• Tabs: Gestión de múltiples sesiones en pestañas
• Configuración: Fuente, tema y comportamiento personalizables
• Toolbar: Copiar, pegar, limpiar, ajustes

11. Local Agent (CreaRackAgent.exe)

Agente Windows instalable on-premises que conecta la red local con el SaaS.

Capacidades

• ~45 endpoints REST + 3 WebSocket
• Sentinel Mode 24/7: Monitorización continua con ping, SNMP fast-poll, bandwidth, extras
• Fleet Primary/Secondary: Failover automático entre agentes (el más antiguo online se promueve)
• JWT Auth: Registro, autenticación y refresh de tokens
• SSH Terminal: WebSocket terminal SSH desde el agente
• SFTP: Navegador de archivos remoto (list, download, upload, read, write)
• Network Discovery: Ping batch, port scan, subnet discovery, ARP table, banner grab
• SNMP Discovery: Discover + deep discover + probe OIDs
• HTTP Fingerprint: Identificación de servicios web
• Cluster Execution: Ejecutar comandos/scripts en múltiples hosts
• SNMP Traps: Receptor UDP de traps SNMP
• Signage Deploy: Push de contenido a players vía WebDAV/REST
• Offline Cache: Buffer de métricas cuando el SaaS no es accesible
• SQLite local: Almacenamiento local de time-series
• Multi-org: Un agente puede asociarse a múltiples organizaciones SaaS
• Anomaly Detection: Detección de anomalías para CNS
• Auto-uninstall: Endpoint de auto-desinstalación

12. Digital Signage CMS

CMS completo de señalización digital multi-vendor.

Capacidades

• Gestión de contenido: Upload de imágenes, vídeos, HTML5, URLs, live streams con thumbnails y transcoding
• Playlists: Constructor visual con drag & drop, duraciones por item, 9 transiciones (dissolve, slide, zoom, cut, etc.)
• Schedules: Programación por horario, día, rango de fechas con prioridades y timezone
• SVG Composer: Generación de proyecto SVG dinámico con capas (imagen, texto, ticker, color, overlay)
• SMIL Generator: XML SMIL estándar W3C para players compatibles
• Deploy Manager: Wizard de 3 pasos (contenido → dispositivos con Select All → review con progress bar)
• Display Control: Power on/off, volumen, brillo, fuente de entrada, reboot — vía Samsung MDC, LG Protocol, PJLink
• Proof-of-Play: Evidencia de reproducción con screenshots, informes JSON/HTML/CSV
• 12 adaptadores vendor: SpinetiX, BrightSign, Samsung, LG, Crestron, Philips, IAdea, Barco, Christie, NEC/Sharp, Yodeck, Signagelive
• VAL (Vendor Abstraction Layer): Capa de abstracción para múltiples protocolos de push (WebDAV, REST, cloud, SMIL)
• Transcoding: H.264 1080p/720p + H.265 4K vía ffmpeg background tasks
• SpinetiX Scheduled Download: Configuración automática del SpinetiX para polling de contenido desde CreaRack
• Operaciones con rollback: Historial de todas las operaciones (publish, pause, black screen, test pattern) con estado previo

Portal de Clientes

• Acceso PIN-protegido: URL única con token + PIN por cliente
• Upload de contenido: Clientes pueden subir imágenes/vídeos directamente
• Reordenamiento de playlists: Drag & drop desde el portal
• Workflow de aprobación: Cambios del cliente quedan pending hasta aprobación del staff
• Permisos granulares: Upload, reorder, schedule configurables por cliente
• Proyectos: Agrupación de dispositivos + playlists por cliente

Modelos

• SignageVendorAdapter — Config global por vendor (API, auth, push, display control)
• SignagePlayer — Player físico con adapter, playlist/schedule actual, publish token
• MediaAsset — Contenido con estado (uploading → processing → ready), variantes transcodificadas
• Playlist — Lista ordenada con transiciones y duración auto-calculada
• Schedule — Reglas temporales con prioridad y timezone
• ContentDeployment — Tracking de push con resultados per-player
• PlaybackLog — Proof-of-play por asset por player
• SignageOperation — Auditoría de operaciones con rollback
• ClientProject — Proyecto de cliente con permisos
• ClientShareLink / PortalChangeLog — Enlaces compartidos y log de cambios del portal

13. Credential Store

Almacén cifrado de credenciales reutilizables.

Capacidades

• Multi-sección: SNMP v2c + v3 + SSH + HTTP en un solo registro
• Cifrado Fernet: AES encryption para todos los secretos
• Auto-fill: Relleno automático en wizard de Auto-Provision
• CRUD completo: 5 endpoints API
• Per-org: Aislamiento por organización

Modelos

• StoredCredential — Credencial multi-sección cifrada con Fernet

14. Autenticación y Seguridad

Métodos de Autenticación

• Password tradicional con hash
• Passkeys (WebAuthn): Windows Hello, Touch ID, llaves de seguridad
• TOTP: Autenticación de dos factores con apps authenticator
• Social Login: Via django-allauth
• JWT: Para agentes locales (registro + refresh)

Seguridad

• Row-Level Security (RLS): Políticas PostgreSQL en 35 tablas (29 strict + 6 nullable)
• Multi-tenancy: Aislamiento por Organization a nivel aplicación + BD
• CSP (Content Security Policy): Nonces + Alpine.js CSP build
• Rate Limiting: Middleware de limitación de requests
• CSRF Protection: Token automático vía ApiService.js
• Cifrado Fernet: IPs de gestión y credenciales
• Impersonation Audit: Log completo de sesiones de superusuario
• Session Timeout: Auto-logout configurable por organización
• Login Logging: Cada intento (éxito/fallo) con IP, user agent, método

Permisos

• Roles: admin / operator / readonly
• Module Permissions: Override granular per-usuario sobre roles
• Temporary Access: Elevación temporal con expiración
• Module Gating: Middleware que bloquea URLs según plan de suscripción

15. SaaS Multi-Tenancy

Capacidades

• Organizations: Entidad raíz con plan, límites, logo, configuración
• Plans: Starter / Pro / Custom con módulos incluidos
• Module Gating: Acceso a funcionalidades controlado por plan
• Signup público: POST /api/signup crea Organization + User admin + welcome email
• Soft-delete organizations: Con papelera y purga automática a 90 días
• Backups automáticos por tenant: ZIP diario con 14 entity types + media, retención configurable
• Integrity checks: Tarea diaria que detecta anomalías cross-tenant
• Welcome emails: Via Resend + django-anymail

16. Dashboard

• Vista general: Resumen de racks, dispositivos, estado de red
• Widgets: Componentes personalizables
• Navegación por módulos: Acceso directo a Maps, Editor, Terminal, Observatory, Wireless, UPS, DSM

17. Infraestructura

Stack de Producción

• Servidor: Hetzner Cloud CCX (4 vCPU, 16GB RAM)
• Staging: Hetzner CX23 (1 vCPU, 4GB RAM)
• Orquestación: Docker Compose + Docker Swarm (Dokploy)
• Reverse Proxy: Traefik con SSL auto-cert (Let’s Encrypt)
• CDN/DNS: Cloudflare
• ASGI Server: Daphne (Django Channels)
• Task Queue: Huey con Valkey como broker
• Cache: Valkey (Redis-compatible)
• Base de datos: PostgreSQL 18 con pgbouncer (transaction mode)
• Time-series: VictoriaMetrics (180 días retención)
• Email: Resend via django-anymail

Backups

• pg_dump diario (3:00 AM) → local (14d) + Hetzner Object Storage (30d)
• WAL archiving → sync cada 15 min a Object Storage (PITR con minutos de pérdida)
• Base backup semanal (domingo 4:00 AM) → Object Storage
• Hetzner snapshots automáticos semanales
• Backups por tenant diarios (ZIP con 14 entity types)

Monitorización Externa

• UptimeRobot: Monitor HTTP(s) cada 5 min con alertas email
• Health endpoint: GET/HEAD /health verifica DB + Cache

CI/CD

• GitHub Actions: CI en push a main
• Dokploy auto-deploy: Webhook GitHub → build → deploy automático
• Firewall: Hetzner Cloud + iptables DOCKER-USER con boot restore

Tareas Periódicas (Huey)

• Backups por organización (diario 3:30 AM)
• Purga de organizaciones eliminadas (>90 días, diario 4:00 AM)
• Integrity check cross-tenant (diario 4:30 AM)
• Agregación de métricas
• Limpieza de métricas antiguas
• Transcoding de vídeo
• Proof-of-play collection
• Screenshots de players

18. Frontend Architecture

Stack

• HTMX 2.0.4: Interactividad declarativa (16 templates HTMX parciales)
• Alpine.js 3.14.8: Reactividad ligera (CSP build con nonces)
• Konva.js 9.x: Canvas 2D (Rack Editor + Map Editor)
• Apache ECharts 6.0: Gráficas en tiempo real
• xterm.js 5.x: Terminal SSH
• Vite 6.x: Build tool
• GridStack: Dashboards con widgets arrastrables

Servicios Centralizados

• ApiService.js — HTTP requests con CSRF automático
• EChartsService.js — Factory y lifecycle de gráficas
• ToastService.js — Notificaciones toast
• Logger.js — Logging estructurado con niveles
• PersistenceManager.js — Auto-save con debounce
• TabHelper.js — Gestión de pestañas
• IpValidator.js — Validación IPv4/IPv6/CIDR
• ScopedInsightTab.js — Tab CNS reutilizable por ámbito
• InsightIndicatorService.js — Indicadores de riesgo en sidebar

Extras

• Screensaver: Efecto visual + juego Asteroids oculto (keyboard shortcut)
• Dark mode: Configurable por mapa
• Guide Modal: Slideshow de 9 slides con Alpine.js, botón flotante por módulo

19. Admin Console (Django Admin)

• Organizations: Inline de usuarios, soft-delete bloqueado (hard-delete solo desde papelera), conteo clickable
• Plans + Modules: Gestión de planes de suscripción y módulos SaaS
• Users: Gestión con MFA status
• Vendor Profiles: CRUD de perfiles de fabricante
• UPS Vendor Profiles: 9 perfiles semilla
• System Logs: Auditoría completa
• Signage Adapters: 12 adaptadores vendor

20. API Documentation

• Swagger/OpenAPI: Disponible en /api/docs (local) y /api/docs (producción)
• ~509 endpoints documentados con schemas Pydantic
• Prometheus metrics: Disponible en /metrics

Documento generado: 07-04-2026 Generado por: Claude (Opus) — auditoría con 5 agentes Sonnet en paralelo Próxima actualización: Mediante Release Notes incrementales

Véase también

• [[crearack-tech—architecture—project-context]]
• [[crearack—conceptos—que-es-crearack]]
• [[crearack—conceptos—glosario]]
• [[concept—saas—multi-tenancy]]
• [[concept—saas—module-gating]]
• [[crearack-tech—architecture—saas-strategy-2026]]