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 es una plataforma web construida con Django 4.2 y PostgreSQL, concebida para acompañar al creyente en el camino de profundizar su intimidad con Dios. El nombre proviene del latín flos, flōris (‘flor’) y legĕre (‘escoger’): una colección de trozos selectos de tesoros bíblicos, históricos y espirituales. La plataforma reúne artículos teológicos, ensayos de fondo, una herramienta de estudio bíblico interlineal en griego (OGNT/RMAC) y hebreo (OSHB/morphHB), las concordancias de Strong y Vine, y una sección educativa llamada Madres Maestras, todo ello bajo un diseño editorial de paleta crema/arena que cuida la lectura y eleva el contenido.

​
¿Qué es Florilegio de la Fe?

La misión de Florilegio es rescatar la intimidad con Dios a través del conocimiento serio de su Palabra y de la historia de la Iglesia. No se trata de un agregador de noticias religiosas, sino de un espacio de formación donde cada pieza de contenido ha pasado por un ciclo de revisión editorial antes de ser publicada. La plataforma organiza su contenido en cuatro grandes áreas:
ÁreaDescripción
ArtículosPiezas de divulgación teológica, historia de la Iglesia y vida de los santos, organizadas por categoría y etiquetas.
EnsayosEscritos de mayor extensión y profundidad académica, igualmente categorizados y filtrados por estado de publicación.
Estudio BíblicoHerramienta interlineal que permite consultar cada palabra del Nuevo Testamento griego (OGNT + RMAC) y del Antiguo Testamento hebreo (OSHB + morphHB), junto con los números de Strong y la concordancia de Vine. Los usuarios registrados pueden guardar sus propios estudios personales.
Madres MaestrasRecursos educativos con pasaje bíblico, versículo clave, objetivos de enseñanza, materiales y tiempo estimado, organizados por categoría de edad, dirigidos a madres y educadoras cristianas.
El público objetivo abarca estudiantes de teología, pastores, educadores, padres de familia y cualquier creyente que desee ir más allá de la lectura devocional superficial.
Todo el contenido —artículos, ensayos y recursos de Madres Maestras— pasa obligatoriamente por un ciclo de revisión editorial. El campo status de cada modelo puede ser 'revision' (en revisión) o 'liberado' (publicado y visible al público). Ningún contenido llega a los lectores sin haber sido explícitamente liberado por el equipo editorial.

​
Arquitectura del proyecto

Florilegio de la Fe se apoya en un conjunto pequeño y deliberado de dependencias de producción:
  • Django 4.2.11 — framework principal; gestiona ORM, admin, vistas, URLs y sistema de plantillas.
  • PostgreSQL — base de datos relacional; se accede mediante psycopg2-binary 2.9.11. Django utiliza django.contrib.postgres para búsquedas de texto completo.
  • WhiteNoise 6.6.0 — sirve los archivos estáticos directamente desde el proceso Django con compresión gzip y cabeceras de caché, sin necesidad de un servidor de archivos estáticos independiente en producción. Configurado con CompressedStaticFilesStorage.
  • django-allauth 0.54.0 — gestión de cuentas de usuario: registro por correo electrónico, inicio de sesión, verificación de correo y autenticación social vía Google OAuth con PKCE.
  • django-ratelimit 4.1.0 — limitación de tasa en vistas y endpoints de API para mitigar abuso y ataques de fuerza bruta.
  • bleach 6.3.0 — saneamiento del contenido HTML introducido por los autores, que evita inyecciones XSS en el campo content de artículos y ensayos.
  • Pillow 12.2.0 — procesamiento de imágenes para las fotos de perfil de autores y avatares de usuario.
  • python-dotenv 1.0.1 — carga de variables de entorno desde el archivo .env en desarrollo y producción.
La autenticación admite tres backends en cadena: el backend estándar de Django (ModelBackend), un backend personalizado por correo electrónico (EmailBackend) y el backend de allauth.

​
Estructura del repositorio

