✧ BaaG · Help Guide ✧

💡 ¿Cuál es la idea?

Casi todos los proyectos pequeños (un blog, un bot, una app de universidad) generan bases de datos que de verdad necesitan respaldos periódicos, pero pagar un servicio o mantener un servidor S3 solo para unos dump.sql semanales es excesivo.

BaaG te da 2 GB por usuario con una API key que puedes guardar en tu crontab y olvidarte. El sistema se encarga de:

• Recibir el archivo vía POST (multipart).
• Guardarlo en tu bóveda personal con fecha de expiración.
• Borrarlo automáticamente a los 28 días.
• Liberar espacio si te pasas de la cuota, eliminando lo más viejo primero.

No es un Dropbox ni un Google Drive: es un buzón temporal para backups críticos.

⚙️ Características

🚀 Cómo empezar (3 pasos)

1. Crea una cuenta gratuita desde /baag/register.

2. Inicia sesión y genera una API Key en el botón ✦ Generar Nueva Key.

3. Usa esa key para subir tu primer backup:

curl -X POST /baag/api/upload \
  -H "X-API-Key: baag_TU_API_KEY_AQUI" \
  -F "file=@/ruta/a/tu_backup.sql"

curl -X POST ... -H "X-API-Key: $BAAG_KEY" -F "[email protected]"

🔌 Referencia de la API

POST /baag/api/upload

Sube un nuevo backup. Rate limit: 1 request cada 15 minutos (para evitar abuso).

Headers:

• X-API-Key: <tu_key> o
• Authorization: Bearer <tu_key>

Body (multipart/form-data):

• file: el archivo a subir.

Extensiones permitidas: .sql, .dump, .backup, .gz, .tar.gz

Respuesta 200 OK:

{
  "success": true,
  "backup_id": 42,
  "filename": "mi_db.sql",
  "size": 1048576,
  "expires_at": "2026-06-29T12:34:56"
}

Errores comunes:

GET /baag/api/list

Lista todos tus backups, con tamaño total y porcentaje de cuota usado.

curl /baag/api/list \
  -H "X-API-Key: baag_TU_API_KEY_AQUI"

Respuesta 200 OK:

{
  "success": true,
  "total_backups": 5,
  "total_size_bytes": 524288000,
  "quota_max_bytes": 2147483648,
  "quota_used_percent": 24.41,
  "backups": [
    {
      "id": 42,
      "filename": "mi_db.sql",
      "size_bytes": 1048576,
      "uploaded_at": "2026-06-01T10:00:00",
      "expires_at": "2026-06-29T10:00:00"
    }
  ]
}

🧹 Cuota inteligente (2 GB)

Cada usuario tiene 2 GB de cuota dura. Cuando intentas subir un archivo que no entra, BaaG no falla de inmediato: hace limpieza automática.

Algoritmo de limpieza:

1. Calcula cuánto falta: file_size + 500 KB (buffer de seguridad).
2. Busca todos tus backups ordenados del más viejo al más nuevo (uploaded_at ASC).
3. Borra archivo físico + registro de BD uno por uno hasta liberar lo necesario.
4. Si después de borrar todo sigue sin caber, devuelve error 400 y descarta el archivo nuevo.

⏳ Caducidad a 28 días

Cada archivo subido se guarda con expires_at = uploaded_at + 28 días. El sistema elimina automáticamente (físico + base de datos) cualquier archivo vencido:

• Cuando entras al dashboard, se ejecuta la limpieza en segundo plano.
• Cuando subes un archivo, también se aprovecha para purgar vencidos.

¿Por qué 28 días? Es el sweet-spot típico entre un ciclo de backup mensual y un periodo razonable de retención para recuperación ante desastres.

🛡️ Seguridad

• Contraseñas: se guardan con werkzeug.security.generate_password_hash (hash + salt, nunca en texto plano).
• API Keys: son tokens aleatorios de 32 caracteres con prefijo baag_. Puedes revocarlas en cualquier momento.
• Sesiones: Flask sessions firmadas con SECRET_KEY. Si marcas Recordarme, se emite un token persistente guardado como cookie HttpOnly con expiración de 30 días.
• Archivos: se almacenan fuera del webroot en una ruta absoluta (/home/sdd/sedda-utils/archivos_subidos/baag/<usuario>/).
• Rate limit: el endpoint de upload está limitado a 1 request / 15 min para evitar abuso.

🔒 Privacidad

Sección corta y honesta, sin letra chiquita:

• No cifro los archivos en reposo. Lo que subes se guarda tal cual en el disco del servidor. Si te importa, cífralo antes de mandarlo (gpg -c, openssl enc, age, lo que sea).
• Nadie revisa lo que subes. No hay un operador humano leyendo tus .sql. Literalmente tengo mejores cosas que hacer, no tengo tiempo, ni quiero hacerlo. El sistema es automático de punta a punta.
• No me importa qué subes (mientras no sea ilegal, eso sí: borrado va). No es un servicio para subir memes, pero tampoco es mi trabajo andar curioseando dumps ajenos.
• Lo único que sé de ti: el nombre de usuario que elegiste, el hash de tu contraseña, las API keys que generaste y los metadatos de tus backups (nombre, tamaño, fecha). Nada más.
• No vendo datos, no hay analytics, no hay tracking de terceros. No tengo un modelo de negocio detrás.

❓ Preguntas frecuentes

¿Puedo tener más de 2 GB?
No. La cuota es fija y compartida entre todos tus backups.

¿Qué pasa si revoco una API key?
Deja de funcionar de inmediato. Los archivos ya subidos con esa key siguen ahí (son tuyos); solo no podrás subir más hasta generar una nueva.

¿Puedo restaurar un backup expirado?
No. Una vez borrado por el sistema (a los 28 días), no hay backup del backup. Por eso la fuente de verdad debe ser tu servidor, no BaaG.

¿Por qué el upload falla con 429?
Hay un rate limit de 1 subida cada 15 minutos. Espera el tiempo indicado y reintenta.

¿Cómo elimino un archivo manualmente?
Desde el dashboard, en la columna Admin de la tabla de backups, pulsa Borrar.

¿BaaG cifra mis archivos en reposo?
No. Se guardan tal cual en disco. Si el archivo de origen es sensible, cífralo antes de subirlo (gpg -c, openssl enc, etc.).

¿Alguien lee o revisa mis archivos?
No. El sistema es 100% automático, no hay un operador humano mirando lo que subes. Literalmente no me da la vida. Mira la sección 🔒 Privacidad para más detalle honesto.

¿Puedo confiar mis secretos comerciales, datos médicos o lo que sea?
No. BaaG no es un servicio con SLA, sin compliance, sin cifrado en reposo y sin soporte formal. Para ese tipo de cosas, paga un servicio serio (Backblaze B2, AWS S3 con cifrado, etc.).