dtic-DIIAA/docs/prompt/260325-0900_Contexto-IA.md

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:

# 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.

./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:

./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:

# ✅ 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

• 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:

# ⚠️ 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.

---

📊 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

# 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

---