- Directorios: PascalCase (p2601_dasuten → P2601_Dasuten) - Planes: numeración pura (P2601_6.1.A → P2601.06.01) - Sin caracteres especiales en nombres de archivo - 07_proyectos.md: convención RFC-ADN-01 integrada, P2604/P2605 agregados - evento:listar: nueva opción --detalle para descripciones completas
4.3 KiB
07 - Hebra: Proyectos
Referencia canónica:
adn/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 jerá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 (RFC-ADN-01)
Código de Proyecto
PYYNN_Tema
| Elemento | Significado | Ejemplo |
|---|---|---|
P |
Prefijo fijo | P |
YY |
Año de creación (2 dígitos) | 26 |
NN |
Número correlativo | 01 |
Tema |
Nombre corto (PascalCase) | Dasuten |
Ejemplo: P2601_Dasuten → Proyecto 01, año 2026, tema Dasuten.
Secciones y Sub-secciones
PYYNN.SS.ss_Tema.md
| Elemento | Significado | Ejemplo |
|---|---|---|
PYYNN |
ID del proyecto | P2601 |
SS |
Sección (2 dígitos) | 06 |
ss |
Subsección (2 dígitos) | 01 |
Tema |
Nombre corto (guiones) | Red-SrvDasu |
Ejemplo: P2601.06.01_Red-SrvDasu.md → P2601, sección 06, sub 01, tema Red del servidor Dasu.
Directorio del Proyecto
docs/proy/PYYNN_Tema/
├── README.md ← Manifiesto (o PYYNN_Tema.md)
├── plan/ ← Planes de ejecución
│ └── PYYNN.SS.ss_Tema.md
└── _hist/ ← Archivo histórico
Reglas de nomenclatura:
- Directorios:
PascalCasecon guión bajo (P2601_Dasuten) - Archivos de plan: Numeración pura, guiones en tema (
P2601.06.01_Red-SrvDasu.md) - Sin caracteres especiales (
:, espacios) en nombres de archivo
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). |
| Topología y Red | Contexto espacial: subredes, hypervisors, aislamiento NAT y reglas de ruteo/VPN. |
| Nodos Involucrados | Qué infraestructura participa (links a nodos/). Categorizar en Core y Soporte. |
| 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.
6. Proyectos Activos
| Código | Nombre | Estado | Manifiesto |
|---|---|---|---|
| P2601 | Sistema DASUTEN | ⏳ | P2601_Dasuten |
| P2602 | Backups DTIC | ⏳ | P2602_Backups |
| P2603 | Sistema de Bitácoras | ⏳ | P2603_Bitacoras |
| P2604 | Mejoras ADN | ⏳ | P2604_Mejoras-ADN |
| P2605 | Bitácoras Web | ⏳ | P2605_Bitacoras-Web |