Base de datos workspace · explicación coloquial

Cómo está organizada la BD del workspace (la web interna del equipo), sin enterarse de cada columna. Para el schema completo ve a [[workspace-tech—bd—tecnico]].

En una frase

El workspace usa Cloudflare D1: una base de datos SQLite que vive replicada en el edge global de Cloudflare. Ni PostgreSQL, ni Mongo, ni servidor propio. SQLite plano, ~30 migrations aplicadas, ~25 tablas activas.

Por qué D1 y no PostgreSQL como CreaRack-Pro

El workspace es uso interno de un equipo de 3 (Edu, Dani, Txell). Las cargas son ridículas comparado con un SaaS de cara al cliente. Eso cambia las prioridades:

Si el workspace creciera a 50 usuarios y necesitara queries SQL pesadas, tocaría replantear. Mientras no, D1 va perfecto.

Mapa mental: 6 dominios de tablas

erDiagram
    HomeDashboard {
        string news "anuncios"
        string notes "post-its colores"
        string alerts "banners home"
        string reports "informes generados"
    }
    Tasks {
        string tasks "tablero kanban"
        string task_attachments "adjuntos R2"
        string task_comments "comentarios"
        string task_calendar_events "vínculo Zoho Calendar"
        string task_emails "vínculo Zoho Mail"
    }
    HerramientasPersonales {
        string notebook_notes "bloc personal markdown"
        string directions "agenda contactos"
        string quick_links "hub URLs"
    }
    OAuthYAuth {
        string auth_codes "magic links"
        string zoho_oauth_tokens "tokens Zoho per-user"
        string zoho_oauth_state "anti-CSRF efímero"
    }
    Supercontexto {
        string bib_nodes "grafo del codigo"
        string bib_edges "relaciones"
        string bib_wiki_pages "paginas wiki"
        string bib_chunks "chunks para search"
    }
    Chat {
        string chat_messages "mensajes equipo"
        string chat_typing "estado typing"
    }
    Tools {
        string ai_eval_runs "historial /tools/ai-eval"
        string activity_log "bitacora MCP"
    }

El diagrama es esquemático: muestra los 6 dominios y las tablas principales de cada uno. No es un ER formal (D1 tiene muy pocas FKs reales; las relaciones suelen ser convención).

Los 6 dominios uno por uno

1. Dashboard del home (colaboración del equipo)

Lo que ves al entrar a workspace.crearack.com:

2. Tasks (tablero kanban del equipo)

El centro neurálgico del workspace. Una tabla principal + 4 que la extienden:

3. Herramientas personales (scope user)

A diferencia del dashboard, esto cada miembro lo tiene separado:

Todas tienen owner_id (email CF Access) para separar lo de cada uno + archived_at para soft-delete.

4. OAuth y autenticación

5. Supercontexto (la Biblioteca)

El sistema de grafo de conocimiento que mapea código ↔ documentación. ~13 tablas con prefijo bib_*:

Detalle completo en el wiki [[crearack-tech—general—feature-catalog]] (sección Biblioteca) o en la página técnica [[workspace-tech—bd—tecnico]].

6. Herramientas auxiliares

¿Y los binarios? Imágenes, PDFs, audios

D1 NO guarda blobs. Para eso se usa R2 (object storage de Cloudflare, S3-compatible).

Patrón típico: la fila en D1 guarda metadata + clave R2 (r2_key), y el blob vive en R2.

tasks/{task_id}/{uuid}.png   ← key R2
                ↓ metadata
task_attachments table en D1: r2_key, filename, content_type, size_bytes

Al borrar la task, el ON DELETE CASCADE limpia las filas D1, y el endpoint DELETE de la API se encarga de borrar también los objetos R2.

¿Y el contenido de la wiki?

Doble persistencia:

Cuando creas una página vía wiki_create_page MCP, hace commit GitHub + INSERT en D1 atómicos. Si solo se commiteara el .md sin pasar por el MCP (commits manuales), un job de reconciliación se encarga de actualizar D1 con la diferencia (sesión 18 implementó esto).

Backups del workspace

Tres niveles:

Si el workspace se rompe entero, recuperar: clone repo + wrangler d1 import del último dump.

Para el otro lado: la BD de CreaRack-Pro

CreaRack-Pro y workspace tienen filosofías opuestas porque sirven a clientes opuestos:

Si quieres entender CreaRack-Pro, ve a [[crearack-tech—bd—coloquial]].

Véase también

• [[workspace-tech—bd—tecnico]] — Schema técnico completo con migrations + relaciones
• [[crearack-tech—bd—coloquial]] — Hermana coloquial de CreaRack-Pro
• [[crearack-tech—general—feature-catalog]] — Qué hace la plataforma CreaRack Pro