feat: initial project setup

2026-03-21 08:49:51 +01:00
commit 0ae87f16c7
88 changed files with 10755 additions and 0 deletions
--- a/docs/setup/04-discord.md
+++ b/docs/setup/04-discord.md
@@ -0,0 +1,125 @@
+# Setup 04 — Discord Apps y Bots
+
+Necesitas crear **9 Discord Applications** separadas (una por agente). Cada una tiene su propio bot token.
+
+## 1. Activar Developer Mode en Discord
+
+1. Abre Discord → **Ajustes** (icono de rueda)
+2. **Avanzado** → activa **"Modo desarrollador"**
+
+Esto te permitirá hacer click derecho en canales y copiar sus IDs.
+
+## 2. Crear los 9 canales en tu servidor Discord
+
+Ve a tu servidor → crea estos canales de texto:
+
+| Canal | Agente |
+|-------|--------|
+| `el-trono-de-hierro` | Tyrion (orquestador) |
+| `el-pajarillo` | Varys |
+| `la-ciudadela` | Samwell |
+| `el-banco-de-hierro` | Bronn |
+| `el-muro` | Bran |
+| `desembarco-del-rey` | Davos |
+| `cara-sin-nombre` | Arya |
+| `poniente-en-llamas` | Daenerys |
+| `la-guardia-de-la-noche` | Jon |
+
+**Recomendado:** Crea una categoría llamada `LA MANO DEL REY` y agrupa todos los canales ahí.
+
+## 3. Copiar los Channel IDs
+
+Para cada canal:
+1. Click derecho en el canal
+2. Clic en **"Copiar ID del canal"**
+3. Guárdalo — lo necesitarás para el `.env` de los agentes
+
+## 4. Crear las 9 Discord Applications
+
+Repite este proceso 9 veces (una por agente):
+
+### Paso a paso para CADA bot:
+
+1. Ve a [discord.com/developers/applications](https://discord.com/developers/applications)
+2. Clic en **"New Application"**
+3. Nombre según la tabla:
+
+| Application Name | Variable del token |
+|-----------------|-------------------|
+| `Tyrion Lannister` | `DISCORD_TOKEN_TYRION` |
+| `Varys` | `DISCORD_TOKEN_VARYS` |
+| `Samwell Tarly` | `DISCORD_TOKEN_SAMWELL` |
+| `Bronn` | `DISCORD_TOKEN_BRONN` |
+| `Bran Stark` | `DISCORD_TOKEN_BRAN` |
+| `Davos Seaworth` | `DISCORD_TOKEN_DAVOS` |
+| `Arya Stark` | `DISCORD_TOKEN_ARYA` |
+| `Daenerys Targaryen` | `DISCORD_TOKEN_DAENERYS` |
+| `Jon Snow` | `DISCORD_TOKEN_JON` |
+
+4. Acepta los Terms of Service → **"Create"**
+
+5. Ve a la pestaña **"Bot"** (menú izquierdo)
+
+6. Activa los **Privileged Gateway Intents**:
+   - ✅ **Message Content Intent** (OBLIGATORIO)
+   - Los otros son opcionales
+
+7. Clic en **"Reset Token"** → **"Yes, do it"** → **Copia el token**
+   > Guárdalo inmediatamente, solo se muestra una vez.
+
+8. Ve a **OAuth2** → **URL Generator**:
+   - Scopes: ✅ `bot`
+   - Bot permissions: ✅ `Read Messages/View Channels`, ✅ `Send Messages`, ✅ `Read Message History`
+   - Copia la URL generada
+
+9. Abre la URL en el navegador → selecciona tu servidor → **"Autorizar"**
+
+Repite los pasos 2-9 para los 9 agentes.
+
+## 5. Verificar que los bots están en el servidor
+
+En tu servidor Discord, en la lista de miembros o en los canales, deberías ver los 9 bots como miembros (aparecerán como offline hasta que los levantes).
+
+## 6. (Opcional) Personalizar los bots
+
+Para que cada bot tenga avatar y descripción:
+
+1. En la app de Discord Developer → **General Information**
+2. Sube una foto de perfil (imagen del personaje de GoT)
+3. Añade descripción
+
+## Checklist
+
+- [ ] Developer Mode activado en Discord
+- [ ] 9 canales creados en el servidor
+- [ ] 9 Channel IDs copiados
+- [ ] 9 Discord Applications creadas
+- [ ] "Message Content Intent" activado en las 9
+- [ ] 9 Bot Tokens copiados
+- [ ] Los 9 bots invitados al servidor
+
+## Resumen de variables `.env` de esta fase
+
+```bash
+# Tokens (de Discord Developer Portal)
+DISCORD_TOKEN_TYRION=<token>
+DISCORD_TOKEN_VARYS=<token>
+DISCORD_TOKEN_SAMWELL=<token>
+DISCORD_TOKEN_BRONN=<token>
+DISCORD_TOKEN_BRAN=<token>
+DISCORD_TOKEN_DAVOS=<token>
+DISCORD_TOKEN_ARYA=<token>
+DISCORD_TOKEN_DAENERYS=<token>
+DISCORD_TOKEN_JON=<token>
+
+# Channel IDs (click derecho en canal > Copiar ID)
+DISCORD_CHANNEL_TRONO=<id>         # #el-trono-de-hierro
+DISCORD_CHANNEL_VARYS=<id>         # #el-pajarillo
+DISCORD_CHANNEL_SAMWELL=<id>       # #la-ciudadela
+DISCORD_CHANNEL_BRONN=<id>         # #el-banco-de-hierro
+DISCORD_CHANNEL_BRAN=<id>          # #el-muro
+DISCORD_CHANNEL_DAVOS=<id>         # #desembarco-del-rey
+DISCORD_CHANNEL_ARYA=<id>          # #cara-sin-nombre
+DISCORD_CHANNEL_DAENERYS=<id>      # #poniente-en-llamas
+DISCORD_CHANNEL_JON=<id>           # #la-guardia-de-la-noche
+```