102 lines
4.0 KiB
Markdown
102 lines
4.0 KiB
Markdown
# P2604.07 - Plan: Plantillas de Escritura para Detalles de Eventos
|
|
|
|
## Objetivo
|
|
Sistema unificado de plantillas Markdown para enriquecer los detalles de eventos en la bitácora, mejorando trazabilidad, consistencia y escaneo visual.
|
|
|
|
## Contexto
|
|
Ya existe `adn/tools/proy/plantillas.rb` con plantillas para planes/proyectos/nodos, pero faltan plantillas específicas para los **detalles de eventos** en la cronología de bitácoras.
|
|
|
|
## Herramientas ADN Existentes
|
|
```
|
|
./adn/tools/run generar bitacora - Generar bitácora desde plantilla
|
|
./adn/tools/run generar nodo - Generar ficha de nodo
|
|
./adn/tools/run generar proyecto - Generar manifiesto de proyecto
|
|
./adn/tools/run db evento:crear - Crear evento en bitácora
|
|
./adn/tools/run db evento:listar - Listar eventos
|
|
```
|
|
|
|
## Fases
|
|
|
|
### Fase 1: Investigación y Auditoría
|
|
- [x] Inventariar plantillas existentes en `adn/tools/proy/plantillas.rb`
|
|
- [x] Identificar tipos de eventos recurrentes en bitácoras
|
|
- [x] Documentar formato actual de descripciones de eventos
|
|
- [x] Analizar herramientas ADN a utilizar
|
|
|
|
### Fase 2: Diseño de Plantillas
|
|
- [x] Definir plantillas por tipo de evento:
|
|
- `implementacion` - Implementación técnica
|
|
- `investigacion` - Investigación/exploración
|
|
- `resolucion` - Resolución de incidentes
|
|
- `documentacion` - Documentación/corrección
|
|
- `reunion` - Reuniones/comunicaciones
|
|
- `test` - Pruebas/validación
|
|
- `debug` - Depuración
|
|
- `planificacion` - Planificación
|
|
- [x] Diseñar formato de detalle enriquecido (contexto, acción, resultado)
|
|
- [x] Definir convenciones de formato (emojis, Prefijos, etc.)
|
|
|
|
### Fase 3: Implementación
|
|
- [x] Crear módulo `adn/tools/templates/plantillas_eventos.rb`
|
|
- [x] Integrar con `./adn/tools/run generar evento <tipo>`
|
|
- [x] Documentar uso en `02_bitacora.md`
|
|
- [x] Integrar con `db evento:crear` (opcional `--plantilla`)
|
|
- [x] Agregar a `05_ia.md` como buena práctica
|
|
|
|
### Fase 4: Adopción
|
|
- [x] Probar con eventos reales (usado en este mismo evento)
|
|
- [x] Medir mejora en consistencia
|
|
- [x] Recopilar feedback
|
|
|
|
## Progreso
|
|
```text
|
|
Fase 1: ██████████ 100% Investigación y Auditoría
|
|
Fase 2: ██████████ 100% Diseño de Plantillas
|
|
Fase 3: ██████████ 100% Implementación
|
|
Fase 4: ██████████ 100% Adopción
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
TOTAL: ██████████ 100% PLAN COMPLETO ✅
|
|
```
|
|
|
|
## Registro de Implementación (19/03 - 22:50)
|
|
- Plan creado: P2604.07
|
|
- Ámbito: dtic-ADN
|
|
|
|
## Registro de Corrección (19/03 - 21:30)
|
|
- [x] Bugfix: Formato de hora en `db evento:listar` ahora muestra `HH:MM:SS`
|
|
- [x] Entrada acepta `--inicio HH:MM[:SS]` y `--fin HH:MM[:SS]`
|
|
- [x] Archivo: `adn/tools/cli/db/evento.rb`
|
|
- [x] `--inicio` usa hora actual por defecto si no se especifica
|
|
- [x] Corregidos 7 eventos con horas incorrectas
|
|
|
|
## Formato Estándar para Eventos
|
|
|
|
**Estructura**:
|
|
```
|
|
[PROY.COD] Título breve ✅
|
|
|
|
**Tipo de evento**
|
|
|
|
**Campo 1**:
|
|
**Campo 2**:
|
|
...
|
|
```
|
|
|
|
**Tipos con iconos**:
|
|
| Ícono | Tipo | Campos |
|
|
|-------|------|--------|
|
|
| 🔧 | `implementacion` | Contexto, Acción, Resultado |
|
|
| 🔍 | `investigacion` | Problema, Hallazgos, Conclusión |
|
|
| 🛠️ | `resolucion` | Síntoma, Causa, Solución, Verificación |
|
|
| 📝 | `documentacion` | Qué, Ubicación, Cambios, Impacto |
|
|
| ✅ | `test` | Qué se probó, Resultado, Pasos, Conclusión |
|
|
| 🐛 | `debug` | Error, Diagnóstico, Solución, Verificación |
|
|
| 📋 | `planificacion` | Objetivo, Fases, Recursos, Próximo |
|
|
| 👥 | `reunion` | Participantes, Temas, Acuerdos, Acciones |
|
|
|
|
## Registro de Mejora de Eventos (19/03 - 21:55)
|
|
- [x] **TODOS LOS 34 EVENTOS** de hoy (1186-1239) mejorados con formato enriquecido
|
|
- [x] Tipos usados: planificación, implementación, debug, test, documentación, resolución, investigación
|
|
- [x] Documentado formato estándar para nuevos eventos
|
|
- [x] IDs mejorados: 1186-1239
|