# TERRITORY.md — Sistema de Territorio del Organismo 4GatosCoin

El **Territorio** es el órgano espacial del organismo 4GatosCoin.  
Representa la expansión, dominancia, zonas activas y el impacto colectivo de los gestos y la energía.

Este documento describe cómo funciona, cómo se actualiza, cómo se relaciona con otros órganos y cómo debe implementarse.

---

# 1. ¿Qué es el Territorio?

El territorio es una representación abstracta del espacio vital del organismo.  
Cada zona del territorio refleja:

- energía acumulada  
- actividad de gestos  
- memoria local  
- dominancia  
- ciclos completados  
- impacto ritual  

El territorio permite visualizar **cómo crece y se expande el organismo**.

---

# 2. Componentes Técnicos

### 2.1. Modelo
El territorio se almacena dentro del **Organismo Global**:

```
models/OrganismoGlobal.ts
```

Campos típicos:

```json
{
  "territorio": {
    "zonas": 4,
    "dominancia": {
      "norte": 12,
      "sur": 8,
      "este": 5,
      "oeste": 9
    }
  }
}
```

### 2.2. Endpoints relacionados
Futuro:

```
/api/territorio
/api/territorio/update
/api/territorio/zona/<id>
```

### 2.3. Panel DevWeb3
Ubicación:

```
app/devweb3/territorio/
```

Funciones:

- ver zonas  
- ver dominancia  
- ver energía por zona  
- ver expansión  
- activar eventos territoriales  

---

# 3. Zonas del Territorio

El territorio se divide en **zonas**, cada una con:

- energía local  
- memoria local  
- actividad de gestos  
- dominancia  
- estado narrativo  

Ejemplo:

```
norte
sur
este
oeste
```

Cada zona puede expandirse o contraerse según la actividad.

---

# 4. Flujo del Territorio

```
Gestos → Energía → Dominancia → Expansión → Ciclos → Temporadas
```

### 4.1. Entrada
El territorio recibe:

- energía global  
- energía por gesto  
- actividad por zona  
- eventos rituales  
- ciclos completados  

### 4.2. Procesamiento
El organismo calcula:

- dominancia por zona  
- expansión territorial  
- zonas activas  
- zonas dormidas  
- zonas en conflicto  

### 4.3. Salida
El territorio afecta:

- temporadas  
- visualización OTT  
- narrativa  
- memoria  
- avatar individual  

---

# 5. Dominancia Territorial

La dominancia es una medida de:

- actividad  
- energía  
- gestos  
- ecos  
- rituales  

Ejemplo:

```json
{
  "dominancia": {
    "norte": 12,
    "sur": 8
  }
}
```

### 5.1. Cómo se calcula
Factores:

- número de gestos  
- intensidad de ecos  
- energía generada  
- participación en rituales  
- ciclos locales  

---

# 6. Expansión Territorial

La expansión ocurre cuando:

- se alcanza un umbral de energía  
- se completa un ciclo  
- se activa un ritual  
- se genera un eco profundo  

### 6.1. Efectos de la expansión
- aumenta el número de zonas  
- cambia la dominancia  
- activa narrativa  
- puede iniciar una temporada  

---

# 7. Relación con Otros Órganos

### 7.1. Con Energía
La energía alimenta la expansión.

### 7.2. Con Gestos
Los gestos determinan actividad por zona.

### 7.3. Con Memoria
Cada expansión genera memoria profunda.

### 7.4. Con Ciclos
Los ciclos pueden redefinir zonas.

### 7.5. Con Temporadas
Las temporadas pueden:

- cambiar reglas territoriales  
- activar zonas especiales  
- cerrar zonas antiguas  

---

# 8. Ejemplos de Eventos Territoriales

### 8.1. Expansión
```json
{
  "type": "territory_expansion",
  "zones": 5
}
```

### 8.2. Dominancia
```json
{
  "type": "dominance_shift",
  "zone": "norte",
  "value": 14
}
```

### 8.3. Zona activa
```json
{
  "type": "zone_active",
  "zone": "oeste"
}
```

---

# 9. Cómo Extender el Territorio

1. Añadir campos en:
   ```
   OrganismoGlobal.territorio
   ```
2. Crear endpoints en:
   ```
   app/api/territorio/
   ```
3. Añadir lógica en:
   ```
   lib/territorio/
   ```
4. Añadir UI en:
   ```
   app/devweb3/territorio/
   ```
5. Actualizar memoria si aplica.
6. Actualizar narrativa si aplica.

---

# 10. Roadmap del Territorio

- zonas dinámicas  
- territorios combinatorios  
- territorios por temporada  
- territorios rituales  
- visualización OTT avanzada  
- territorios por avatar individual  

---

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