# AURANET.md — Sistema de Identidad y Presencia (4GatosCoin)

**Auranet** es el sistema de identidad del ecosistema 4GatosCoin.  
Es la capa que conecta al usuario humano con su avatar, su narrativa, sus gestos y su presencia dentro del organismo.

Este documento describe cómo funciona, cómo se registra un usuario, cómo se sincroniza con el organismo y cómo debe implementarse.

---

# 1. ¿Qué es Auranet?

Auranet es:

- el **registro de identidad** del usuario  
- la **puerta de entrada** al organismo  
- el **vínculo** entre wallet y avatar  
- el **perfil ritual** del usuario  
- la **memoria pública** de su actividad  

Auranet no es una red social:  
es un **sistema de presencia ritual**.

---

# 2. Componentes Técnicos

### 2.1. Modelo
Auranet se almacena en:

```
models/Aura.ts
```

Campos típicos:

```json
{
  "wallet": "0x123...",
  "username": "gatito",
  "avatarState": {
    "nivel": 3,
    "energiaPersonal": 120
  },
  "joinedAt": 1700000000
}
```

### 2.2. Endpoints relacionados

```
POST /api/auranet/register
GET  /api/profile
```

### 2.3. Panel DevWeb3
Ubicación:

```
app/devweb3/aura/
```

Funciones:

- ver perfiles  
- ver estado del avatar  
- ver narrativa personal  
- ver sincronización con el organismo  

---

# 3. Flujo de Registro en Auranet

```
Wallet → Firma → Registro → Avatar → Organismo
```

### 3.1. Wallet
El usuario conecta su wallet.

### 3.2. Firma
Se valida la identidad mediante firma.

### 3.3. Registro
El endpoint:

```
POST /api/auranet/register
```

crea un perfil con:

- wallet  
- username  
- avatar inicial  
- narrativa inicial  

### 3.4. Avatar
Se crea un estado inicial del avatar:

- nivel 1  
- energía personal mínima  
- narrativa vacía  

### 3.5. Organismo
El usuario queda sincronizado con:

- memoria  
- territorio  
- ciclos  
- temporadas  

---

# 4. Perfil del Usuario

El perfil ritual incluye:

- wallet  
- username  
- avatar  
- puntos  
- semillas  
- gestos totales  
- narrativa personal  
- hitos  
- participación en rituales  

Ejemplo:

```json
{
  "wallet": "0xabc...",
  "username": "gato_solar",
  "points": 42,
  "seeds": 4,
  "gestures": 88,
  "avatar": {
    "nivel": 4,
    "energiaPersonal": 180
  }
}
```

---

# 5. Relación con Otros Órganos

### 5.1. Con Avatar
Auranet es el contenedor del avatar.

### 5.2. Con Gestos
Cada gesto se asocia a un usuario registrado.

### 5.3. Con Puntos
Los puntos se reflejan en el perfil.

### 5.4. Con Memoria
La narrativa personal se integra en Auranet.

### 5.5. Con Territorio
La actividad del usuario influye en zonas.

### 5.6. Con Temporadas
Las temporadas pueden modificar:

- niveles  
- narrativa  
- hitos  

---

# 6. Sincronización con el Organismo

Auranet sincroniza:

- avatar  
- memoria  
- puntos  
- semillas  
- narrativa  
- hitos  
- participación ritual  

Cada acción del usuario actualiza su presencia en Auranet.

---

# 7. Ejemplo de Registro

### Petición
```bash
curl -X POST https://tudominio.com/api/auranet/register \
  -H "Content-Type: application/json" \
  -d '{"wallet":"0x123...", "username":"gatito"}'
```

### Respuesta
```json
{
  "registered": true,
  "wallet": "0x123...",
  "username": "gatito"
}
```

---

# 8. Cómo Extender Auranet

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

---

# 9. Roadmap de Auranet

- perfiles visuales  
- narrativa generativa  
- insignias rituales  
- ecos personales  
- sincronización con OTT  
- temporadas personales  
- logros avanzados  

---

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