Quarum LogoQUARUMv2.4 Core
ARQUITECTURA & INFRAESTRUCTURA
verified Desarrollado e impulsado por Nible Tecnología

Arquitectura Desacoplada en 3 Capas: Escalabilidad y Aislamiento de Misión Crítica

Diseñada para garantizar mantenibilidad a largo plazo, separación estricta de responsabilidades y despliegues independientes sin riesgo de acoplamiento.

Model-Driven & RAD
Core
Arquitectura en 3 Capas
Desacoplada
Doble Rama Alembic
Migraciones
Almacenamiento Local / S3
Wasabi / OSS
[ ARQUITECTURA DISTRIBUIDA ]

Estructura de la Arquitectura en 3 Capas

Separación estricta de responsabilidades para garantizar mantenibilidad, escalabilidad e independencia total entre el núcleo del framework, la lógica de negocio y la infraestructura de despliegue.

CAPA 01 El Paquete Framework (Python Package)

Quarum (Core)

[ Núcleo Base / Framework ]

Framework centralizado de alto rendimiento instalado vía paquete Python. Provee el motor declarativo inmutable, gestión de seguridad y abstracción de datos.

Componentes Clave:
  • check_circle Motor Model-Driven & Adaptador de Clases: application.py / Clazz.
  • check_circle Autenticación, Sesión y Permisos RBAC: Modelos _qcore_user, _qcore_permission.
  • check_circle Motor de Explotación de Datos: Generación de PDF (xhtml2pdf), CSV y Códigos QR.
  • check_circle Rama de Migraciones Core: Gestionada bajo quarum/migrations/.
verified_user Beneficio Arquitectónico Wheel / pyproject.toml

Garantiza la consistencia del sistema e inmutabilidad del framework central sin riesgos de regresión al actualizar el paquete.

CAPA 02 Lógica Portable del Proyecto

Payload (Aplicación)

[ Código Específico del Proyecto ]

Capa modular que contiene las definiciones de dominio y reglas comerciales. Es completamente desacoplada y exportable entre instancias.

Componentes Clave:
  • check_circle Metadatos de Clases: classes/*.json (Fuente única de verdad).
  • check_circle Modelos y Artefactos: project/models/production/.
  • check_circle Handlers y Eventos: Campos calculados en events.py y actions.py.
  • check_circle Plugins y Estilos: Extensión en plugins/<nombre>/ y marca en project/static/.
  • check_circle Rama de Migraciones App: Versiones en migrations/versions/.
stars Beneficio Arquitectónico Repositorio Independiente

Total libertad para extender capacidades y modularizar la lógica de negocio sin tocar una sola línea de código del Core.

CAPA 03 Entorno & Persistencia

Instancia (Despliegue)

[ Infraestructura & DB ]

Entorno de host donde se ejecuta el binario. Aísla las credenciales, conexiones persistentes a bases de datos relacionales y buckets de almacenamiento.

Componentes Clave:
  • check_circle Entrypoint Único WSGI: wsgi.py (~30 líneas) y variables de entorno .env.
  • check_circle Persistencia Relacional: MySQL / MariaDB con motor InnoDB obligatorio.
  • check_circle Almacenamiento de Blobs: Directorio uploads/ o Bucket S3 / Wasabi / Alibaba OSS.
  • check_circle Auditoría & Respaldo: Logs en logs/app.log y directorio de backups/.
dns Beneficio Arquitectónico VPS / Nginx + Gunicorn

Despliegue multi-cliente sobre entornos independientes preservando la soberanía de infraestructura y el aislamiento estricto de datos.

security Protocolo de Gobernanza Nible Tecnología • Inyección dinámica y contratos estrictos entre capas.
RUNTIME VALIDATED
[ VENTAJAS ESTRATÉGICAS ]

Por Qué Desacoplar Transforma la Operación

La ingeniería de software impulsada por modelos resuelve el dilema clásico entre velocidad de entrega y deuda técnica.

update

Actualizaciones sin Fricción

Al mantener el Core totalmente desacoplado de la lógica de aplicación, las actualizaciones de seguridad, parches del framework y optimizaciones de rendimiento se aplican de forma transparente sin alterar ningún flujo corporativo.

0% RIESGO DE REGRESIÓN • PATCHING INMEDIATO
layers

Reutilización de Código

Las definiciones de la capa Payload se pueden modularizar y empaquetar para reutilizarse en distintas instancias de clientes con mínimas modificaciones, reduciendo el Time-to-Market de nuevas soluciones hasta en un 70%.

COMPONENTES PORTABLES • PLUG-AND-PLAY
security

Seguridad Estricta

La capa de Instancia e Infraestructura está herméticamente aislada. Cualquier fallo o vulnerabilidad en un plugin de la capa de aplicación queda confinado, impidiendo que se comprometa la base de datos central o el host anfitrión.

CONTENCIÓN DE FALLOS • SANDBOXING RUNTIME
groups

Desarrollo en Paralelo

Equipos de frontend, especialistas en reglas de negocio (backend) y DevOps operan de forma autónoma sobre capas distintas sin generar colisiones ni cuellos de botella en el control de versiones Git ni en el CI/CD.

MERGE CONFLICTS ZERO • CI/CD AUTÓNOMO
[ PIPELINE DE OPERACIÓN EN VIVO ]

Flujo de Datos y Ejecución en Runtime

LATENCIA MEDIA SUBSISTEMA: < 8.4ms
01 [ Capa: Instancia ]

Petición HTTP & Entrypoint

Nginx + Gunicorn / wsgi.py

Nginx recibe la petición y la pasa a Gunicorn -> wsgi.py (Resuelve QUARUM_ROOT y lee .env).

Nginx + Gunicorn / wsgi.py arrow_forward
02 [ Capa: Core ]

Validación & Permisos RBAC

Flask-Login / @verify_permission

create_app() valida la sesión de Flask-Login y el decorador @verify_permission evalúa los permisos RBAC en _qcore_permission.

Flask-Login / @verify_permission arrow_forward
03 [ Capa: Payload ]

Lógica & Eventos del Payload

after_commit / events.py

Se ejecutan los controladores de la aplicación/plugins y el listener after_commit dispara los campos calculados de events.py.

after_commit / events.py arrow_forward
04 [ Capa: Core / Instancia ]

Persistencia & Explotación

InnoDB / SoftDeleteMixin / Jinja2

session.py ejecuta la consulta en MySQL/MariaDB (InnoDB), maneja borrado lógico (SoftDeleteMixin) y renderiza la plantilla Jinja2 o exportación (CSV/PDF).

InnoDB / SoftDeleteMixin / Jinja2 done_all
speed

Ciclo de Vida de Ejecución Garantizado

Sin fugas de estado entre invocaciones: cada solicitud es procesada bajo transacciones atómicas.

RESPUESTA TÍPICA 14.2ms
[ SESIÓN DE INGENIERÍA ]

Construye tus sistemas de misión crítica sobre una arquitectura sólida.

Solicita un entorno de pruebas o agenda una sesión técnica de evaluación arquitectónica directa con los ingenieros de Nible Tecnología.

verified Auditoría de compatibilidad para proyectos heredados
verified Demostración de desacoplamiento de capas en vivo
verified Acompañamiento especializado de Nible Tecnología
N
Nible Tecnología S.A. Centro de Innovación y Arquitectura RAD

Solicitud de Demostración

Acceso restringido para equipos de ingeniería y arquitectura.

Bajo acuerdos de confidencialidad NDA estándar.