Archive: System v4 - Estado al 2024-12-24

v4-archive/system/06-flujos.md

@@ -0,0 +1,82 @@
+# Flujos de Trabajo
+
+## Reglas de Ejecución por Instancia
+
+### Principio Fundamental
+
+**Cada instancia Claude solo ejecuta comandos directamente en su propio servidor.**
+
+| Instancia | Servidor | IP | Puede ejecutar en |
+|-----------|----------|-----|-------------------|
+| architect | ARCHITECT | 69.62.126.110 | Solo ARCHITECT |
+| hst | HST | 72.62.2.84 | Solo HST |
+| deck | DECK | 72.62.1.113 | Solo DECK |
+| corp | CORP | 92.112.181.188 | Solo CORP |
+| runpod | RunPod | Variable | Solo sus pods |
+| locker | ARCHITECT | 69.62.126.110 | Solo su contexto |
+
+### Delegación de Tareas
+
+Cuando una instancia necesita que se ejecute algo en otro servidor:
+
+1. **NO ejecutar directamente** via SSH al otro servidor
+2. **Enviar mensaje** a la instancia correspondiente via PostgreSQL
+3. **Documentar** la tarea solicitada
+4. **Esperar** confirmación de la otra instancia
+
+### Ejemplo de Delegación
+
+```sql
+-- architect necesita que deck ejecute algo
+INSERT INTO mensajes_v2 (conversacion_id, role, contenido)
+SELECT id, 'user', 'Ejecuta X en tu servidor'
+FROM conversaciones
+WHERE instancia_id = 'deck' AND activa = true;
+```
+
+### Excepciones
+
+- **Consultas de solo lectura**: Se permiten consultas SSH para verificar estado
+- **Emergencias**: En caso de caída de una instancia, otra puede intervenir temporalmente
+
+---
+
+## Comunicación Entre Instancias
+
+### Canal Principal: PostgreSQL
+
+Tabla `mensajes_v2` con estructura de chat por conversación.
+
+```
+conversaciones (instancia_id) --> mensajes_v2 (conversacion_id)
+```
+
+### Flujo de Mensaje
+
+1. Instancia origen inserta mensaje con role='user'
+2. Windmill detecta mensaje pendiente
+3. Windmill invoca Claude de la instancia destino
+4. Respuesta se guarda con role='assistant'
+
+---
+
+## Windmill
+
+### Triggers
+
+| Trigger | Frecuencia | Función |
+|---------|------------|---------|
+| Mensaje nuevo | 30s | Procesar mensajes pendientes |
+| Retry queue | 5m | Reintentar envíos fallidos |
+| Heartbeat | 1h | Verificar estado de instancias |
+
+### Endpoint
+
+```
+URL: https://flows.tzzr.me
+Workspace: admins
+```
+
+---
+
+*Actualizado: 2025-12-21*