rmonla/dtic-DIIAA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Plan P2603.01 Automatización Zoom y actualizaciones P2601.09

Browse Source
This commit is contained in:
Ricardo Monla
2026-03-31 18:03:21 -03:00
parent 160da47f96
commit 1fd213173e
72 changed files with 19694 additions and 460 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/prompt/260325-0900_Contexto-IA.md
-340
View File
@@ -1,340 +0,0 @@
# Contexto para IA - Mecánica de Trabajo dtic-DIIAA
**Fecha:** 2026-03-25
**Versión:** 1.3 - Minimalista (Principio "menos es más")
**Bitácora de referencia:** Eventos 1261-1300 (2026-03-25 y 2026-03-26)
**Actualización:** Zona horaria Argentina agregada, renombramiento dasu-pc/dasu-pcv
---
## 🌎 Zona Horaria
**IMPORTANTE**: Este proyecto opera en la zona horaria de **Argentina (Buenos Aires)**.
- **UTC**: UTC-3 (hora estándar argentina, sin DST)
- **Comando local**: Usar `date` para obtener la hora correcta
- **Formato registro**: HH:MM (24 horas)
- **⚠️ CRÍTICO**: Los eventos deben usar la hora real del sistema, NO la hora del agente IA
---
## 🌎 Zona Horaria
**IMPORTANTE**: Este proyecto opera en la zona horaria de **Argentina (Buenos Aires)**.
- **UTC**: Argentina no tiene horario de verano permanente (UTC-3)
- **Comando local**: Usar `date` para obtener la hora correcta
- **Formato registro**: HH:MM (24 horas)
---
## 🎯 Principio Fundamental: Bitácora First
**TODO lo que hagas DEBE registrarse en bitácora ANTES de ejecutar.**
### Flujo obligatorio:
```
1. Registrar contexto en bitácora (db evento:crear)
2. Ejecutar la tarea
3. Actualizar bitácora con resultados (db evento:actualizar --fin)
```
### Ejemplo práctico:
```bash
# 1. ANTES de empezar, registrás
./adn/tools/run db evento:crear --nodo dtic-DIIAA \
--descripcion "[P2604.06] Descripción de lo que voy a hacer" \
--inicio 08:00
# 2. Ejecutás la tarea
./adn/tools/run <comando>
# 3. Al terminar, actualizás con la hora de fin
./adn/tools/run db evento:actualizar <ID> --fin 08:15
```
---
## 🧬 Arquitectura del Ecosistema ADN
### Estructura de comandos:
```
./adn/tools/run <subcomando> [opciones]
```
### ⚠️ REGLA CRÍTICA: Antes de SSH
**SIEMPRE ejecutar:** `./adn/tools/run nodos info <nombre>`
Esto muestra: IP, Puerto SSH, Usuario, Auth, Bóveda, SO, VMID
### Subcomandos principales:
| Categoría | Comandos |
|-----------|----------|
| **Bitácoras** | `db evento:crear`, `db evento:actualizar`, `db evento:listar`, `jornada iniciar/cerrar` |
| **Nodos** | `nodos listar`, `nodos info <nombre>`, `ssh <nodo> [comando]` |
| **Ámbitos** | `ambitos listar`, `ambitos nodos <nombre>`, `ambitos crear` |
| **Seguridad** | `candados authorize`, `candados run <clave> <cmd>` |
| **Operaciones** | `backup <nodo>`, `salud`, `network show` |
| **Generación** | `generar bitacora`, `generar nodo`, `generar evento <tipo>` |
| **W-Zombi** | `wzombi start`, `wzombi cmd "<comando>"`, `wzombi log` |
### ⚠️ REGLA PARA IA: Antes de leer código fuente
**SIEMPRE** ejecutar `./adn/tools/run <subcomando> --help` o `./adn/tools/run ayuda <subcomando>` **ANTES** de leer archivos `.rb` para entender cómo funciona una herramienta. La ayuda integrada es suficiente en la mayoría de los casos.
### Plantillas de Eventos
**OBLIGATORIO**: Usar plantillas para todos los eventos con detalles ricos.
```bash
./adn/tools/run generar evento <tipo>
```
**Tipos disponibles** (11):
| Icono | Tipo | Uso |
|-------|------|-----|
| 🔧 | `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 |
| 🔄 | `migracion` | Migraciones de red/sistemas |
| ✏️ | `renombramiento` | Cambios de nombre de nodos |
| 🛡️ | `backup` | Resguardos/VZDumps |
### Base de datos:
- **Host:** localhost:5433
- **DB:** dtic_bitacoras
- **Schema:** bitacoras
- **Tablas:** nodos, bitacoras, entradas, temas, gestion, proyectos, fases, hitos
---
## 📋 Convenciones de Registro
### Formato de descripciones:
```
[CÓDIGO_PROYECTO] Descripción breve
**Detalle 1**: Valor
**Detalle 2**: Valor
**Próximo**: Qué sigue
```
### Ejemplo real:
```
[P2604.06] Mejora herramienta candados: migración de temporales
**Archivos modificados**: candados.rb, README.md
**Principio**: 05_ia.md #11 (Workspace Bounds)
**Próximo**: Actualizar documentación
```
### Referencia a planes en eventos:
Cuando un evento está asociado a un plan `.md`, usar el flag `--doc` para vincular:
**Formato CLI:**
```bash
./adn/tools/run db evento:crear --doc P2601_Dasuten/P2601.09_DASUTEN-sin-DC.md ...
./adn/tools/run db evento:actualizar 1308 --doc P2604_Mejoras-ADN/P2604_Mejoras-ADN.md
```
**Campo BD:** `doc_path` en tabla `bitacoras.entradas` (formato: `CARPETA/ARCHIVO.md`).
**En la web:** Se renderiza como botón clickeable que abre el `.md` en un modal. El contenido se lee del disco dinámicamente — no necesita reiniciar Docker.
**⚠️ IMPORTANTE:** Si se renombra el archivo `.md`, solo hay que actualizar el campo `doc_path` en los eventos afectados (un solo UPDATE).
### Tiempos:
- **Siempre** registrar `--inicio` y `--fin`
- **USAR TIEMPO REAL**: hora actual del sistema, no secuencias teóricas
- Los eventos son **secuenciales**, no simultáneos
- Si trabajás en paralelo, usá diferentes `--nodo`
**⚠️ IMPORTANTE:**
```bash
# ✅ CORRECTO: Tiempo real
./adn/tools/run db evento:crear --inicio $(date +%H:%M)
# ❌ INCORRECTO: Forzar secuencias artificiales
# No inventes tiempos "lógicos" si la tarea real empezó ahora
```
---
## 🔐 Seguridad
**⚠️ LEER ANTES DE OPERAR:** [`adn/03_seguridad.md`](../adn/03_seguridad.md)
- Contiene protocolos de seguridad, gestión de candados y matriz de acceso SSH
- **Nunca** escribir secretos en texto plano o commitearlos
- Usar `tmp/` del repo, nunca `/tmp/` del sistema
---
## 🌐 Topología de Red
### Comandos útiles:
```bash
# ⚠️ SIEMPRE ejecutar esto ANTES de conectar por SSH
./adn/tools/run nodos info <nombre-nodo>
# Ver topología completa
./adn/tools/run network show --formato texto
# Listar todos los nodos
./adn/tools/run nodos listar
```
**El comando `nodos info` muestra: IP, Puerto SSH, Usuario, Auth, Bóveda, SO, VMID**
### Nodos comunes:
- `dtic-DIIAA` - Nodo principal (donde trabajás)
- `srv-ns8` - Servidor principal
- `dasu-srvv-sql` - SQL Server
- `dasu-srvv-dc` - Domain Controller
- `dtic-EVENTOS` - Gestión de eventos y videoconferencias
- `dtic-DIGI` - Grabaciones y contenidos digitales (YouTube)
### ⚠️ Puertos SSH por Nodo
- **Linux VMs**: Puerto 22 (estándar)
- **Windows VMs (dasu-srvv-dc, dasu-srvv-sql, dasu-pcv)**: Puerto **7022** (OpenSSH hardeado)
- **PCs físicas Windows**: Puerto **7022** (si tiene OpenSSH)
---
## 📁 Estructura del Repositorio
```
dtic-DIIAA/
├── adn/ # Núcleo del ecosistema
│ ├── 00_indice.md # Mapa general
│ ├── 01_ontologia.md # Nodos y topología
│ ├── 02_bitacora.md # Formato de registro
│ ├── 05_ia.md # Directivas para IA ⚠️
│ └── tools/ # Herramientas CLI
├── docs/
│ ├── bitacoras/ # Bitácoras diarias (exportadas)
│ ├── proy/ # Proyectos (P2604_*)
│ └── prompt/ # Contexto para IA
├── nodos/ # Fichas de nodos
├── tmp/ # Temporales (único tmp válido)
└── servicios/ # Docker Compose
```
---
## 🤖 Flujo de Trabajo con IA
### Cuando el usuario pide algo:
1. **Verificar si está registrado en bitácora**
- Si no → `db evento:crear` primero
- Si sí → continuar
2. **Ejecutar la tarea**
- Usar comandos `./adn/tools/run`
- Seguir principios de `adn/05_ia.md`
3. **Actualizar bitácora**
- `db evento:actualizar <ID> --fin HH:MM`
- Incluir resultados y próximos pasos
### Errores comunes a evitar:
❌ Ejecutar sin registrar en bitácora
❌ Todos los eventos con misma hora de inicio
❌ Olvidar el `--fin` al terminar
❌ Usar `/tmp/` en lugar de `tmp/` del repo
❌ No verificar candados antes de SSH
---
## 🏢 Ámbitos del Sistema
**Ver listado actual:** `./adn/tools/run ambitos listar`
Los ámbitos agrupan nodos por área funcional. La lista completa y actualizada está en [`adn/01_ontologia.md`](../adn/01_ontologia.md).
---
## 📊 Bitácora Web - Fichas por Ámbito
**Implementado:** 2026-03-25
La vista principal de la Bitácora Web ahora agrupa las entradas **por Ámbito** en lugar de por Nodo:
- Cada ficha muestra todos los eventos de los nodos del ámbito
- Columna "Nodo" identifica el origen de cada evento
- Badge muestra cantidad de nodos y entradas del ámbito
**URL:** http://localhost:5174/bitacoras/
---
## 📚 Documentación de Referencia
| Archivo | Propósito |
|---------|-----------|
| `adn/README.md` | Punto de entrada al ecosistema |
| `adn/05_ia.md` | Directivas específicas para IA ⚠️ |
| `adn/02_bitacora.md` | Formato y triggers de bitácoras |
| `adn/03_seguridad.md` | Protocolos de seguridad y candados 🔐 |
| `adn/01_ontologia.md` | Nodos, ámbitos y topología |
| `docs/prompt/260325-0809_Contexto.md` | Contexto inicial del proyecto |
| `docs/prompt/260325-0900_Contexto-IA.md` | Este archivo - Contexto (minimalista) |
---
## 🚀 Quick Start para Nueva Sesión
```bash
# 1. Iniciar jornada
./adn/tools/run jornada iniciar presencial 08:00
# 2. Registrar primera actividad
./adn/tools/run db evento:crear --nodo dtic-DIIAA \
--descripcion "[P2604.XX] Lo que voy a hacer" \
--inicio 08:05
# 3. Trabajar
# ... ejecutás tus comandos ...
# 4. Cerrar actividad
./adn/tools/run db evento:actualizar <ID> --fin 08:30
# 5. Verificar en web
# http://localhost:5174
```
---
**Última actualización:** 2026-03-26 09:00
**Próxima revisión:** Al inicio de cada sesión
---
## 📌 Principio "Menos es Más"
Este archivo contiene solo lo esencial para operar. Para detalles completos, consultar las hebras canónicas:
- Seguridad → `adn/03_seguridad.md`
- Ontología/Ámbitos → `adn/01_ontologia.md`
- Bitácoras → `adn/02_bitacora.md`
- IA Directivas → `adn/05_ia.md`
---
docs/prompt/260330_Continua.md
+6
View File
@@ -0,0 +1,6 @@
Lee docs/contexto/IA.md y docs/ambito/dtic-DASUTEN/P2601.09_DASUTEN-sin-DC.md.
Actualiza la bitácora, el plan y el contexto, si corresponde.
Luego, podés continuar con lo último que dejamos pendiente.
Recuerda que los elementos temporales están prácticamente prohibidos, ya que lo que se busca es verificar si las herramientas ADN pueden resolver el problema; de lo contrario, se deberá crear o mejorar la existente para lograr una solución eficiente, reutilizable y no temporal.