Nomenclatura de aplicaciones

🎯 Objetivo: Definir nombres consistentes para las aplicaciones.

Formato obligatorio

[cliente]-[app]-[ambiente]

Reglas

• Todo en minúsculas.
• Solo letras, números y guión medio (-).
• Sin espacios, tildes, ñ, guión bajo (_) ni caracteres especiales.
• cliente y app deben ser cortos y claros.
• ambiente debe ser uno de: prod, staging, dev, test.
• No repetir palabras entre cliente y app.

Ejemplos válidos

• trantor-form990-prod
• agrosuper-intranet-staging
• tallerdigital-crm-prod
• luksic-portal-dev

Ejemplos inválidos

• Trantor-Form990-Prod (mayúsculas)
• trantor_form990_prod (guión bajo)
• trantor-form 990-prod (espacio)
• trantor-form990-production (ambiente no estándar)
• trantor--form990-prod (doble guión)

Preparar backend Strapi en Dokku

Objetivo: crear app backend con PostgreSQL, dominio y SSL en un servidor Dokku existente.

Crear app y base de datos

dokku apps:create <app_name>
dokku postgres:create <app_name>-postgres
dokku postgres:link <app_name>-postgres <app_name>

Configurar dominio y SSL

dokku domains:add <app_name> <api_domain>
dokku letsencrypt:set <app_name> email <email>
dokku letsencrypt:enable <app_name>

Verificación

dokku config:get <app_name> DATABASE_URL
dokku domains:report <app_name>

Crear proyecto Strapi para producción

Objetivo: inicializar Strapi local con configuración compatible con Dokku y PostgreSQL.

Crear proyecto y dependencias

npx create-strapi-app@latest <app_name> --quickstart=false
cd <app_name>
npm install pg

Configuración mínima requerida

• config/database.js leyendo DATABASE_URL
• config/server.js con HOST=0.0.0.0, PORT por entorno y url pública
• Procfile con web: npm run start

Verificación

Confirmar que la app inicia localmente y que existe Procfile en la raíz.

Deploy inicial de Strapi a Dokku

Objetivo: publicar el backend Strapi y dejar admin accesible.

Configurar remote por ambiente

git remote add <ambiente> dokku@<host>:<app_name>
git remote -v

Variables de entorno mínimas

dokku config:set <app_name> NODE_ENV=production
dokku config:set <app_name> APP_KEYS='<k1>,<k2>,<k3>,<k4>'
dokku config:set <app_name> API_TOKEN_SALT='<token_salt>'
dokku config:set <app_name> ADMIN_JWT_SECRET='<admin_jwt>'
dokku config:set <app_name> JWT_SECRET='<jwt_secret>'
dokku config:set <app_name> PUBLIC_URL='https://<api_domain>'

Deploy

git add .
git commit -m "Initial Strapi setup"
git push <ambiente> main:master

Verificación

• Abrir https://<api_domain>/admin
• Crear usuario administrador inicial.

Crear content types y permisos de API

Objetivo: definir modelos de contenido y exponer endpoints públicos controlados.

Crear content type base

En Strapi Admin (Content-Type Builder) crear colección (ejemplo: Article) con campos requeridos.

Habilitar permisos públicos

En Settings -> Roles -> Public, habilitar solo acciones necesarias (find, findOne) para cada colección.

Verificación

curl https://<api_domain>/api/articles

Esperado: respuesta JSON sin error 403.

Configurar uploads en Cloudflare R2

Objetivo: evitar pérdida de archivos en redeploys moviendo media a storage object externo.

Configurar bucket y credenciales

Crear bucket R2 y generar credenciales API (access key, secret, endpoint).

Configurar provider en Strapi

Instalar provider S3-compatible y configurar config/plugins.js para usar R2.

Variables en Dokku

dokku config:set <app_name> R2_ACCESS_KEY_ID='<key>'
dokku config:set <app_name> R2_SECRET_ACCESS_KEY='<secret>'
dokku config:set <app_name> R2_ENDPOINT='https://<endpoint>.r2.cloudflarestorage.com'
dokku config:set <app_name> R2_BUCKET='<bucket>'

Verificación

Subir imagen desde Strapi Admin y confirmar URL pública funcional.

Validación final Strapi + Cloudflare

Objetivo: comprobar salud de backend, frontend, media y automatizaciones.

Backend

curl -I https://<api_domain>
curl -I https://<api_domain>/admin

Frontend

curl -I https://<frontend_domain>

Flujo funcional

1. Crear/publicar contenido en Strapi.
2. Verificar rebuild automático en Cloudflare Pages.
3. Confirmar contenido actualizado en frontend.
4. Subir imagen y validar entrega desde R2.