# SEEDS_SYSTEM.md — Sistema de Semillas del Organismo 4GatosCoin

Las **Semillas** son el recurso germinativo del organismo 4GatosCoin.  
Representan potencial, crecimiento, narrativa futura y evolución tanto individual como colectiva.

Este documento describe cómo funcionan, cómo se generan, cómo se distribuyen, cómo se almacenan y cómo afectan al organismo.

---

# 1. ¿Qué son las Semillas?

Las semillas representan:

- potencial narrativo  
- crecimiento futuro  
- evolución del avatar  
- activación de eventos  
- rarezas rituales  
- memoria profunda  
- expansión territorial  

Son un recurso **híbrido**: técnico y simbólico.

---

# 2. Componentes Técnicos

### 2.1. Modelo
Las semillas se almacenan en:

```
models/Seed.ts
```

Campos típicos:

```json
{
  "wallet": "0x123...",
  "seedId": "seed_001",
  "rarity": "common",
  "generatedAt": 1700000000,
  "metadata": {}
}
```

### 2.2. Endpoints relacionados

```
GET  /api/seeds
POST /api/seeds/generate
```

### 2.3. Panel DevWeb3
Ubicación:

```
app/devweb3/seeds/
```

Funciones:

- ver semillas por wallet  
- ver rarezas  
- ver generación  
- ver distribución  
- activar generación manual (solo dev)  

---

# 3. Flujo del Sistema de Semillas

```
Gesto → Puntos → Energía → Semilla → Avatar → Memoria → Temporada
```

### 3.1. Entrada
El sistema recibe:

- gestos  
- puntos  
- energía  
- ciclos  
- rituales  
- narrativa  

### 3.2. Generación
El sistema decide si generar una semilla según:

- tipo de gesto  
- racha  
- nivel del avatar  
- temporada  
- rareza  
- participación en rituales  

### 3.3. Salida
Las semillas afectan:

- narrativa personal  
- avatar  
- memoria  
- territorio  
- temporadas  

---

# 4. Tipos de Semillas

## 4.1. Semillas Comunes
- generadas por gestos frecuentes  
- baja rareza  
- impacto leve  

## 4.2. Semillas Raras
- generadas por rachas  
- impacto moderado  
- pueden activar narrativa  

## 4.3. Semillas Épicas
- generadas por rituales  
- impacto fuerte  
- pueden activar eventos  

## 4.4. Semillas Legendarias
- extremadamente raras  
- generadas por ciclos o temporadas  
- impacto profundo  
- pueden alterar territorio  

---

# 5. Reglas de Generación

### 5.1. Por gestos
Ejemplo:

```
pulso_vocal → 5% probabilidad
reflection → 2% probabilidad
mirror → 8% probabilidad
```

### 5.2. Por racha
Ejemplo:

```
racha 7 días → +10% probabilidad
```

### 5.3. Por avatar
Ejemplo:

```
nivel 5 → +5% probabilidad
nivel 10 → +12% probabilidad
```

### 5.4. Por temporada
Ejemplo:

```
Temporada 3 — Eco Expansivo → +20% probabilidad
```

### 5.5. Por ritual
Ejemplo:

```
El Grito Que Crea → semilla épica garantizada
```

---

# 6. Rarezas

| Rareza      | Probabilidad Base | Impacto |
|-------------|-------------------|---------|
| common      | 80%               | bajo    |
| rare        | 15%               | medio   |
| epic        | 4%                | alto    |
| legendary   | 1%                | muy alto|

Las rarezas pueden cambiar por temporada.

---

# 7. Distribución de Semillas

Las semillas se distribuyen:

- por wallet  
- por avatar  
- por zona territorial  
- por temporada  
- por ritual  

Ejemplo:

```json
{
  "wallet": "0xabc...",
  "seeds": [
    { "seedId": "seed_001", "rarity": "rare" },
    { "seedId": "seed_002", "rarity": "common" }
  ]
}
```

---

# 8. Relación con Otros Órganos

### 8.1. Con Puntos
Los puntos aumentan probabilidad de generación.

### 8.2. Con Energía
Las semillas pueden generar energía pasiva.

### 8.3. Con Avatar
Las semillas afectan evolución y narrativa.

### 8.4. Con Memoria
Las semillas generan memoria profunda.

### 8.5. Con Territorio
Las semillas legendarias pueden expandir zonas.

### 8.6. Con Temporadas
Las temporadas redefinen rarezas y reglas.

### 8.7. Con Rituales
Los rituales generan semillas épicas o legendarias.

---

# 9. Ejemplo de Evento de Semilla

```json
{
  "type": "seed_generated",
  "wallet": "0xabc...",
  "rarity": "epic",
  "seedId": "seed_777"
}
```

---

# 10. Cómo Extender el Sistema de Semillas

1. Añadir campos en:
   ```
   models/Seed.ts
   ```
2. Crear endpoints en:
   ```
   app/api/seeds/
   ```
3. Añadir lógica en:
   ```
   lib/seeds/
   ```
4. Añadir UI en:
   ```
   app/devweb3/seeds/
   ```
5. Actualizar narrativa si aplica.
6. Actualizar documentación.

---

# 11. Roadmap del Sistema de Semillas

- semillas combinatorias  
- semillas por avatar  
- semillas rituales avanzadas  
- semillas territoriales  
- semillas visualizadas en OTT  
- semillas por temporada  
- semillas narrativas  

---

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