Signed-off-by: ale <ale@manalejandro.com>
Este commit está contenido en:
ale
2026-02-08 23:35:53 +01:00
padre 54807b9982
commit 4b66a91750
Se han modificado 19 ficheros con 2152 adiciones y 43 borrados

142
content/db/README.md Archivo normal
Ver fichero

@@ -0,0 +1,142 @@
# Base de Datos de Classic Add-ons Archive
⚠️ **ARCHIVO FALTANTE: `ca-archive-19030501.sqlite`**
Este directorio debe contener el archivo de base de datos SQLite con el catálogo completo de add-ons clásicos de Firefox.
---
## 📊 Archivo Requerido
**Nombre:** `ca-archive-19030501.sqlite`
**Tamaño:** ~50 MB
**Contenido:** 93,598 versiones de 19,450 Firefox add-ons clásicos
---
## ⚠️ Por qué falta
Este archivo es muy grande para incluirse en Git. Debes obtenerlo de una de estas fuentes:
### Opción 1: Releases de GitHub (si están disponibles)
```bash
# Buscar en releases del repositorio original
# https://github.com/JustOff/ca-archive/releases
# Si hay un release con la DB:
cd content/db/
wget https://github.com/JustOff/ca-archive/releases/download/vX.X.X/ca-archive-19030501.sqlite
```
### Opción 2: Versión Legacy (v2.x)
Si tienes instalada la versión antigua (v2.x) de la extensión en Firefox ≤56:
1. Buscar el archivo en el perfil de Firefox:
```bash
# En Linux:
find ~/.mozilla/firefox/*.default* -name "ca-archive*.sqlite" 2>/dev/null
# En Windows:
# %APPDATA%\Mozilla\Firefox\Profiles\*.default*\
```
2. Copiar aquí:
```bash
cp /ruta/encontrada/ca-archive-19030501.sqlite content/db/
```
### Opción 3: Construir desde fuentes públicas
Según el README original, los datos provienen de:
- **AMO** (addons.mozilla.org)
- **Wayback Machine** (web.archive.org)
- Otros directorios públicos
Necesitarías scripts para extraer y compilar estos datos en una base SQLite.
---
## 🔍 Verificar integridad
Una vez obtenido el archivo, verifica:
```bash
# Tamaño (debe ser ~50 MB)
ls -lh ca-archive-19030501.sqlite
# Integridad SQLite
sqlite3 ca-archive-19030501.sqlite "PRAGMA integrity_check;"
# Debe retornar: ok
# Ver cantidad de add-ons
sqlite3 ca-archive-19030501.sqlite "SELECT COUNT(*) FROM addons;"
# Debe retornar: ~19450
# Ver cantidad de versiones
sqlite3 ca-archive-19030501.sqlite "SELECT COUNT(*) FROM versions;"
# Debe retornar: ~93598
```
---
## 📁 Estructura de la Base de Datos
La base de datos SQLite debe contener al menos estas tablas:
- `addons` - Información de cada add-on (nombre, autor, descripción)
- `versions` - Versiones de cada add-on (número versión, fecha, compatibilidad)
- `categories` - Categorías de add-ons
- `developers` - Información de desarrolladores
---
## 🚀 Después de obtener la DB
1. **Colocar el archivo aquí:**
```
content/db/ca-archive-19030501.sqlite
```
2. **Verificar permisos:**
```bash
chmod 644 content/db/ca-archive-19030501.sqlite
```
3. **Recargar extensión en Firefox:**
```
about:debugging#/runtime/this-firefox
→ Click en "Recargar" (ícono ↻)
```
4. **Verificar carga:**
- La extensión mostrará: "Loading database for the first time. Please wait..."
- Primera carga puede tardar 30-60 segundos (carga y guarda en storage)
- Siguientes cargas serán instantáneas (se lee del storage)
---
## 🆘 Contacto
Si no puedes obtener el archivo de base de datos:
- **GitHub Issues:** https://github.com/JustOff/ca-archive/issues
- **Autor original:** JustOff
- **Descripción:** Solicitar enlace de descarga para `ca-archive-19030501.sqlite`
---
## 📝 Nota para Desarrolladores
Si vas a generar tu propia base de datos desde cero, el esquema SQL esperado debe ser compatible con las consultas en:
- `content/list.js` - Listados de add-ons
- `content/addon.js` - Detalles de add-on individual
- `content/versions.js` - Versiones disponibles
- `content/tcloud.js` - Tag cloud de categorías
---
**Estado actual:** ❌ Archivo faltante (la extensión NO funcionará sin este archivo)
**Acción requerida:** Obtener `ca-archive-19030501.sqlite` de releases o versión legacy

Archivo binario no mostrado.