v3

Signed-off-by: ale <ale@manalejandro.com>

INSTALL.md

@@ -0,0 +1,171 @@
+# Guía de Instalación Rápida - Classic Add-ons Archive v3.0
+
+## Para Desarrolladores / Testing Local
+
+### Firefox
+
+**Opción 1: Carga temporal (recomendado para desarrollo)**
+
+1. Abre Firefox
+2. Escribe en la barra de direcciones: `about:debugging#/runtime/this-firefox`
+3. Click en "Cargar complemento temporal..."
+4. Navega a la carpeta del proyecto y selecciona el archivo `manifest.json`
+
+La extensión se instalará hasta que cierres Firefox.
+
+**Opción 2: Instalación permanente (requiere firmado)**
+
+1. Empaquetar la extensión:
+   ```bash
+   cd /home/ale/projects/firefox/ca-archive
+   zip -r ca-archive-3.0.xpi manifest.json background.js content/ skin/ -x "*.git*" -x "*~"
+   ```
+
+2. Firmar en addons.mozilla.org o usar Firefox Developer/Nightly con firma deshabilitada
+
+### Chrome / Edge / Brave
+
+**Modo desarrollador (sin empaquetar):**
+
+1. Abre el navegador
+2. Ve a: `chrome://extensions/` (o `edge://extensions/`)
+3. Activa el interruptor "Modo de desarrollador" (esquina superior derecha)
+4. Click en "Cargar extensión sin empaquetar"
+5. Selecciona la carpeta: `/home/ale/projects/firefox/ca-archive`
+
+La extensión quedará instalada permanentemente en modo desarrollo.
+
+**Empaquetar para distribución:**
+
+```bash
+cd /home/ale/projects/firefox/ca-archive
+zip -r ca-archive-3.0.zip manifest.json background.js content/ skin/ -x "*.git*" -x "*~"
+```
+
+## Verificación de Instalación
+
+Después de instalar, deberías ver:
+
+1. ✅ Icono de la extensión en la barra de herramientas
+2. ✅ Click en el icono abre la página del catálogo
+3. ✅ Mensaje de carga de base de datos (primera vez)
+4. ✅ Navegación funcionando (categorías, búsqueda, etc.)
+
+## Troubleshooting
+
+### La base de datos no carga
+
+**Error:** "Loading database for the first time. Please wait..."
+
+**Solución:**
+1. Asegúrate de tener la carpeta `content/db/` con el archivo SQLite
+2. Verifica que el archivo `ca-archive-19030501.sqlite` exista y no esté corrupto
+3. Revisa la consola del navegador (`F12` > Console) para errores específicos
+
+### El icono no aparece
+
+**Solución:**
+1. Refresca la página `about:debugging` o `chrome://extensions/`
+2. Verifica que `manifest.json` tiene el campo `browser_action` correctamente
+3. Revisa que las imágenes en `skin/button.png` existan
+
+### Errores de carga de scripts
+
+**Error:** "Failed to load script: ..."
+
+**Solución:**
+1. Verifica que todos los archivos JS estén en `content/`
+2. Revisa la política CSP en `manifest.json`
+3. Asegúrate de que `db-webext.js` se carga antes de `ca-archive.js`
+
+### sql.js no carga
+
+**Error:** "Could not load SQL engine"
+
+**Solución:**
+1. Verifica conexión a internet (se descarga desde CDN)
+2. O descarga sql.js localmente:
+   ```bash
+   cd content/
+   wget https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.js
+   wget https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.wasm
+   ```
+3. Actualiza las rutas en `content/db-webext.js`
+
+## Para Usuarios Finales
+
+### Instalar desde archivo .xpi/.zip
+
+**Firefox:**
+1. Descarga el archivo `.xpi`
+2. Arrastra y suelta en Firefox
+3. Autoriza la instalación
+
+**Chrome:**
+1. Descarga el archivo `.zip`
+2. Descomprime en una carpeta
+3. Sigue los pasos de "Modo desarrollador" arriba
+
+### Instalar desde stores (cuando esté publicado)
+
+**Firefox Add-ons (AMO):**
+- Visita: https://addons.mozilla.org/firefox/addon/ca-archive/
+- Click en "Añadir a Firefox"
+
+**Chrome Web Store:**
+- Visita: [URL de Chrome Web Store]
+- Click en "Añadir a Chrome"
+
+## Desinstalación
+
+### Firefox
+1. `about:addons` > Extensiones
+2. Busca "Classic Add-ons Archive"
+3. Click en "..." > Eliminar
+
+### Chrome
+1. `chrome://extensions/`
+2. Busca la extensión
+3. Click en "Eliminar"
+
+## Archivos Necesarios
+
+Archivos mínimos para que funcione la extensión:
+
+```
+ca-archive/
+├── manifest.json          ← REQUERIDO
+├── background.js          ← REQUERIDO
+├── content/
+│   ├── ca-archive.html    ← REQUERIDO
+│   ├── ca-archive.js      ← REQUERIDO
+│   ├── db-webext.js       ← REQUERIDO
+│   ├── db/
+│   │   └── ca-archive-19030501.sqlite  ← REQUERIDO
+│   ├── addon.js
+│   ├── list.js
+│   ├── versions.js
+│   ├── tcloud.js
+│   ├── about.js
+│   └── epl.js
+└── skin/
+    ├── logo.png           ← REQUERIDO
+    ├── button.png         ← REQUERIDO
+    ├── ca-archive.css     ← REQUERIDO
+    └── ...
+```
+
+## Siguientes Pasos
+
+Una vez instalada y funcionando:
+
+1. 📖 Lee [MIGRATION.md](MIGRATION.md) para entender los cambios
+2. 🔧 Si eres desarrollador, revisa la arquitectura modernizada
+3. 🐛 Reporta bugs en GitHub Issues
+4. 🌟 Si te gusta, deja una valoración
+
+## Soporte
+
+- 📝 Documentación completa: [MIGRATION.md](MIGRATION.md)
+- 🐛 Reportar problemas: https://github.com/JustOff/ca-archive/issues
+- 💬 Discusiones: https://github.com/JustOff/ca-archive/discussions