[ADN] Ruby como estándar de codificación + nueva hebra Proyectos + manifiesto P2601
This commit is contained in:
+2
-1
@@ -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.
|
||||
Reference in New Issue
Block a user