florilegio/
├── florilegiofe/          # Configuración principal del proyecto Django
│   ├── settings.py        # Variables de entorno, INSTALLED_APPS, base de datos, allauth
│   ├── urls.py            # Tabla de rutas raíz: artículos, ensayos, biblia, API, auth
│   └── wsgi.py            # Punto de entrada WSGI para el servidor de producción
│
├── main_florife/          # Aplicación principal
│   ├── models.py          # Modelos: Article, Essay, PalabraBiblia, PalabraHebreo,
│   │                      #   LibroBiblia, VersiculoBiblia, StrongConcord, VineConcord,
│   │                      #   UserProfile, UserStudy, MadreMaestraResource y más
│   ├── views.py           # Vistas de artículos, ensayos, estudios, perfil, planes
│   ├── views_api_bible.py # Endpoints de sincronización de versiones bíblicas (admin)
│   ├── views_youversion.py# Integración con la plataforma YouVersion
│   ├── views_authors.py   # Portal de autores (crear y editar artículos)
│   ├── middleware.py      # SecurityHeadersMiddleware personalizado
│   ├── auth_backends.py   # Backend de autenticación por correo electrónico
│   ├── adapters.py        # FlorilegioSocialAdapter para allauth
│   ├── sitemap.py         # ArticleSitemap, EssaySitemap, StaticSitemap
│   └── management/
│       └── commands/      # Comandos de importación de datos bíblicos
│           ├── generar_libros.py
│           ├── import_biblia.py
│           ├── import_morphhb.py
│           ├── import_rv1960.py
│           ├── import_ebible_version.py
│           ├── import_strong_concord.py
│           ├── import_strong_from_json.py
│           ├── import_contexto_libro.py
│           ├── extract_strong_numbers.py
│           ├── populate_espanol_hebreo.py
│           ├── seed_data.py
│           └── sync_bible_data.py
│
├── templates/             # Plantillas HTML/Django organizadas por sección
│
├── biblia/
│   └── morphhb/           # Datos de morfología hebrea (OSHB/morphHB) utilizados
│                          # por el comando import_morphhb para poblar la base de datos
│
├── static/                # CSS, JS e imágenes del sistema de diseño personalizado
├── staticfiles/           # Archivos estáticos recopilados (collectstatic)
├── media/                 # Archivos subidos por usuarios (fotos de autores, avatares)
├── manage.py
└── requirements.txt

​
Filosofía de diseño

Estética editorial. La interfaz de Florilegio rechaza deliberadamente el aspecto genérico de los CMS modernos. El diseño parte de una paleta crema y arena (#f7f3ed) que reduce la fatiga visual en lecturas largas. El paper-edge effect —un divisor orgánico en forma de borde de papel antiguo— actúa como transición entre secciones, devolviendo calidez analógica a la experiencia digital. El logo de portada incorpora una animación vertical-flip al cargar la página de inicio, y el buscador se despliega como una barra expansiva sutil que solo aparece cuando se necesita. Modularidad del contenido. Los tres formatos principales de contenido —Artículos, Ensayos y Recursos Madres Maestras— tienen modelos de datos propios pero comparten la misma lógica de estados. Esta separación permite aplicar distintas reglas editoriales y distintos diseños de presentación sin acoplar el código. Ciclo de revisión. Todos los modelos de contenido publicable (Article, Essay, MadreMaestraResource) definen el campo status con dos estados: 'revision' (En Revisión) y 'liberado' (Liberado). El contenido se crea siempre en estado 'revision' y solo pasa a 'liberado' tras la aprobación editorial. Esto garantiza que los lectores siempre encuentren contenido revisado y alineado con la misión de la plataforma. Suscripciones y acceso. Los perfiles de usuario (UserProfile) soportan tres planes: free, premium y pro. El plan determina el límite de estudios personales que el usuario puede guardar (3 para free, 100 para premium, sin límite para pro). La integración con PayPal gestiona la activación de suscripciones.

Arquitectura

Diagrama de componentes, flujo de datos y decisiones de infraestructura del proyecto.

Artículos y Ensayos

Cómo funciona el sistema de publicación, categorías, etiquetas y el portal de autores.

Estudio Bíblico Interlineal

Herramienta interlineal griego/hebreo, concordancias de Strong y Vine, y estudios personales.

Quickstart

Levanta el entorno de desarrollo local en 6 pasos: clonar, instalar, configurar y migrar.

Build docs developers (and LLMs) love

Get started for freeTalk to us