Directus

Directus es un headless CMS moderno que convierte cualquier base de datos SQL en una API REST y GraphQL instantánea, con un panel de administración elegante.

Primeros Pasos

1. Acceder a Directus

Después de que tu deployment esté listo:

1. Visita tu URL: https://tu-subdominio.deployalo.com
2. Verás la pantalla de inicio de sesión

2. Credenciales de Administrador

• Email: Ve a Tab Técnico → Variables de Entorno → ADMIN_EMAIL
• Contraseña: Ve a Tab Técnico → Variables de Entorno → ADMIN_PASSWORD

3. Primer Login

1. Inicia sesión con las credenciales anteriores
2. Accederás al panel de administración de Directus

Alternativa Open Source a

• Contentful
• Strapi
• Sanity
• Prismic
• DatoCMS
• Storyblok

¿Por qué elegir Directus sobre alternativas SaaS?

Característica	Directus	Alternativas SaaS
Costo	Precio fijo mensual	Por usuario/uso
Datos	En tu servidor	En servidores externos
Límites	Sin límites	Límites por plan
Personalización	100% personalizable	Limitada
Código	Open source	Propietario

Configuración Inicial

Crear tu Primera Colección

Las colecciones en Directus son como tablas en una base de datos:

1. Ve a Settings → Data Model
2. Click "Create Collection"
3. Ingresa nombre (ej: articles, products)
4. Añade campos:
   • title (String)
   • content (WYSIWYG)
   • published_date (DateTime)
   • image (Image)
5. Click "Save"

Añadir Contenido

1. Ve a Content → [Tu Colección]
2. Click "+" para crear un nuevo item
3. Completa los campos
4. Click "Save"

API REST

Tu contenido está disponible automáticamente via API:

# Listar items
GET https://tu-subdominio.deployalo.com/items/articles

# Obtener un item
GET https://tu-subdominio.deployalo.com/items/articles/1

# Crear item (autenticado)
POST https://tu-subdominio.deployalo.com/items/articles
{
  "title": "Mi Artículo",
  "content": "Contenido aquí..."
}

Autenticación

# Obtener token
POST https://tu-subdominio.deployalo.com/auth/login
{
  "email": "[email protected]",
  "password": "tu-password"
}

# Usar token
GET https://tu-subdominio.deployalo.com/items/articles
Authorization: Bearer <token>

API GraphQL

También disponible en /graphql:

query {
  articles {
    id
    title
    content
    published_date
  }
}

Permisos y Roles

1. Ve a Settings → Roles & Permissions
2. Crea roles personalizados:
   • Editor - puede crear/editar contenido
   • Author - solo su propio contenido
   • Public - permisos de lectura pública
3. Configura permisos por colección

Webhooks

Automatiza acciones cuando el contenido cambia:

1. Ve a Settings → Webhooks
2. Click "Create Webhook"
3. Configura:
   • URL de destino
   • Eventos (create, update, delete)
   • Colecciones a monitorear

Flows (Automatización)

Directus incluye un sistema de automatización visual:

1. Ve a Settings → Flows
2. Crea un flow:
   • Trigger: Cuando se crea un artículo
   • Action: Enviar email de notificación

Casos de Uso

• Blog/CMS - Gestiona artículos, categorías, autores
• E-commerce - Productos, categorías, inventario
• App Backend - API para tu app móvil/web
• Dashboard - Panel de administración para cualquier dato

Recursos

• Documentación de Directus
• SDK JavaScript
• Directus TV - Tutoriales en video