ContainerFlow/docs/roadmap.md

ContainerFlow — Roadmap de Monitoreo

Actualizado tras integración de eventos persistentes, notificaciones in-app, control de acceso por path, cálculo de memoria real, volúmenes/mounts en DetailPanel y recomendaciones de configuración Docker.

Fase 1: Acciones básicas ✅ COMPLETA

• Stop / Start / Restart desde el DetailPanel
• Confirmación antes de ejecutar acciones destructivas (stop/restart/remove/rebuild/recreate)
• Feedback visual del estado de la acción (loading, success, error) — toast top-right con copy/expand
• Rebuild (docker compose up --build) por servicio
• Bonus: Recreate (docker compose up --force-recreate) para aplicar cambios de compose sin rebuild

Fase 2: Notificaciones ✅ COMPLETA

• Webhooks configurables — Discord implementado, Slack pendiente (mismo patrón aplicaría)
• Push notifications cuando un contenedor cae o health check falla — vía Discord + in-app
• Panel de configuración de notificaciones en la UI (SettingsPage → Discord section)
• Bonus: Notificaciones in-app (SQLite persistente, bell del header con read/unread, tab dedicado en Monitoring)
• Bonus: Debounce de 15s para detectar restart vs stop+start
• Bonus: Cooldown configurable + "Still Down" reminder

Descartado: PWA + Service Worker para web push notifications — requiere HTTPS y agrega complejidad de deploy. Las notificaciones in-app + Discord cubren los casos de uso.

Fase 3: Historial y métricas ✅ COMPLETA

• SQLite para persistir stats — CPU/RAM (network I/O pendiente)
• Gráficas temporales de CPU/RAM por servicio (1h, 6h, 24h, 7d) con buckets agregados
• Dashboard de métricas agregadas — MonitoringTotalsCard (CPU/MEM total por filtro)
• Retención configurable — 7d default, auto-limpieza horaria + VACUUM
• Bonus: Filtro per-servicio en monitoring (override del range global)
• Bonus: Filtros por proyecto/servicio con botón reset
• Bonus: Cálculo de memoria real (resta page cache active+inactive, no solo inactive como docker stats)

Fase 4: Alertas ✅ MAYORMENTE COMPLETA

• Reglas de alertas con duración (ej: CPU > 80% por 5 min) — parcialmente: alertas inmediatas al cruzar threshold, no soporte de duración sostenida
• Historial de alertas disparadas — notifications_log en SQLite, tab Notificaciones
• Integración con notificaciones (Fase 2) — Discord + in-app
• Alertas por health check fallido — vía health_status event
• Bonus: Thresholds por contenedor con override del global (CPU% y MEM%)
• Bonus: Color amber en progress bars cuando supera threshold (dashboard ServiceNode + DetailPanel)

Fase 5: Info avanzada

• Volumes/Mounts por contenedor en DetailPanel — tipo, source, destination, rw/ro, name del volumen
• Terminal interactiva (docker exec) desde la UI — botón Exec en DetailPanel
• Network inspector (tráfico entre servicios) — parcial: conexiones visualizadas en grafo, no hay info de tráfico (rx/tx bytes)
• Image layers y tamaño (no implementado)

Fase 6: Deployment (futuro)

• GitHub integration (webhook + clone + build)
• Build pipeline (docker build desde Dockerfile)
• Deploy management (docker-compose dinámico)
• Domain routing automático (Traefik/Caddy)
• Rollbacks (mantener imágenes anteriores)
• Env var editing + rebuild desde la UI — parcial: env vars visibles en DetailPanel, edición pendiente

---

Fase nueva: Recomendaciones de configuración Docker

ContainerFlow no solo monitorea — detecta configuración sub-óptima y la marca con un banner ámbar en el DetailPanel. La idea es ayudar al usuario a adoptar buenas prácticas sin tener que recordarlas.

Recomendaciones activas (✅ implementadas)

