inicio: dashboard de privacidad Bitcoin con análisis on-chain

SETUP.md

@@ -0,0 +1,158 @@
+# Cómo subir Txoko a Gitea — paso a paso
+
+Instrucciones exactas. Copiar y pegar en la terminal del Mac.
+No hace falta entender git para seguir esto.
+
+---
+
+## PASO 1 — Crear el repo en Gitea (una sola vez)
+
+1. Abre tu instancia de Gitea en el navegador
+2. Clic en el **+** (arriba a la derecha) → "New Repository"
+3. Rellena:
+   - **Repository Name:** `txoko-dashboard`
+   - **Description:** `Suite de auditoría de privacidad Bitcoin para nodos propios`
+   - **Visibility:** Private (o Public si quieres compartirlo con la comunidad)
+   - **Initialize repository:** NO marcar (ya traemos nuestros archivos)
+4. Clic en "Create Repository"
+5. Gitea te muestra una página con instrucciones — copia la URL del repo,
+   será algo como: `https://gitea.tu-comunidad/tu-usuario/txoko-dashboard.git`
+
+---
+
+## PASO 2 — Configurar git en el Mac (una sola vez, si no lo tienes)
+
+```bash
+git config --global user.name "tu nombre"
+git config --global user.email "tu@email.com"
+```
+
+Comprueba que git está instalado:
+```bash
+git --version
+```
+Si no está: `brew install git`
+
+---
+
+## PASO 3 — Crear el repo local y primer commit (una sola vez)
+
+```bash
+# Crear carpeta del proyecto en el Mac
+mkdir ~/txoko-dashboard
+cd ~/txoko-dashboard
+
+# Copiar los archivos del repo que te he preparado
+# (descarga los archivos de esta conversación y cópialos aquí)
+
+# Inicializar git
+git init
+git branch -M main
+
+# Añadir todos los archivos
+git add .
+
+# Primer commit — el historial empieza aquí
+git commit -m "inicio: dashboard de privacidad Bitcoin con análisis on-chain"
+```
+
+---
+
+## PASO 4 — Conectar con Gitea y subir (una sola vez)
+
+```bash
+# Sustituye la URL por la de tu repo de Gitea
+git remote add origin https://gitea.tu-comunidad/tu-usuario/txoko-dashboard.git
+
+# Subir
+git push -u origin main
+```
+
+Gitea te pedirá usuario y contraseña la primera vez.
+Si quieres evitar introducirlos cada vez, crea un token en
+Gitea → Settings → Applications → "Generate Token" y úsalo como contraseña.
+
+---
+
+## PASO 5 — Flujo de trabajo normal (cada vez que yo te dé un archivo nuevo)
+
+```bash
+cd ~/txoko-dashboard
+
+# Copiar el archivo actualizado descargado de esta conversación
+cp ~/Downloads/txoko-dashboard.html ./dashboard.html
+
+# Ver qué cambió (opcional pero útil)
+git diff dashboard.html
+
+# Registrar el cambio con un mensaje descriptivo
+git add dashboard.html
+git commit -m "fix: descripción breve de lo que se arregló"
+
+# Subir a Gitea
+git push
+
+# Copiar al nodo (igual que antes)
+scp dashboard.html armg@100.116.19.86:/home/armg/txoko/dashboard.html
+```
+
+---
+
+## Mensajes de commit — ejemplos
+
+El mensaje va después de `-m` y describe QUÉ cambiaste.
+No tiene que ser perfecto, solo útil para ti en el futuro.
+
+```
+"fix: timeout en consultas al nodo"
+"feat: score por bandas ALTA/MEDIA/BAJA"
+"fix: responsive pestaña Mempool en móvil"
+"fix: detección Whirlpool con tolerancia 2%"
+"feat: fingerprinting wallet completo"
+"fix: umbral dust por tipo de salida"
+"docs: actualizar README con nuevas funcionalidades"
+```
+
+Convención (opcional pero ordenada):
+- `fix:` — corrige algo que no funcionaba bien
+- `feat:` — añade algo nuevo
+- `docs:` — solo documentación
+
+---
+
+## Si algo sale mal
+
+**Subiste algo que no querías:**
+```bash
+git revert HEAD
+git push
+```
+
+**Quieres volver a una versión anterior:**
+```bash
+git log --oneline          # ver el historial
+git checkout HASH_DEL_COMMIT -- dashboard.html   # recuperar ese archivo
+```
+
+**Ver el historial:**
+```bash
+git log --oneline
+```
+
+---
+
+## Resumen del flujo
+
+```
+Claude te da dashboard.html
+       ↓
+cp ~/Downloads/dashboard.html ./dashboard.html
+       ↓
+git add . && git commit -m "descripción"
+       ↓
+git push
+       ↓
+scp dashboard.html armg@100.116.19.86:/home/armg/txoko/
+```
+
+Cuatro comandos después de la descarga. Siempre los mismos.