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.

Esta guía te lleva desde cero hasta tener el servidor de desarrollo de Florilegio de la Fe corriendo en tu máquina local, con la base de datos migrada, un superusuario creado y la interfaz de administración disponible en http://localhost:8000/admin/. Al finalizar, podrás explorar el panel, crear contenido de prueba y, opcionalmente, importar los datos bíblicos completos (texto, morfología hebrea, concordancia de Strong).
Requisitos previosAntes de comenzar, asegúrate de tener instalado en tu sistema:
  • Python 3.10 o superior — la plataforma usa f-strings y características modernas del lenguaje.
  • PostgreSQL 14 o superior — motor de base de datos requerido; sqlite3 no es compatible con las funciones de búsqueda de django.contrib.postgres.
  • Git — para clonar el repositorio.
1

Clonar el repositorio

Clona el repositorio oficial y accede al directorio del proyecto:
git clone https://github.com/alfonsoolavarria/florilegio.git
cd florilegio
La raíz del repositorio contiene manage.py, requirements.txt, y los directorios florilegiofe/ y main_florife/.
2

Crear entorno virtual e instalar dependencias

Crea un entorno virtual de Python para aislar las dependencias del proyecto y luego instálalas:
python -m venv .venv
source .venv/bin/activate        # En Windows: .venv\Scripts\activate
pip install -r requirements.txt
El archivo requirements.txt instala exactamente estas versiones:
PaqueteVersiónRol
Django4.2.11Framework principal
psycopg2-binary2.9.11Adaptador PostgreSQL
whitenoise6.6.0Servicio de archivos estáticos
python-dotenv1.0.1Carga de variables de entorno
django-allauth0.54.0Autenticación y OAuth social
django-ratelimit4.1.0Limitación de tasa en vistas
bleach6.3.0Saneamiento de HTML
Pillow12.2.0Procesamiento de imágenes
3

Configurar variables de entorno

Florilegio carga su configuración desde un archivo .env ubicado en la raíz del proyecto. Crea ese archivo y define al menos las variables mínimas requeridas:
touch .env
Contenido mínimo del archivo .env:
# Seguridad
SECRET_KEY=cambia-esto-por-una-clave-secreta-larga-y-aleatoria

# Modo de desarrollo
DJANGO_DEBUG=True

# Base de datos PostgreSQL
DB_NAME=florilegio_db
DB_USER=tu_usuario_postgres
DB_PASSWORD=tu_contraseña_postgres
DB_HOST=localhost
DB_PORT=5432
Crea la base de datos en PostgreSQL antes de continuar:
psql -U postgres -c "CREATE DATABASE florilegio_db;"
Para una referencia completa de todas las variables de entorno disponibles —incluyendo claves de Brevo (correo transaccional), PayPal (suscripciones), YouVersion y Google OAuth— consulta la guía de Variables de entorno.
4

Aplicar migraciones

Con la base de datos creada y las variables de entorno configuradas, ejecuta las migraciones para crear todas las tablas del esquema:
python manage.py migrate
Django creará las tablas de todos los modelos definidos en main_florife/models.py: Article, Essay, PalabraBiblia, PalabraHebreo, LibroBiblia, VersiculoBiblia, StrongConcord, VineConcord, UserProfile, UserStudy, MadreMaestraResource y el resto de modelos auxiliares.
5

Crear superusuario

Crea una cuenta de administrador para acceder al panel de Django (/admin/) y gestionar el contenido:
python manage.py createsuperuser
El comando pedirá un correo electrónico y una contraseña. La autenticación en el panel de administración utiliza correo electrónico como identificador, tal como está configurado en settings.py (ACCOUNT_AUTHENTICATION_METHOD = 'email').
6

Levantar el servidor de desarrollo

Inicia el servidor de desarrollo de Django:
python manage.py runserver
Abre tu navegador y accede a:
URLDescripción
http://localhost:8000/Página principal de Florilegio
http://localhost:8000/admin/Panel de administración Django
http://localhost:8000/articulos/Listado de artículos
http://localhost:8000/estudios/Herramienta de estudio bíblico
http://localhost:8000/madres/Sección Madres Maestras

​
Importar datos bíblicos

El directorio main_florife/management/commands/ contiene comandos de administración para poblar la base de datos con el corpus bíblico completo. Estos comandos son opcionales para el desarrollo general, pero son necesarios para utilizar la herramienta de estudio bíblico interlineal. Ejecuta los comandos en este orden recomendado: 
# 1. Importa versículos de la Reina Valera 1960 (crea registros VersiculoBiblia)
#    Este paso es necesario antes de ejecutar generar_libros
python manage.py import_rv1960

# 2. Genera los registros de libros de la Biblia (Génesis → Apocalipsis)
#    Lee los versículos ya importados para construir la estructura de capítulos
python manage.py generar_libros

# 3. Importa el interlineal del Nuevo Testamento griego (OGNT + morfología RMAC)
python manage.py import_biblia

# 4. Importa la morfología hebrea desde los datos OSHB/morphHB
#    (requiere que los archivos de biblia/morphhb/ estén presentes)
python manage.py import_morphhb

# 5. Importa la concordancia de Strong
python manage.py import_strong_concord
El comando generar_libros lee desde la tabla VersiculoBiblia para construir la estructura de capítulos de cada libro. Debes ejecutar import_rv1960 (u otro comando de importación de versículos) antes de ejecutar generar_libros; de lo contrario, ningún libro será creado.
ComandoModelos que pueblaDescripción
import_rv1960VersiculoBibliaImporta todos los versículos de la Reina Valera 1960 desde archivos JSON locales en data/biblia_rv1960/. Requerido antes de generar_libros.
generar_librosLibroBibliaCrea los 66 registros de libros canónicos con su número, nombre, testamento y estructura de capítulos. Requiere que VersiculoBiblia ya esté poblada.
import_bibliaPalabraBiblia, TraduccionLiteral, MorfologiaImporta el texto del Nuevo Testamento griego (OGNT) con su morfología RMAC y traducciones literales desde archivos CSV en biblia/.
import_morphhbPalabraHebreo, TraduccionHebreo, MorfologiaHebreoImporta las palabras del Antiguo Testamento hebreo desde los archivos biblia/morphhb/ con códigos morphHB y números de Strong.
import_strong_concordStrongConcordImporta las entradas de la concordancia de Strong para la búsqueda por número de Strong en la herramienta interlineal.
Para la referencia completa de todas las variables de entorno disponibles, incluyendo las claves de integraciones externas (Brevo, PayPal, YouVersion, Google OAuth), consulta la guía de Variables de entorno.

Arquitectura

Diagrama de componentes, rutas URL, middlewares y decisiones de infraestructura de Florilegio.

Referencia de API

Endpoints disponibles: versículos, estudios de usuario, Strong, contexto de libros y sincronización bíblica.

Build docs developers (and LLMs) love

Get started for freeTalk to us