• Sin memory_limit → banner "Sin límite de memoria configurado en Docker"
• Sin cpu_quota → banner "Sin límite de CPU configurado en Docker"
• restart: no o vacío → banner "Restart policy: none — el contenedor no se reiniciará automáticamente si se detiene"

Recomendaciones planeadas

• Sin HEALTHCHECK → detectar service.health_status === "" y sugerir healthcheck contextual:
  • postgres → pg_isready -U $POSTGRES_USER
  • redis → redis-cli ping
  • mysql/mariadb → mysqladmin ping -h localhost
  • mongo → mongosh --eval "db.adminCommand('ping')"
  • http app → curl -f http://localhost:PORT/health
  • Banner copiable con el snippet del compose
• image:latest → warning "Imagen sin tag específico — no reproducible. Considera fijar versión."
• DBs sin named volume → warning "Container de DB (postgres/mysql/mongo/redis) sin named volume para datos persistentes. docker-compose down puede borrar datos."
• Containers sin labels de compose → info "Container manual (docker run). Acciones de rebuild no disponibles."

Resumen del enfoque

docker stats:           solo muestra números
otros dashboards:       muestran números + gráficas
ContainerFlow:          muestra + grafica + DETECTA config rota y enseña a arreglarla

Este eje diferenciador agrega valor educativo, no solo observabilidad.

---

Features adicionales no contempladas en el roadmap original

Seguridad / Multi-usuario

• ALLOWED_PATHS env var para limitar acciones a paths específicos
• ALLOW_NON_COMPOSE para containers docker run directo
• Lock icon visual en nodos sin acceso de acción
• Sección "Seguridad" expandida en README (privilegios del container, multi-user, ALLOWED_PATHS)

UX / DX

• Tooltips descriptivos en acciones (DetailPanel + NodeContextMenu)
• Confirmación dialogs con (?) que muestra detalle del comando
• Acción labels siempre en inglés (Restart/Stop/Recreate — match docker commands)
• Hot stats al cargar página (/api/init devuelve último snapshot cacheado)
• Polling paralelo (Promise.all) — primera ronda en ~3s vs ~90s antes
• Tabs en Monitoring (Historial / Eventos / Notificaciones)
• Click en notificación/evento → abre DetailPanel del container en tab Stats
• DATA_DIR auto-creado en ./data/ (en vez de raíz del proyecto)
• Bell del header con read/unread persistente (localStorage)
• Card totales en Monitoring con color verde diferenciado

Documentación

• docker-containerflow.md — guía Docker explicada para usuarios
• .env.example con secciones documentadas
• README con sección Monitoreo e historial + Seguridad + Mejores prácticas

---

Pendientes prioritarios (próxima iteración)

1. Alertas con duración ("CPU > 80% por 5 min") — Fase 4 pendiente
   • Requiere ventana deslizante de samples + state machine por threshold
   • Resuelve falsos positivos por spikes momentáneos
2. Recomendaciones de healthcheck — Fase nueva
   • Detectar containers sin healthcheck y sugerir uno contextual según la imagen
   • Banner/widget en dashboard, tooltip con ejemplo copiable
3. Network I/O en stats history — extiende pollStats con networks.eth0.rx_bytes/tx_bytes
4. Image layers y tamaño — vía docker image inspect + UI en DetailPanel
5. Slack webhook — clonar el patrón de Discord para Slack

Cosas que cambiaron sustancialmente desde el roadmap original

• "Notificaciones" evolucionó de "solo Discord" a "Discord + in-app persistente + bell con read/unread + tab dedicado"
• "Historial" evolucionó de "CPU/RAM por servicio" a "+ totales agregados + per-service override + reset filtros + memoria real"
• Acciones evolucionó de "stop/start/restart/rebuild" a "+ recreate + exec + remove con confirmación"
• Seguridad se volvió un eje propio (ALLOWED_PATHS) que no estaba en el roadmap
• Recomendaciones de config Docker es un eje nuevo que no estaba contemplado — diferenciador del producto vs "solo otro dashboard"