Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/alfonsoolavarria/florilegio/llms.txt

Use this file to discover all available pages before exploring further.

Florilegio de la Fe utiliza python-dotenv (versión 1.0.1) para cargar la configuración sensible desde un archivo .env ubicado en la raíz del proyecto, al mismo nivel que manage.py. El archivo settings.py llama a load_dotenv() automáticamente al arrancar, por lo que basta con definir las variables en ese archivo para que estén disponibles en toda la aplicación.

​
Archivo .env de ejemplo

# Django Core
SECRET_KEY=django-insecure-reemplaza-con-clave-aleatoria-segura
DJANGO_DEBUG=False

# Base de datos PostgreSQL
DB_NAME=florilegiofe
DB_USER=florife_user
DB_PASSWORD=yourpassword
DB_HOST=localhost
DB_PORT=5432

# Brevo — Email transaccional
BREVO_API_KEY=xkeysib-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
BREVO_SENDER_EMAIL=noreply@florilegiodelafe.com
BREVO_SENDER_NAME=Florilegio de la Fe
BREVO_TEMPLATE_ID=1

# PayPal — Suscripciones y donaciones
PAYPAL_CLIENT_ID=AYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PAYPAL_PLAN_PREMIUM=P-xxxxxxxxxxxxxxxxxxxxxxxx
PAYPAL_PLAN_PRO=P-xxxxxxxxxxxxxxxxxxxxxxxx
PAYPAL_PLAN_DONATION_MONTHLY=P-xxxxxxxxxxxxxxxxxxxxxxxx
PAYPAL_PLAN_DONATION_ANNUAL=P-xxxxxxxxxxxxxxxxxxxxxxxx

# API Bíblica
BIBLE_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
YVP_APP_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Django Core

​
SECRET_KEY
string
required
Clave secreta de Django usada para la firma criptográfica de sesiones, tokens CSRF y otros mecanismos de seguridad. Nunca debe compartirse ni usarse la misma clave entre entornos.Genera una clave segura con:
python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"
​
DJANGO_DEBUG
string
default:"False"
Activa o desactiva el modo de depuración de Django. Cuando se evalúa como 'True', Django muestra tracebacks detallados en el navegador y sirve archivos estáticos directamente. Nunca establezca este valor en True en producción.Valores válidos: True | False

​
Base de Datos

Florilegio requiere PostgreSQL. Las siguientes variables mapean directamente a los parámetros del motor django.db.backends.postgresql en settings.py.
​
DB_NAME
string
required
Nombre de la base de datos PostgreSQL. Ejemplo: florilegiofe.
​
DB_USER
string
required
Usuario de PostgreSQL con privilegios sobre la base de datos.
​
DB_PASSWORD
string
required
Contraseña del usuario de PostgreSQL.
​
DB_HOST
string
default:"localhost"
Host del servidor PostgreSQL. En entornos Docker o servicios gestionados, apunta al hostname del contenedor o instancia.
​
DB_PORT
string
default:"5432"
Puerto TCP del servidor PostgreSQL.

​
Email — Brevo

Florilegio de la Fe utiliza Brevo (antes Sendinblue) para el envío de correos transaccionales, incluyendo los códigos de verificación de registro.
Sin BREVO_API_KEY y BREVO_TEMPLATE_ID configurados, el proceso de registro de usuarios fallará: el sistema no podrá enviar el correo de verificación y los usuarios no podrán activar sus cuentas. Estas variables son obligatorias para cualquier entorno que acepte registros públicos.
​
BREVO_API_KEY
string
required
API key de Brevo para el envío de correos transaccionales. Se obtiene en el panel de Brevo bajo SMTP & API → API Keys.
​
BREVO_TEMPLATE_ID
string
required
ID numérico de la plantilla de Brevo utilizada para el correo de verificación de cuenta. Crea la plantilla en el panel de Brevo y usa su ID aquí.
​
BREVO_SENDER_EMAIL
string
default:"noreply@florilegiofe.com"
Dirección de correo del remitente. Debe estar verificada en Brevo.
​
BREVO_SENDER_NAME
string
default:"Florilegio de la Fe"
Nombre visible del remitente en los correos enviados.

​
PayPal — Suscripciones y Donaciones

Las integraciones de PayPal gestionan los planes de suscripción Premium, Pro, y los planes de donación mensual y anual.
Las credenciales de PayPal son opcionales para el desarrollo local. Si no están configuradas, los botones de suscripción no se renderizarán correctamente, pero el resto de la plataforma funcionará con normalidad. Son obligatorias en producción para habilitar los planes de suscripción y donación.
​
PAYPAL_CLIENT_ID
string
Client ID de la aplicación PayPal. Se obtiene en el Portal de Desarrolladores de PayPal. Usado para inicializar el SDK de PayPal en el frontend.
​
PAYPAL_PLAN_PREMIUM
string
ID del Plan de PayPal (P-xxx...) correspondiente a la suscripción Premium.
​
PAYPAL_PLAN_PRO
string
ID del Plan de PayPal correspondiente a la suscripción Pro.
​
PAYPAL_PLAN_DONATION_MONTHLY
string
ID del Plan de PayPal para la opción de donación mensual recurrente.
​
PAYPAL_PLAN_DONATION_ANNUAL
string
ID del Plan de PayPal para la opción de donación anual recurrente.

​
API Bíblica

Estas claves permiten sincronizar y acceder a versiones bíblicas externas usadas en el lector y las herramientas de estudio.
BIBLE_API_KEY y YVP_APP_KEY son opcionales para el desarrollo local si usas los comandos de importación local (import_rv1960, import_biblia). Son obligatorias en producción para habilitar las funciones de sincronización con api.bible y YouVersion Platform.
​
BIBLE_API_KEY
string
API key de api.bible utilizada para sincronizar versiones bíblicas como NBLA, NTV y RVR09. Se registra gratuitamente en el portal de api.bible.
​
YVP_APP_KEY
string
App key de la YouVersion Platform API. Contacta al equipo de YouVersion para solicitar acceso a la plataforma para desarrolladores.

Build docs developers (and LLMs) love

Get started for freeTalk to us