# DEPLOYMENT_GUIDE.md — Guía de Despliegue del Organismo 4GatosCoin

Esta guía define el proceso oficial para desplegar el organismo 4GatosCoin en producción.  
Su objetivo es garantizar estabilidad, sincronización, seguridad y coherencia narrativa en cada release.

---

# 1. Principios del Despliegue

El despliegue del organismo sigue estos principios:

- **Seguridad primero**: nunca desplegar sin validar variables.  
- **Sincronización total**: backend, panel y estado global deben coincidir.  
- **No ruptura**: ningún órgano puede quedar desalineado.  
- **Narrativa coherente**: el despliegue no debe romper ciclos ni temporadas.  
- **Logs obligatorios**: cada despliegue debe quedar registrado.  
- **Staging antes de producción**: siempre.  

---

# 2. Flujo de Despliegue

```
develop → staging → validación → producción
```

### 2.1. develop
- integración continua  
- pruebas internas  
- validación de features  

### 2.2. staging
- entorno espejo de producción  
- pruebas completas del organismo  
- validación de sandbox  
- validación de OTT  
- validación de narrativa  

### 2.3. producción
- entorno real  
- estado global activo  
- usuarios reales  
- narrativa viva  

---

# 3. Validaciones Previas al Despliegue

Antes de desplegar, validar:

## 3.1. Variables de entorno
Obligatorias:

```
MONGODB_URI
NEXT_PUBLIC_API_URL
NEXTAUTH_SECRET
```

Nunca desplegar sin confirmar:

- conexión a MongoDB  
- conexión a backend  
- rutas API correctas  

## 3.2. Estado Global
Validar:

- energía coherente  
- territorio estable  
- ciclos correctos  
- temporada activa  
- latido sincronizado  

## 3.3. Órganos
Validar:

- gestos funcionando  
- energía generándose  
- semillas generándose  
- narrativa activa  
- rituales funcionando  
- OTT sincronizado  

## 3.4. Panel DevWeb3
Validar:

- todos los paneles cargan  
- endpoints responden  
- logs aparecen  
- sandbox funciona  

## 3.5. Tests
Validar:

- unitarios  
- integración  
- end‑to‑end  
- narrativos  
- territoriales  
- sandbox  

---

# 4. Proceso de Despliegue

## 4.1. Build
```
npm run build
```

## 4.2. Deploy
Dependiendo del proveedor:

- Vercel  
- Railway  
- Render  
- VPS propio  

## 4.3. Verificación
Después del deploy:

- abrir panel DevWeb3  
- abrir OTT  
- ejecutar un gesto real  
- verificar energía  
- verificar latido  
- verificar logs  
- verificar estado global  

---

# 5. Checklist de Despliegue

- [ ] variables confirmadas  
- [ ] backend conectado  
- [ ] panel sincronizado  
- [ ] sandbox validado  
- [ ] tests pasados  
- [ ] narrativa coherente  
- [ ] estado global estable  
- [ ] OTT funcionando  
- [ ] logs activos  
- [ ] documentación actualizada  

---

# 6. Despliegues de Temporada

Cuando se inicia una nueva temporada:

1. actualizar reglas  
2. actualizar narrativa  
3. actualizar OTT  
4. actualizar puntos  
5. actualizar energía  
6. actualizar territorio  
7. actualizar estado global  
8. validar en sandbox  
9. validar en staging  
10. desplegar  

---

# 7. Despliegues de Ritual

Cuando se activa un ritual mayor:

- nunca desplegar durante el ritual  
- esperar a que termine  
- validar estado global  
- validar energía  
- validar narrativa  
- desplegar solo si el organismo está estable  

---

# 8. Despliegues de Emergencia

Si ocurre una anomalía:

1. congelar producción  
2. activar sandbox  
3. reproducir anomalía  
4. identificar órgano afectado  
5. aplicar fix en rama `fix/*`  
6. validar en sandbox  
7. validar en staging  
8. desplegar fix  
9. registrar evento  

---

# 9. Roadmap del Despliegue

- despliegue ritual sincronizado  
- despliegue por zonas territoriales  
- despliegue narrativo dinámico  
- despliegue con rollback automático  
- despliegue con validación de ecos  

---

# 10. Licencia
Proyecto interno.  
Acceso restringido a desarrolladores autorizados.