[RFC-ADN-01] Normalizar nomenclatura de proyectos

- 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
This commit is contained in:
Ricardo Monla
2026-03-16 15:15:53 -03:00
parent f608924c6a
commit ba5c65e2a4
33 changed files with 883 additions and 390 deletions
-15
View File
@@ -1,15 +0,0 @@
Vamos a seguir agregando mejoras al ecosistema ADN a gregando nuevas herramientas y mejorando las existentes segun el plan docs/proy/p2604_mejoras_ADN/P2604_mejoras_ADN.md.
Puedes buscar como mejorar y sanear las herramientas existentes.
Continúa el trabajo priorizando siempre el uso y la optimización de las herramientas definidas en el ecosistema ADN, con el objetivo de mejorarlas y hacerlas reutilizables en el futuro. Si es necesario crear nuevas herramientas, asegúrate de que sigan los mismos principios de sostenibilidad y evita soluciones temporales o de un solo uso.
Para más contexto, consulta los lineamientos en `adn/README.md`, así como el índice actualizado de herramientas disponibles en ADN.
Recuerda seguir el flujo de trabajo establecido:
1. Actualizar el plan.
2. Documentar el progreso en la bitácora web.
3. Ejecutar las tareas correspondientes.
**Menos es mas, mejora continua y armonía integral**
+18
View File
@@ -0,0 +1,18 @@
PROMPT
En el plan docs/proy/p2601_dasuten/plan/P2601_6.1.B_AD-Join:_pc-dasu0_al_Dominio.md hay que agregar items y subitems de cambios de nombres de host de los nodos sql-dasuten a dasu-srvv-sql, dc-dasuten a dasu-srvv-dc y pcv-dasu0 a dasu-pcv0 que se deben realizar.
Continúa el trabajo priorizando siempre el uso y la optimización de las herramientas definidas en el ecosistema ADN, con el objetivo de mejorarlas y hacerlas reutilizables en el futuro. Si es necesario crear nuevas herramientas, asegúrate de que sigan los mismos principios de sostenibilidad y evita soluciones temporales o de un solo uso.
Para más contexto, consulta los lineamientos en `adn/README.md`, así como el índice actualizado de herramientas disponibles en ADN.
Recuerda que, si realizas optimizaciones o mejoras, el ecosistema ADN debe mantenerse actualizado para reflejar dichos cambios.
Sigue el flujo de trabajo establecido:
1. **Bitácora First:** registrar primero el contexto o situación en la bitácora.
2. **Actualizar el plan.**
3. **Ejecutar las tareas correspondientes.**
4. **Actualizar nuevamente la bitácora** con los resultados y avances.
**Menos es más, mejora continua y armonía integral.**
+203
View File
@@ -0,0 +1,203 @@
# RFC-ADN-01
## Convención de Identificación y Documentación de Proyectos
### Estado
Propuesta
### Alcance
Esta convención define el **esquema de identificación, estructura y documentación de proyectos** dentro del repositorio, principalmente en:
```
docs/proy
```
Su objetivo es garantizar:
* consistencia
* trazabilidad
* fácil navegación
* reutilización del conocimiento
* automatización futura
---
# 1. Identificación de proyectos
Cada proyecto debe tener un **identificador único**.
### Formato
```
PYYNN_TEMA
```
Donde:
| Elemento | Significado |
| -------- | ------------------------ |
| P | Prefijo de proyecto |
| YY | Año de creación |
| NN | Número correlativo |
| TEMA | Nombre corto descriptivo |
### Ejemplo
```
P2601_Dasuten
```
Interpretación:
* Proyecto 01
* Año 2026
* Tema: Dasuten
---
# 2. Estructura de secciones
Cada proyecto puede dividirse en **secciones y subsecciones**.
### Formato
```
PYYNN.NN.NN.TEMA
```
| Elemento | Significado |
| -------- | -------------------------- |
| PYYNN | Identificador del proyecto |
| NN | Sección |
| NN | Subsección |
| TEMA | Nombre corto |
### Ejemplo
```
P2601.01.01.Red-SrvDasu
```
Interpretación:
* Proyecto: P2601
* Sección: 01
* Subsección: 01
* Tema: Red del servidor Dasu
---
# 3. Datos de cabecera del proyecto
Cada proyecto debe iniciar con un bloque de metadatos.
Ejemplo:
```
Proyecto: P2601_Dasuten
Estado: En desarrollo
Versión: v0.1
Responsable: TIC
Fecha inicio: 2026
Ámbito: Infraestructura / Sistemas
```
Campos recomendados:
* Proyecto
* Estado
* Versión
* Fecha inicio
* Responsable
* Ámbito
* Contexto
* Objetivo
---
# 4. Estructura sugerida de documentación
Dentro de cada proyecto:
```
docs/proy/
P2601_Dasuten/
├── README.md
├── bitacora.md
├── plan.md
├── 01_contexto.md
├── 02_arquitectura.md
├── 03_implementacion.md
├── 04_operacion.md
├── 05_mejoras.md
```
---
# 5. Principios de diseño
La documentación debe seguir estos principios:
### Simplicidad
Evitar estructuras complejas.
### Escalabilidad
Debe funcionar tanto para proyectos pequeños como grandes.
### Navegabilidad
La estructura debe ser fácilmente entendible.
### Automatización futura
La nomenclatura debe permitir:
* generación automática de índices
* scripts de documentación
* trazabilidad entre proyectos
---
# 6. Integración con ecosistema ADN
Este estándar debe integrarse con el ecosistema ADN.
En particular:
* herramientas de documentación
* generación de plantillas
* bitácoras de proyectos
* automatización de repositorios
Referencia principal:
```
adn/README.md
```
---
# 7. Mejora continua
Este estándar **no es definitivo**.
Debe evolucionar mediante:
* nuevas necesidades
* retroalimentación del uso real
* optimización de herramientas ADN
---
# Principio rector
**Menos es más.
Mejora continua.
Armonía integral.**