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

---