Agente · dev-backend

Propósito

Desarrollo y mantenimiento del backend de CreaRack-Pro v1.0.51.

Stack activo

Core

⚠ El proyecto usa Huey, no Celery. Decorador: @huey.task() · scheduler: @huey.periodic_task(crontab(...)).

Base de datos e infraestructura de datos

IA / Proveedores

⚠ Modelo Gemini fijo: gemini-3-flash-preview. Mantener todos en tier económico.

Red y monitorización

Autenticación y seguridad

Email, monitorización y utilidades

Testing

Estructura del proyecto

CreaRack-Pro/
├── blueprints/          # Mapas de infraestructura (Map Editor)
├── config/              # Settings, URLs raíz, ASGI
├── core/                # Autenticación, usuarios
│   └── htmx_views.py    # Vistas HTMX
├── monitoring/          # Network Observatory (SNMP, ping, HTTP, CNS)
├── network/             # Gestión de red (Auto-Provision, scripts)
├── racks/               # Racks y dispositivos (Rack Editor)
├── signage/             # Digital Signage CMS
├── terminal/            # Terminal SSH
│   └── agent/           # Local Agent v2.0.11 (Windows exe)
├── templates/           # 45 templates (16 HTMX en templates/htmx/)
├── compose.yml
├── compose.observability.yml   # VictoriaMetrics opcional
├── Dockerfile
└── requirements.txt

API REST

~509 endpoints (REST + HTMX) + 27 WebSocket

Batch endpoints (concurrencia)

POST /api/monitoring/targets/batch-ping   # 20 concurrentes max
POST /api/monitoring/targets/batch-snmp   # 10 concurrentes max
POST /api/monitoring/targets/batch-http   # 15 concurrentes max

Módulos principales

Auto-Plan AI (digitalización de planos)

• Análisis de planos bitmap → racks, dispositivos, conexiones
• Proveedor principal: Gemini Flash (gemini-3-flash-preview)
• Alternativos: Claude Haiku · DeepSeek
• Reintentos con backoff exponencial vía Huey

Auto-Provision (descubrimiento de red)

• Multi-stage: ICMP + ARP + SNMP + HTTP fingerprinting
• Bulk subnet scan (/20 a /30) con batched enrichment
• 1.600+ vendors (IANA PEN + curated) con sysObjectID detection
• Confidence scoring 0-100%

CNS · CreaRack Network Sentinel

• Edge Intelligence: AnomalyDetector + InsightReporter en loops Sentinel
• Proveedores IA: Gemini Flash (principal) · Claude Haiku (alternativo)
• Anomalías detectadas: packet loss >10%, latencia >200ms, CRC errors >100/min
• Workflow: Agent detecta → IA diagnostica → operador aprueba

Local Agent v2.0.11 (Windows)

• Ejecutable Windows (~23 MB) · puerto 5050 (localhost only)
• Arquitectura modular: main.py + 9 routers
• Multi-Agent Fleet: Primary (Sentinel) / Secondary (SSH tools)
• Failover automático si Primary se desconecta
• Distribución: GitHub Releases (no en el repo git)

Digital Signage CMS

• Gestión de contenido, playlists, scheduling, deployment SpinetiX
• ITSM Integration: SLA, notificaciones, escalamiento, analytics

Convenciones

• API: Django Ninja · prefijo /api/v1/ obligatorio
• Autenticación: django-allauth · JWT via PyJWT
• Tests: pytest-asyncio para tareas async y conexiones de red
• ⚠ No usar: Celery, NAPALM, Netmiko, DRF, TimescaleDB

Entorno de desarrollo (Windows)

# Arrancar servicios básicos
docker compose up -d

# Arrancar con observabilidad (VictoriaMetrics)
docker compose -f compose.yml -f compose.observability.yml up -d

# Arrancar Huey worker
python manage.py run_huey

# Arrancar Django con Daphne (ASGI)
daphne -p 8000 config.asgi:application

# Shell Django
docker compose exec web python manage.py shell

# Migraciones
docker compose exec web python manage.py makemigrations
docker compose exec web python manage.py migrate

# Tests
docker compose exec web python -m pytest tests/api/ -v

# Logs en tiempo real
docker compose logs -f web

URLs de desarrollo

Credenciales por defecto: admin / dev_password_123