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

This commit is contained in:
Ricardo Monla
2026-02-27 18:35:42 -03:00
parent 9f1daefe0a
commit 2631cb36a3
5 changed files with 167 additions and 1 deletions
+2 -1
View File
@@ -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. |
---
+8
View File
@@ -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
+60
View File
@@ -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.