Arquitectura

Documentación técnica de la arquitectura de Duckling.

Visión General

Duckling es una aplicación web full-stack con una clara separación entre frontend y backend:

graph LR
    A[Navegador] --> B[Frontend React]
    B --> C[Backend Flask]
    C --> D[Motor Docling]
    D --> E[(Almacenamiento)]

    style A fill:#3b82f6,color:#fff
    style B fill:#1e3a5f,color:#fff
    style C fill:#14b8a6,color:#fff
    style D fill:#8b5cf6,color:#fff
    style E fill:#f59e0b,color:#fff

Secciones

Decisiones de Diseño Clave

Separación de Responsabilidades

• Frontend: React con TypeScript para seguridad de tipos e interfaz moderna
• Backend: Flask por simplicidad y acceso al ecosistema Python
• Motor: Docling para conversión de documentos (biblioteca de IBM)

Procesamiento Asíncrono

La conversión de documentos se maneja de forma asíncrona:

1. El cliente sube el archivo
2. El servidor devuelve un ID de trabajo inmediatamente
3. El cliente consulta el estado
4. El servidor procesa en un hilo en segundo plano
5. Los resultados están disponibles cuando se completa

Cola de Trabajos

Una cola de trabajos basada en hilos previene el agotamiento de memoria:

• Máximo 2 conversiones simultáneas
• Los trabajos se ponen en cola cuando se alcanza la capacidad
• Limpieza automática de trabajos completados

Persistencia de Configuración

Los ajustes se almacenan por sesión de usuario y se aplican por conversión:

• Valores predeterminados globales en config.py
• Configuración de usuario almacenada en la base de datos (por ID de sesión)
• Anulaciones por solicitud a través de la API

Los ajustes están aislados por sesión de usuario, garantizando que los despliegues multi-usuario no interfieran con las preferencias de otros.

Stack Tecnológico

Frontend

Backend