Files
system-docs/v4-archive/system/06-flujos.md
2025-12-24 17:28:34 +00:00

83 lines
2.0 KiB
Markdown

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