[ADN] Ruby como estándar de codificación + nueva hebra Proyectos + manifiesto P2601

2026-02-27 18:35:42 -03:00
parent 9f1daefe0a
commit 2631cb36a3
5 changed files with 167 additions and 1 deletions
@@ -24,7 +24,8 @@ En este proyecto **todo tiene que ver con todo**. El ADN (hebras), las Bitácora
 | 03 | [**Seguridad**](03_seguridad.md) | `03_seguridad.md` | Protocolos de red (Hombre Muerto), secretos operativos y bóveda cifrada. |
 | 04 | [**Iconografía**](04_iconografia.md) | `04_iconografia.md` | Taxonomía visual de estados e iconos semánticos. |
 | 05 | [**Directivas IA**](05_ia.md) | `05_ia.md` | Fuente única de verdad para las premisas de trabajo de la Inteligencia Artificial. |
-| 06 | [**Gobernanza**](06_gobernanza.md) | `06_gobernanza.md` | Idioma, nomenclatura, armonía integral, resguardo y evolución progresiva. |
+| 06 | [**Gobernanza**](06_gobernanza.md) | `06_gobernanza.md` | Idioma, nomenclatura, codificación (Ruby), armonía integral, resguardo y evolución progresiva. |
+| 07 | [**Proyectos**](07_proyectos.md) | `07_proyectos.md` | Definición de proyectos transversales, formato de manifiestos y ciclo de vida. |

 ---

@@ -19,12 +19,20 @@ Esta hebra establece las reglas fundamentales de idioma, nomenclatura, coherenci
 - **Estilo**: Markdown estándar.
 - **Ubicación**: Todo documento clave del ADN debe residir en el directorio `adn/`.

+## 2.5 Codificación Prioritaria
+
+- **Lenguaje estándar**: **Ruby** es el lenguaje prioritario para scripts operativos y herramientas del proyecto.
+- **Justificación**: Manejo robusto de excepciones, escalabilidad estructural y consistencia frente a la fragilidad de Bash para secuencias complejas.
+- **Alcance**: Scripts de automatización (`tools/`), procesadores de respaldos (`dtic-BKPs`), utilidades de gestión y cualquier lógica operativa recurrente.
+- **Excepción**: Bash se permite para one-liners, wrappers de lanzamiento y tareas triviales de sistema donde Ruby introduzca complejidad innecesaria.
+
 ## 3. Armonía Integral 🧬

 El principio rector del proyecto. Así como las hebras del ADN biológico se entrelazan para codificar un organismo, las piezas de este proyecto están **interconectadas bidireccionalmente**:

 - **ADN ↔ Bitácoras**: Las hebras definen cómo se escriben; las mejores prácticas emergentes en bitácora se formalizan como nuevas reglas.
 - **ADN ↔ Nodos**: La ontología describe los nodos; los cambios de estado de un nodo se reflejan en su ficha y en la bitácora.
+- **ADN ↔ Proyectos**: Los proyectos transversales (ver hebra [`07_proyectos.md`](07_proyectos.md)) agrupan nodos, bitácoras y tareas bajo un objetivo común con visibilidad gerárquica.
 - **Bitácoras ↔ Nodos**: Los hitos del día alimentan y actualizan la ficha del nodo afectado.

 ### Regla de Propagación
