Volver a la wiki

Auditoría Punto Cero — CreaRack Pro v1.0.51

Auditoría Punto Cero — CreaRack Pro v1.0.51

Fecha: 04-04-2026 Método: 5 agentes Opus en paralelo (tests, backend, frontend, infra, docs) Objetivo: Establecer línea base limpia tras migración de directorio


Resumen Ejecutivo

FaseEstadoHallazgos Críticos
Tests✅ 33/33 pasanDB local vacía (necesita migrate)
Backend⚠️ 6 archivos muertos~250 LOC eliminables
Frontend⚠️ 1 archivo muerto + CSS basura~470 LOC eliminables
Infra⚠️ 4 problemasPG version mismatch, ffmpeg unpinned
Docs⚠️ DesincronizadosEndpoints, modelos, Valkey version

Fase 1 — Tests


Fase 2 — Backend Dead Code

CRÍTICO (eliminar)

ArchivoLOCRazón
monitoring/services/ai_guardrails.py~100Nunca importado. Guardrail CNS sin consumidores
monitoring/services/command_validation.py~80FALSO POSITIVO: re-exportado via insight_service.py → usado por insight_execution.py. Restaurado.
core/decorators.py~50admin_required/permission_required nunca usados. Se usa has_permission() directamente
terminal/tests.py~3Stub vacío. Tests reales en terminal/tests/
tools/db/backup.py, import_backup.py, db_backup.py~150Supersedidos por core/services/backup_service.py
tools/md2html.py~30Script standalone nunca referenciado

WARNING (revisar)

ItemNotas
monitoring/management/commands/aggregate_metrics.pySin cron/Huey wiring. Depende de MetricSample (PostgreSQL, pre-VictoriaMetrics)
monitoring/management/commands/cleanup_metrics.pyMismo caso — sin automation
monitoring/management/commands/propagate_fast_poll_oids.pyOne-shot migration, probablemente ya ejecutado
racks/schemas.pySolo usado por tests de paridad, no por endpoints
is_private_ip duplicadomonitoring/api/common.py vs network/services/device_config.py (firmas diferentes)

Fase 3 — Frontend Dead Code

CRÍTICO (eliminar)

ArchivoLOCRazón
static/js/blueprints/AutoPlansAdapter.js272Nunca importado ni referenciado en ningún template/JS

WARNING

ProblemaAlcanceDetalle
Raw fetch() bypassing ApiService23 calls en 13 archivosPeor: PropertiesPanelEvents.js (5), import_export.js (4), dashboard_widgets.js (3)
Dead CSS classes~58 clases en 4 archivosobservatory.css (39), editor.css (10), signage.css (7), wireless.css (2)
console.log sin Logger.js75 en 21 archivosPeor: SignageScheduleManager.js (12), ssh_integration.js (11)
JS files >1000 LOC9 archivosSignageContentManager.js (1336), SignageDetail.js (1300), observatory.js (1230)

Fase 4 — Docker / Infraestructura

CRÍTICO

#ProblemaDetalleAcción
1PG version mismatch✅ Resuelto 04-04-2026: Dev+Prod alineados a postgres:18-alpineMigración pg_dump/restore completada
2ffmpeg unpinnedlatest tag = builds no reproduciblesPinear release específica
3.env tiene Gemini API keyNo en git (.gitignore OK) pero expuesta en máquinaVerificar/rotar si necesario
4compose.yml hardcoded DB credsdev_password_123 en source controlUsar ${POSTGRES_PASSWORD:-dev_password_123}

WARNING

#ProblemaDetalle
5Dev Dockerfile sin USERProd tiene appuser, dev corre como root
6Dev Dockerfile sin --no-install-recommendsImagen dev inflada vs prod
7Dev sin libvisio-tools, libreoffice-draw, librsvg2-binEMF→PNG falla en dev
8Dev sin Huey workerTareas async (backups, transcode) no ejecutan en dev
9Valkey 7.2 en compose, CLAUDE.md dice 8.xDocs desincronizados
10VictoriaMetrics sin networks: explícitoEn compose.observability.yml
11Dev expone puertos DB/cache al host5432 y 6379 publicados
12pip install sin --no-cache-dir en dev+50-100MB imagen
13gcc permanece en imagen final+100MB (solo necesario para compilar)

INFO


Fase 5 — Documentación

MISMATCH

DatoCLAUDE.md diceRealDelta
Endpoints462~509 decorators+47 (algunos pueden ser internos)
Modelos42 (en DATABASE_ARCHITECTURE.md)40-2
Valkey8.x7.2 (compose)Docs adelantados
INDEX.md versiónv1.0.49v1.0.51 (base.py)Desactualizado

LIMPIEZA REALIZADA

ItemEstado
Contenedor crearack_grafana huérfano✅ Eliminado
Proyecto crearack_pro_app_django (viejo)✅ Eliminado (1 container + 2 redes)
10 volúmenes huérfanos (grafana, netdata, worktrees)✅ Eliminados
Worktree great-diffie✅ Eliminado
Branch claude/great-diffie⏳ Pendiente eliminación manual

Plan de Acción Recomendado

Prioridad Alta (hacer ahora)

  1. Aplicar migraciones dev: docker compose exec web python manage.py migrate
  2. Eliminar archivos muertos backend (6 archivos, ~250 LOC)
  3. Eliminar AutoPlansAdapter.js (272 LOC)
  4. Alinear PostgreSQL: decidir 16 o 17 para dev y prod
  5. Pinear ffmpeg a release tag específica en Dockerfiles
  6. Sincronizar CLAUDE.md: corregir conteos endpoints/modelos, Valkey version
  7. Actualizar INDEX.md: versión v1.0.49 → v1.0.51

Prioridad Media (próximas sesiones)

  1. Migrar 23 raw fetch() → ApiService (13 archivos)
  2. Limpiar ~58 dead CSS classes (4 archivos)
  3. Reemplazar 75 console.log → Logger.js (21 archivos)
  4. Añadir Huey worker al dev compose
  5. Paridad dev Dockerfile (USER, —no-install-recommends, libvisio-tools)
  6. Verificar groupdocs-conversion-cloud — ¿aún necesario?

Prioridad Baja (backlog)

  1. Refactorizar 9 JS files >1000 LOC (mayor: SignageContentManager 1336)
  2. Eliminar gcc de imagen final (multi-stage build)
  3. VictoriaMetrics networks: explícito en compose.observability.yml
  4. Branch huérfana: git branch -d claude/great-diffie

Próximo paso: Con tu aprobación, ejecuto las acciones de Prioridad Alta (items 1-7) en esta sesión.

Véase también

Subir