[ADN] Commit final DB-First - Actualización completa de documentación, herramientas y componentes

This commit is contained in:
Ricardo Monla
2026-03-12 06:03:48 -03:00
parent 4b000aeb89
commit e554bb5d0d
37 changed files with 1479 additions and 122 deletions
+49 -2
View File
@@ -28,14 +28,18 @@ class SubcomandoAyuda
#{Color::YELLOW}Subcomandos disponibles:#{Color::RESET}
validador [--watch] [--fix] Validar cumplimiento del ADN en bitácoras
contexto <nodo> [--cmd] Obtener contexto topológico de un nodo
nodos <acción> [opciones] Gestión de nodos (agrupar, listar, buscar)
jornada <acción> [modo] [hora] Gestión de jornada (iniciar, cerrar, estado)
salud [--dashboard] [--json] Ver salud general del sistema ADN
generar bitacora [fecha] Generar nueva bitácora (fecha: YYYY-MM-DD)
generar nodo <nombre> Generar ficha de nodo
#{Color::YELLOW}generar proyecto <código>#{Color::RESET} Generar manifiesto de proyecto
#{Color::YELLOW}backup <nodo> [--mode MODO]#{Color::RESET} Ejecutar backup seguro de un nodo
#{Color::YELLOW}inicio de jornada [presencial|remoto]#{Color::RESET} Inicio de jornada laboral
#{Color::YELLOW}cierre de jornada [presencial|remoto]#{Color::RESET} Cierre de jornada laboral
#{Color::YELLOW}db <subcomando>#{Color::RESET} Operaciones de base de datos
#{Color::YELLOW}triggers [opciones]#{Color::RESET} Gestión del motor de triggers
#{Color::YELLOW}plan [subcomando]#{Color::RESET} Gestión de planes y progreso
#{Color::YELLOW}proceso <nombre>#{Color::RESET} Ejecutar procesos técnicos automatizados
#{Color::YELLOW}estados#{Color::RESET} Listar tareas en proceso (⏳)
#{Color::YELLOW}ayuda [subcomando]#{Color::RESET} Mostrar esta ayuda o ayuda específica
#{Color::YELLOW}Subcomandos en desarrollo (Fases futuras):#{Color::RESET}
@@ -79,6 +83,35 @@ class SubcomandoAyuda
puts "Ejemplo:"
puts " ./adn/tools/run contexto srv-pmox1"
puts " ./adn/tools/run contexto srvv-fenix --cmd"
when 'nodos'
puts "Uso: ./adn/tools/run nodos <acción> [opciones]"
puts ""
puts "Gestión y consulta de nodos de infraestructura:"
puts " • agrupar [--servidor SRV] Agrupar VMs por servidor anfitrión"
puts " • listar [--tipo TIPO] Listar fichas de nodos (.md)"
puts " • buscar <término> Buscar nodos por nombre o contenido"
puts ""
puts "Ejemplos:"
puts " ./adn/tools/run nodos agrupar"
puts " ./adn/tools/run nodos agrupar --servidor srv-pmox1"
puts " ./adn/tools/run nodos listar --tipo srvv"
puts " ./adn/tools/run nodos buscar dasuten"
when 'jornada'
puts "Uso: ./adn/tools/run jornada <acción> [modo] [hora] [opciones]"
puts ""
puts "Gestión de jornada laboral:"
puts " • iniciar [presencial|remoto] [HH:MM] Registrar inicio"
puts " • cerrar [presencial|remoto] [HH:MM] Registrar cierre"
puts " • estado Ver estado actual"
puts ""
puts "Opciones:"
puts " --nodo NOMBRE Nodo a registrar (default: dtic-DIIAA)"
puts " --fecha YYYY-MM-DD Fecha de la bitácora (default: hoy)"
puts ""
puts "Ejemplos:"
puts " ./adn/tools/run jornada iniciar presencial 08:00"
puts " ./adn/tools/run jornada cerrar remoto 23:00"
puts " ./adn/tools/run jornada estado"
when 'salud'
puts "Uso: ./adn/tools/run salud [--dashboard] [--json]"
puts ""
@@ -102,6 +135,20 @@ class SubcomandoAyuda
puts " ./adn/tools/run generar bitacora 2026-03-08"
puts " ./adn/tools/run generar nodo srv-nuevo"
puts " ./adn/tools/run generar proyecto P2604"
when 'proceso'
puts "Uso: ./adn/tools/run proceso <nombre_proceso> [argumentos]"
puts ""
puts "Ejecuta procesos técnicos automatizados sobre la infraestructura:"
puts " • nodos:actualizar_so <nodo> Actualiza paquetes y parches de seguridad"
puts ""
puts "Ejemplos:"
puts " ./adn/tools/run proceso nodos:actualizar_so srv-ns8"
puts " ./adn/tools/run proceso nodos:actualizar_so srv-dasu"
when 'estados'
puts "Uso: ./adn/tools/run estados"
puts ""
puts "Consulta la bitácora web para listar todos los items con estado ⏳ (En proceso)."
puts "Ideal para monitorear procesos automatizados o jornadas abiertas."
else
puts "#{Color::RED}✗ Subcomando desconocido: #{subcomando}#{Color::RESET}"
puts "Usa './adn/tools/run ayuda' para ver la lista de subcomandos."