@@ -0,0 +1,60 @@
+# 07 - Hebra: Proyectos
+
+> Referencia canónica: [`adn/00_indice.md`](00_indice.md)
+
+Esta hebra define el concepto de **Proyecto** como entidad transversal del ADN y establece el formato de sus manifiestos.
+
+## 1. Definición
+
+Un **Proyecto** es un esfuerzo coordinado que agrupa múltiples tareas, nodos y bitácoras bajo un objetivo común. A diferencia de:
+- Un **Nodo** (infraestructura estática, snapshot),
+- Una **Bitácora** (registro diario, efímero),
+
+Un Proyecto tiene **alcance temporal definido** y **visibilidad gerárquica**: las partes jerárquicas (superiores, coordinadores) pueden consultar su avance de forma asíncrona, típicamente a través de un dashboard web.
+
+## 2. Identificación
+
+- **Código**: Alfanumérico con prefijo `P` (ej: `P2601`).
+- **Ubicación**: `proyectos/<código>_<nombre>.md` (ej: `proyectos/P2601_dasuten.md`).
+- **Referencia en Bitácoras**: Los hitos que pertenecen a un proyecto deben referenciar su código en la descripción.
+
+## 3. Formato de Manifiesto
+
+Cada proyecto debe tener un archivo manifiesto con las siguientes secciones:
+
+### Secciones Obligatorias
+
+| Sección | Descripción |
+| :--- | :--- |
+| **Identificador** | Código alfanumérico (`P2601`). |
+| **Nombre** | Nombre descriptivo del proyecto. |
+| **Objetivo** | Para qué existe, qué problema resuelve. |
+| **Stakeholders** | Quién consulta/supervisa el avance (cargo, relación). |
+| **Nodos Involucrados** | Qué infraestructura participa (links a `nodos/`). |
+| **Herramientas** | Software, scripts y servicios utilizados. |
+| **Hitos Clave** | Timeline de alto nivel con estados y fechas. |
+| **Referencias** | Links a bitácoras, nodos, documentos técnicos. |
+
+### Secciones Opcionales
+
+| Sección | Descripción |
+| :--- | :--- |
+| **Dashboard** | URL del panel de seguimiento web (si aplica). |
+| **Cronograma Estimado** | Fechas de inicio/fin planificadas. |
+| **Riesgos** | Amenazas identificadas y mitigaciones. |
+
+## 4. Ciclo de Vida
+
+```
+📍 Definido → ⏳ En Ejecución → ✅ Completado
+                    ↕
+              ⚠️ Bloqueado
+```
+
+- Un proyecto **nace** cuando se crea su manifiesto.
+- **Progresa** a medida que sus hitos se registran en las bitácoras diarias.
+- Se **cierra** cuando todos sus objetivos están cumplidos y se registra el cierre en su manifiesto.
+
+## 5. Relación con el ADN
+
+Los proyectos son el **tejido conectivo** que une nodos y bitácoras en un propósito común. El dashboard web de un proyecto es la interfaz de comunicación asíncrona con los stakeholders, permitiendo visibilidad sin interrumpir la operación.
@@ -36,6 +36,7 @@
 #### 👁️ - SINC02 - Sincronización de Inicio de Jornada
 | Tiempo | Descripción |
 | :--- | :--- |
+| ✅ 18:33 | (IA) 🧬 Extensión del ADN: Ruby como estándar de codificación y nueva hebra de Proyectos (`07_proyectos.md`). Creación del primer manifiesto de proyecto (`proyectos/P2601_dasuten.md`) con arquitectura de red, hitos clave, stakeholders y referencia al dashboard. `[Remoto: 0:18 hs]` |
 | ✅ 18:15 | (IA) 🧬 Armonización Integral de Bitácoras Históricas. Migración del formato de tabla plana a H4+párrafo+tabla en las bitácoras del 20 y 23/02. Inyección de métricas `[Físico/Remoto: H:MM hs]` en las 5 bitácoras históricas. Canonización de footers IA en los 5 archivos. Mejora de la hebra `02_bitacora.md` con ejemplo estructural y sintaxis de rollover. `[Remoto: 0:35 hs]` |
 | ✅ 17:40 | (IA) 🧬 Refactorización del ADN a Arquitectura Multi-Hebra. El operador aprobó el plan de descomposición del protocolo monolítico (`02_protocolo.md`) en 6 hebras temáticas independientes, integrando el principio de Armonía Integral como eje transversal. Se extraen las Premisas IA del footer de las bitácoras hacia una hebra canónica única (`05_ia.md`). Se eliminan archivos obsoletos y se reemplazan los footers duplicados por referencias canónicas. `[Remoto: 0:20 hs]` |
 | 👁️ 16:13 | Inicio de Sincronización Remota. El operador inicia las tareas en modo remoto, reportando la culminación exitosa del backup de la DB a través de la GUI de Proxmox. Se asume el control del entorno para proceder con las siguientes tareas del backlog (Deploy del sistema DASUTEN y/u optimizaciones de seguridad). `[Remoto: Iniciado 16:13]` |
