[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
+35
View File
@@ -0,0 +1,35 @@
# 08 - Hebra: Procesos
> Referencia canónica: [`adn/00_indice.md`](00_indice.md)
Esta hebra define el concepto de **Proceso** como una secuencia automatizada de acciones técnicas ejecutadas sobre la infraestructura (Nodos).
## 1. Definición
Un **Proceso** es la formalización de una tarea operativa repetitiva en forma de código ejecutable. A diferencia de un **Proyecto** (que tiene hitos y objetivos de negocio), un Proceso es **funcional y atómico**: realiza una transformación técnica específica.
## 2. Características
- **Determinismo**: Ante las mismas condiciones, el proceso debe actuar de la misma forma.
- **Trazabilidad**: Toda ejecución de un proceso debe quedar registrada en la Bitácora (DB) indicando el nodo afectado y el resultado.
- **Conciencia de Contexto**: El proceso debe consultar el ADN (fichas de nodos) para obtener parámetros como IPs, tipos de SO y métodos de acceso.
## 3. Catálogo de Procesos (Core)
| Proceso | Descripción | Acción ADN CLI |
| :--- | :--- | :--- |
| **Actualización de SO** | Actualiza paquetes y parches de seguridad según el SO. | `proceso nodos:actualizar_so` |
| **Validación de Red** | Pruebas de latencia y ruteo entre nodos. | `proceso nodos:validar_red` |
| **Backup de Datos** | Ejecución de respaldos específicos de servicios. | `proceso nodos:backup` |
## 4. Implementación Técnica
Los procesos se integran en la CLI ADN bajo el subcomando `proceso`. La lógica debe ser capaz de:
1. **Cargar metadatos** del nodo desde `nodos/*.md`.
2. **Validar requisitos** (conectividad SSH, permisos).
3. **Ejecutar lógica ramificada** según el Sistema Operativo detectado.
4. **Notificar resultado** al sistema de Bitácoras.
## 5. Directiva IA
La IA debe priorizar el uso y creación de procesos sobre la ejecución de comandos manuales aislados. Cada nuevo proceso creado reduce la deuda técnica y aumenta la autonomía del sistema.