[ADN] Ruby como estándar de codificación + nueva hebra Proyectos + manifiesto P2601
This commit is contained in:
@@ -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