CreaRack Tech
148 documentosDocumentacion tecnica completa de CreaRack Pro — backend, frontend, arquitectura, guias, auditorias.
General
45AIInsight · Modelo monitoring
Auditoría Exhaustiva Abril 2026 — v1.0.58
Auditoría Suprema · Monitoring sub-área 1 (targets+métricas+ingesta) — fixes s106
Auditoría Suprema · Monitoring sub-área 2 (protocolos/probes SNMP·ping·HTTP) — fixes s107
Auditoría Suprema · Plan y método (reutilizable)
Auditoría Suprema monitoring sa3 — CNS / Insights / IA (s109)
Blueprint · Modelo blueprints
CI rojo 24h por ruff format sin gemelo local
CNS — CreaRack Network Sentinel
CONN_MAX_AGE=0 con Daphne ASGI
CustomMib · Modelo network
Device · Modelo racks
DeviceProfile · Modelo network
Digital Signage — Flujo SpinetiX
Django Ninja como framework REST
Dokploy sobre Docker Swarm (no Kubernetes)
Feature Catalog — CreaRack Pro v1.0.51
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 r
Help Widget + Wiki EN
ITSM — SLA, Escalación y Runbooks
Local Agent v2.x
Map Editor y Auto-Plan AI
Mapa Maestro del Ecosistema CreaRack (Máster para agentes)
MediaAsset · Modelo signage
Modelos Gemini fijos por función
Module Gating · SaaSModule + Plan en lugar de feature flags genéricos
Módulos SaaS y plan gating
MonitoringTarget · Modelo monitoring
Multi-tenancy con PostgreSQL Row Level Security
Multi-tenancy en CreaRack Pro
Organization · Modelo core
pgbouncer incompatible con Dokploy networking (Swarm)
Pipeline de Discovery (Auto-Provision)
Plan · Modelo core
PostgreSQL 18 + pgbouncer transaction mode
Rack · Modelo racks
Rack Editor
ruff==0.9.6 pinned exacto
Runbook · Endurecer firewall Hetzner: quitar whitelist de IPs personales y dejar admin solo por NetBird
SaaSModule · Modelo core
SignagePlayer · Modelo signage
SLAPolicy · Modelo monitoring
Stencil · Modelo racks
StoredCredential · Modelo core
User · Modelo core
VendorProfile · Modelo network
Base de datos
2Base de datos CreaRack Pro · arquitectura técnica
Schema técnico completo de la BD PostgreSQL de CreaRack Pro: 7 apps, ~55 modelos, RLS multi-tenant, pgbouncer, índices clave y operaciones de mantenimiento.
Base de datos CreaRack Pro · explicación coloquial
Qué guarda y cómo está organizada la BD de CreaRack Pro, explicado sin jerga densa. PostgreSQL multi-tenant con aislamiento por organización (RLS). 7 apps Django, ~55 modelos.
Reports
6Auditoría de Robustez Infraestructural — CreaRack Pro SaaS
La capa de aplicación (Django, APIs, seguridad, auth) es sólida y madura. Pero la **capa de infraestructura y despliegue** tiene fragilidades críticas
Auditoría de Seguridad — crearack.com
Django/Daphne es accesible directamente en `http://crearack.com:8000`, **sin TLS, sin rate limiting de Traefik, sin headers de seguridad de Traefik**.
Auditoría de Seguridad y Licencias - CreaRack Pro
MIDDLEWARE = [
Auditoría Exhaustiva Abril 2026 — CreaRack Pro v1.0.58
6 frentes paralelos con Claude Opus 4.7: CSS, JS, Python, Templates, Assets, Stack. 5 fases ejecutadas → v1.0.58 con CI verde y Dokploy STAGE+PROD OK.
Auditoría Profunda de Código — CreaRack Pro v1.0.25
static/js/pages/observatory/
Auditoría Punto Cero — CreaRack Pro v1.0.51
1. **Aplicar migraciones dev**: `docker compose exec web python manage.py migrate`
Guias Dev
32🧪 Guía Completa de Testing Local - CreaRack Pro v5.0
1. [Preparación del Entorno](#preparación-del-entorno)
Biblioteca Supercontexto · guía para todo el staff
Capacity Planning - CreaRack Pro SaaS
Cada dispositivo monitorizado genera **7 time series** en VictoriaMetrics:
Configuración del Servidor ASGI - PRIORIDAD ALTA
La aplicación CreaRack Pro usa WebSockets para:
Deploy Checklist — Golden Path
1. **No entrar en pánico** — los datos están seguros (DB no se toca en rollback)
Digital Signage SaaS — Guía Completa
CreaRack Pro incluye un sistema completo de Digital Signage SaaS ('Super-Elementi') que permite:
Disaster Recovery — CreaRack Pro
1. Hetzner Cloud Console → **Create Server**
Distribucion del Agente Local - CreaRackAgent.exe
Anteriormente el binario se trackeaba directamente en git (`static/downloads/CreaRackAgent.exe`). Esto provocaba que el directorio `.git` creciera ~23
Django Admin Console Guide - CreaRack Pro
Al entrar en `/admin/` verás las siguientes secciones:
El puente del Help Widget (api_help)
Cómo funciona el puente entre el Help Widget de CreaRack Pro y el workspace (Archivo Maestro + wiki): los 4 endpoints, la capa de idioma EN/ES, el Informante del estado, y las reglas de honestidad (HTTP 200 con error ≠ contenido; sin gemelo ES se sirve inglés)
Gemini API — Setup, Billing y Gestion de Claves
CreaRack Pro usa la **Generative Language API** de Google (modelo `gemini-3-flash-preview`) para dos funcionalidades:
Guía CNS — CreaRack Network Sentinel
1. [Visión General](#1-visión-general)
Guía de Administración de Base de Datos — CreaRack Pro
┌──────────────┐ ┌───────────────┐ ┌─────────────────┐ ┌──────────────────┐
Guía de Docker para CreaRack Pro (Django)
CreaRack Pro Django utiliza **Docker Compose completo** para el desarrollo local:
Guía de Interconexionado — CreaRack Pro
CreaRack Pro permite documentar **todas las conexiones físicas** de un datacenter:
Guia de la Biblioteca — CreaRack Pro
Hasta ahora, cuando modificabamos un archivo de codigo, teniamos que acordarnos de actualizar CLAUDE.md, CHANGELOG.md, la guia correspondiente, el tas
Guía de Producción — CreaRack Pro en Hetzner
Hetzner es el proveedor de hosting. Tenemos un **servidor dedicado** (como un PC en un datacenter en Alemania) donde corre todo. Es un servidor Linux
Guía de Seguridad — CreaRack Pro
┌─────────────────────┐
Guía de Superusuario y Administración SaaS
1. [Introducción](#1-introducción)
Guía de Troubleshooting con CNS/ITSM
CreaRack Network Sentinel (CNS) es el sistema de inteligencia artificial que monitorea tu infraestructura de red en tiempo real. Cuando detecta una an
Guía ITSM — CreaRack Network Sentinel
1. [Visión General](#1-visión-general)
Inventario de Secretos — mapa técnico SIN valores (para Bitwarden + DR)
Mapa tecnico de credenciales SIN valores: nombre, tipo, ubicacion, criticidad, caducidad — para Bitwarden, DR y onboarding
Local Agent - Debugging & Diagnostics Guide
Acceder directamente desde el navegador. Muestra un panel HTML con:
Manual de Seguridad y Backups — Esferic Labs / CreaRack (fuente única)
Fuente unica del modelo de accesos, secretos y backups: mapa de copias, rotaciones, altas/bajas de acceso y deudas vivas
Modelo DCIM: Sala → Fila → Rack (invariantes y trampas)
El modelo de dominio DCIM de CreaRack Pro: los tres modos de Blueprint (map/room/row), qué coloca cada uno, los invariantes que el código exige y las trampas conocidas (clonado, borrado en cascada, agrupación del dashboard por nombre)
Ollama / Gemma 4 — Self-Hosted AI Guide
La API de Gemini Flash 3 es el proveedor principal de IA en CreaRack. Sin embargo:
Port Assignment Guide
The Port Assignment System connects the logical world (discovered DeviceProfiles such as APs, cameras, and IoT devices) to the physical world (switch
Reglas del Agente IA - CreaRack Pro
Responde **SIEMPRE** en Español.
Secret Rotation Playbook — CreaRack Pro
1. Generar nueva key/token
Sentinel Mode: Prueba de Persistencia 24/7
Confirmar que el sistema Sentinel Mode funciona correctamente:
Swagger API Docs — Guía de Uso
Swagger (ahora **OpenAPI**) es una interfaz web interactiva que documenta automáticamente todos los endpoints de la API de CreaRack Pro. Django Ninja
Testing Guide - CreaRack Pro
CreaRack_Pro_app_Django/
Backend
17Arquitectura de Base de Datos - CreaRack Pro v1.0.50
CreaRack Pro utiliza PostgreSQL como base de datos relacional principal, gestionada a través del ORM de Django 6. La aplicación está organizada en **7
Auto-Plan AI · Ajustes y Prompt (operativa)
Auto-Plan Performance Optimization
Optimizaciones aplicadas al sistema Auto-Plan para reducir la latencia de análisis de blueprints con Gemini AI.
Auto-Plan: Referencia Técnica
Auto-Plan es el sistema de digitalización automática de planos de infraestructura de red mediante Inteligencia Artificial. Permite convertir imágenes
Auto-Provision — Technical Guide
Auto-Provision descubre dispositivos de red en una subred, identifica vendor/modelo/capacidades via SNMP/SSH/HTTP, y los provisiona automáticamente en
Biblioteca — Referencia Tecnica
CreaRack-Pro (Claude Code)
CreaRack Local Agent - Guía Completa
El **CreaRack Local Agent** es un componente standalone que permite a CreaRack Pro conectarse a dispositivos de red con **IPs privadas** que no son ac
Guía de Refactorización Frontend - CreaRack Pro
Este documento describe la deuda técnica identificada y las estrategias de refactorización recomendadas.
Import Visio v2 — arquitectura del motor y la UI
Multi-Vendor SNMP Support — Guia Tecnica
Sistema de 3 niveles para soportar >90% de equipos de datacenter via SNMP sin intervencion manual del usuario:
Network Management Implementation Guide
Este documento detalla la implementación completa del sistema Network Management para CreaRack Pro Django, incluyendo:
Network Observatory - Documentación Técnica
Sistema de monitoreo de red en tiempo real integrado en CreaRack Pro. Incluye:
Network Tools - Guía Completa
┌─────────────────────────────────────────────────────────────────┐
Passkeys / Biometric Authentication - CreaRack Pro
CreaRack Pro implements biometric authentication (Passkeys/WebAuthn) allowing users to sign in with Windows Hello, Touch ID, Face ID, or physical secu
Rack Editor - Documentación Técnica
Editor visual de racks de datacenter integrado en CreaRack Pro. Permite diseñar la disposición física de equipos dentro de armarios rack estándar de 1
Servidor MCP de CreaRack (asistente de IA propio)
Cómo está construido el servidor MCP de CreaRack: OAuth 2.1 propio, aislamiento por organización con RLS, API de conexiones y actividad, y las 10 herramientas de solo lectura
SpinetiX HMP Integration Guide — CreaRack Pro
El SpinetiX HMP descarga contenido desde un servidor HTTP externo via la función **'Scheduled Download'** (Control Center → Content → Scheduled Downlo
Frontend
6Asteroids Background Effect
Efecto visual animado inspirado en el clásico juego Asteroids. Consiste en un canvas de fondo con:
CreaRack Pro - Sistema de Diseno
1. **Centralizacion**: Una sola definicion, multiples usos
Design Guidelines - CreaRack Pro
<!-- INCORRECTO -->
Patrón Monitoring* — bases comunes + descriptor por dominio (serie F1, auditoría s187)
Las bases comunes Monitoring* (Dashboard/Report/ChartGrid/Panel/GroupDetail/DetailPlumbing) + descriptor por dominio: qué centraliza cada una, invariantes sagrados y cómo añadir un dominio
Performance Guidelines - CreaRack Pro
Este documento establece las buenas prácticas de rendimiento para el desarrollo frontend de CreaRack Pro.
Servicios Centralizados Frontend
├── editor/ # Utilidades de editor (compartidas globalmente)
Administracion
13Backup & Restore - CreaRack Pro
El sistema de backup exporta toda la configuracion del tenant (organizacion) como un archivo ZIP que contiene un `backup_data.json` con todos los dato
Cache y Base de Datos — Valkey + PostgreSQL
Valkey es un fork open-source de Redis. CreaRack Pro lo usa para:
Django Admin — Referencia Rápida
Incluye: panel de administración, modelos registrados, superusuario, management commands, Huey task queue, migraciones, health checks, roles de usuari
Dokploy — Referencia Rápida
Incluye: deploy automático/manual, logs, environment variables, dominios/SSL, contenedores en producción, troubleshooting.
Dokploy Internals — CreaRack Pro
Dokploy v0.28.8 es una plataforma de deploy self-hosted. **No es un binario** — es un conjunto de 3 contenedores Docker gestionados por Docker Swarm.
Email routing architecture · stack completo de envío y destinatarios
Hetzner SSH Key Setup
ssh root@crearack.com
llama-server · runbook técnico (Gemma 4 vía llama.cpp)
Runbook técnico del llama-server hospedado en LXC 100 sobre Hetzner EPYC 7502P. Endpoints, configuración systemd, scripts de switch/upgrade, observabilidad, troubleshooting, decisiones técnicas (build NATIVE Zen 2 vs release haswell).
Local Agent — Referencia Rápida
Incluye: Debug Console, Fleet System, Sentinel Mode, instalación, troubleshooting, API endpoints, SaaS connection, almacenamiento local de métricas.
Monitoring Tools — VictoriaMetrics, Prometheus
CreaRack Pro usa un stack de observabilidad para metricas y dashboards:
Plataforma IA self-hosted · roadmap futuro (gestión multi-modelo en pve-epyc-02)
Plan formal NO implementado todavía: gestión multi-modelo IA en pve-epyc-02 con UI propia, API keys multi-tenant y soporte HuggingFace. Bloqueado hasta que Gemma 4 cubra Auto-Plan al 100% y todos los sites IA CreaRack (CNS, Help Widget, tutor, etc.) migren al server propio.
Proxmox VE 9.1 sobre Hetzner EPYC 7502P — Setup y Operación
Proxmox VE 9.1 host sobre EPYC 7502P 256 GB DDR4-2933 8 canales para llama-server (Gemma 4 26B-A4B vía llama.cpp build nativo Zen 2) y futura consolidacion de Crearack PROD. ZFS, LXC, KVM, Tailscale.
Server Management — Hetzner + Ubuntu
ssh root@crearack.com
Arquitectura
13Arquitectura de Métricas para SaaS - CreaRack Pro
Este documento describe la arquitectura de métricas y caché para CreaRack Pro como SaaS, explicando el rol de cada tecnología y cómo trabajan juntas.
Contexto Técnico del Proyecto - CreaRack Pro
CreaRack_Pro_app_Django/
Estado de Tareas - CreaRack Pro v1.0.57
Estrategia SaaS 2026 — CreaRack Pro
Claude Code integrado en el workflow diario: 13 reglas de oro, memorias persistentes, 15 agentes especializados, docs incrementales automáticos, works
Guía de Optimización de Performance - CreaRack Pro
devices = Device.objects.filter(rack__organization=org)
Plan de Migración PostgreSQL 16 → 18
ssh root@crearack.com
Plan: Monitoreo en Tiempo Real + Sistema de MIBs Mejorado
1. **Latencia alta**: 60-90s es inaceptable para monitoreo WiFi (client associations, roaming, interferencia)
Plan: Sistema de Auto-Informes — Workspace
Generar informes automáticos de rendimiento, costes y estado del SaaS, accesibles desde el workspace web. Informes legibles por todo el equipo (Edu, D
Roadmap SaaS — CreaRack Pro 2026
Las 3 fases se implementaron en una sola sesión. Puntuación: **6.1 → 8.5/10**.
Sentinel Mode — 24/7 Local Monitoring
Sentinel Mode extiende el CreaRack Local Agent con monitoreo continuo 24/7 desde el equipo local del ingeniero, independientemente de si la aplicación
UPS Monitor — Architecture & Technical Reference
Arquitectura del UPS Monitor: contrato de nombres de métrica snmp_extras_/snmp_fast_, los 4 tipos de OID que implementa el Agente (walk_first incluido desde v1.82.5), la cadencia de precedencia VendorProfile→target.config, y la guardia de frescura del deep data
Valkey Persistence Patterns - CreaRack Pro
CreaRack Pro usa **Valkey** (fork open-source de Redis, licencia BSD-3) como cache server. Además del caching tradicional (TTL cortos para MetricsRead
Wireless Monitor — Architecture & Technical Reference
Página dedicada para monitoreo de Access Points WiFi, separada de Observatory. Observatory está optimizado para dispositivos de red genéricos (switche
Agentes CreaRack
9Agente · dev-auto-provision
Desarrollo y mantenimiento del módulo Auto-Provision de CreaRack-Pro.
Agente · dev-cns
Desarrollo y mantenimiento del sistema CNS (CreaRack Network Sentinel) y Edge Intelligence.
Agente · dev-core
Desarrollo y mantenimiento del modulo `core/` — autenticacion, usuarios, organizaciones, permisos, credenciales, middleware y configuracion SaaS. Es l
Agente · dev-map-editor
Desarrollo y mantenimiento del Map Editor y el sistema Auto-Plan AI de CreaRack-Pro.
Agente · dev-observatory
Desarrollo y mantenimiento del Network Observatory de CreaRack-Pro.
Agente · dev-rack-editor
Desarrollo y mantenimiento del Rack Editor de CreaRack-Pro.
Agente · dev-signage
Desarrollo y mantenimiento del módulo Digital Signage SaaS de CreaRack-Pro.
Agente · dev-terminal
Desarrollo y mantenimiento del Terminal Hub, el Local Agent y el sistema Multi-Pane de CreaRack-Pro.
Agentes técnicos CreaRack-Pro · Hub
Hub de los 8 agentes técnicos especializados de CreaRack-Pro. Cargados via @ en CLAUDE.md cuando un dev abre Claude Code en el repo del producto.
Method
3Arquitectura del Perfil Claude del Staff CreaRackSL
Design Toolkit · agente + 14 skills design-*
Toolkit de diseño compartido por el staff: agente design-collaborator (Opus) + 14 skills design-* opinionadas (anti-AI-slop). Propagado scope user via claude-method.
Esquema Claude de CreaRackSL · Guía Maestra
Resumen del esquema Claude que opera en CreaRackSL: 8 capas (Reglas, Memorias, Hooks, MCP, Skills, Subagents, Bibliotecario, Routines) coordinadas. Canon vive en claude-method/guides/CREARACKSL_HARNESS_GUIDE.md.