@@ -0,0 +1,96 @@
+# P2601 - Proyecto DASUTEN
+
+> Manifiesto de Proyecto | Referencia: [`adn/07_proyectos.md`](../adn/07_proyectos.md)
+
+## Identificación
+
+| Campo | Valor |
+| :--- | :--- |
+| **Código** | P2601 |
+| **Nombre** | Infraestructura y Sistema DASUTEN |
+| **Estado** | ⏳ En Ejecución |
+| **Inicio** | 23/02/2026 |
+| **Fin Estimado** | Por definir |
+
+## Objetivo
+
+Desplegar la infraestructura completa de servidor para la oficina de DASUTEN (Departamento de Alumnos SUTen) de la Facultad Regional La Rioja (UTN), incluyendo un Controlador de Dominio Active Directory, un motor de Base de Datos SQL Server 2019, y el sistema de gestión administrativa DASUTEN, operando sobre un hipervisor Proxmox VE standalone aislado de la red principal del campus.
+
+## Stakeholders
+
+| Rol | Persona | Visibilidad |
+| :--- | :--- | :--- |
+| **Responsable Técnico** | Lic. Ricardo MONLA | Operador directo |
+| **Dirección de TIC** | (Jerárquico superior) | Dashboard asíncrono |
+
+## Dashboard
+
+- **URL**: `https://ns8.frlr.utn.edu.ar/P2601/`
+- **Tipo**: Aplicación web estática (HTML/JS/CSS) servida por Nginx.
+- **Métricas**: Timeline de hitos, barras de progreso, desglose Físico/Remoto por hito.
+- **Actualización**: Las métricas se alimentan de las etiquetas `[Físico/Remoto: H:MM hs]` parseadas de las bitácoras.
+
+## Nodos Involucrados
+
+| Nodo | IP | Rol en el Proyecto |
+| :--- | :--- | :--- |
+| [**srv-dasu**](../nodos/srv-dasu.md) | `10.0.10.205` | Hipervisor Proxmox VE (standalone) |
+| **dc-dasuten** (VM 100) | `10.0.100.10` | Controlador de Dominio AD DS + DNS |
+| **sql-dasuten** (VM 101) | `10.0.100.11` | Motor SQL Server 2019 (Core) |
+| [**srv-ns8**](../nodos/srv-ns8.md) | `10.0.10.8` | Nodo central de gestión y dashboard |
+
+## Herramientas
+
+| Herramienta | Uso |
+| :--- | :--- |
+| **Proxmox VE 9.1** | Virtualización y gestión de VMs |
+| **Windows Server 2022 Core** | SO base para DC y SQL |
+| **SQL Server 2019** | Motor de base de datos relacional |
+| **OpenSSH** | Administración remota nativa de VMs Windows |
+| **VZDump** | Resguardos offline de VMs |
+| **Dashboard P2601** | Panel web de seguimiento para stakeholders |
+
+## Hitos Clave
+
+| Fecha | ID | Estado | Hito |
+| :--- | :--- | :---: | :--- |
+| 23/02 | A00-A01 | ✅ | Acondicionamiento hardware e instalación de Proxmox VE en `srv-dasu`. |
+| 23/02 | A05 | ✅ | Creación de VM Windows Server Core y descarga de ISO. |
+| 24/02 | A05 | ✅ | Habilitación SVM en BIOS, instalación de OS, promoción a DC (`dc-dasuten`). |
+| 24/02 | A06 | ✅ | Despliegue del Dashboard P2601 con telemetría operativa. |
+| 25/02 | DB01 | ✅ | Creación de VM `sql-dasuten`, instalación de OS, integración al dominio e instalación de SQL Server 2019. |
+| 26/02 | SSH | ✅ | Despliegue de OpenSSH Server nativo en ambas VMs Windows. |
+| 26/02 | BKP | ✅ | Resguardo VZDump offline (stop mode) de DC y SQL. |
+| 27/02 | ADN | ✅ | Refactorización del ADN a arquitectura multi-hebra con Armonía Integral. |
+| — | P02 | 📍 | Instalación del sistema DASUTEN sobre el motor SQL. |
+| — | S02 | 📍 | Hardenización SSH (llaves, passphrases, auditoría). |
+
+## Arquitectura de Red
+
+```
+┌─────────────────────────────────────────┐
+│  Red Facultad (10.0.10.x)              │
+│                                         │
+│  srv-ns8 (.8)    srv-dasu (.205)        │
+│  [Dashboard]     [Proxmox VE]           │
+│                    │                    │
+│                    │ NAT/MASQUERADE     │
+│                    ▼                    │
+│            ┌──────────────┐             │
+│            │ 10.0.100.x   │             │
+│            │ (Aislada)    │             │
+│            │              │             │
+│            │ dc-dasuten   │             │
+│            │ (.10) [AD DS]│             │
+│            │              │             │
+│            │ sql-dasuten  │             │
+│            │ (.11) [SQL]  │             │
+│            └──────────────┘             │
+└─────────────────────────────────────────┘
+```
+
+## Referencias
+
+- **Bitácoras**: [23/02](../bitacoras/2026-02-23.md) | [24/02](../bitacoras/2026-02-24.md) | [25/02](../bitacoras/2026-02-25.md) | [26/02](../bitacoras/2026-02-26.md) | [27/02](../bitacoras/2026-02-27.md)
+- **ADN**: [Ontología](../adn/01_ontologia.md) | [Proyectos](../adn/07_proyectos.md)
+- **Nodos**: [srv-dasu](../nodos/srv-dasu.md) | [srv-ns8](../nodos/srv-ns8.md)