🧬 Esquema y relaciones de la base de datos

La base de datos de CORDIA sigue un modelo relacional normalizado. Se estructura en torno a las entradas léxicas y todos sus elementos asociados: acepciones, variantes, fuentes, zonas dialectales, hablantes, fenómenos y relaciones lingüísticas.

📁 Organización general

entry ← entry_senses ← sense_locations
     ↓             ↘︎
entry_variants   sense_phenomena
     ↓                 ↓
pais/zona       phenomena_types

📌 Tablas principales

`entries`

Entrada léxica base (lema, tipo, POS...)

`entry_senses`

Acepciones o significados de la entrada
Relacionadas con fenómenos y localizaciones

`entry_variants`

Variantes dialectales o gráficas

`sense_locations`

Relación entre acepciones y zonas geográficas

`sense_phenomena`

Relación entre acepciones y fenómenos lingüísticos

`sources`

Referencias documentales o testimoniales

`locations`

Zonas dialectales (ligadas a hablantes, fenómenos...)

`phenomenons`

Fenómenos lingüísticos (con tipo, categoría, descripción...)

`speakers`

Informantes vinculados a zonas

🔐 Relación con autenticación

Además de las tablas lingüísticas, hay otras para gestionar acceso y trazabilidad:

users: usuarios con rol
roles, permissions: control de acceso
cordia_logs: registro de eventos, logins, ediciones y API calls

📊 Visualización del esquema

Puedes ver el esquema completo y sus relaciones de forma gráfica usando SchemaSpy:

👉 http://schema.cordia.local

El esquema se genera automáticamente a partir del estado actual de las migraciones.

Consulta también backend-interno.md para ver cómo se gestionan estos datos desde Filament.