TopPaperless

Descripción

topPaperless es un MVP de plataforma paperless para la gestión inteligente de documentos. Permite a los usuarios subir, visualizar y organizar documentos digitales, incorporando capacidades de IA para extraer información relevante (tipo de documento, monto, empresa) y transcribir contenido mediante APIs especializadas. El sistema está construido con Django y preparado para evolucionar hacia una solución multitenant y escalable.

Características principales

• Gestión de documentos digitalizados (boletas, facturas, contratos, etc.)
• Extracción automática de datos clave usando IA (Meta-Llama, Whisperer)
• Interfaz web simple y segura
• Separación de documentos por usuario
• Preparado para integraciones futuras con sistemas externos (ERP, IMS, TMS)

Requisitos

• Python 3.10+
• pip
• (Opcional) virtualenv
• Claves de API para Whisperer y HuggingFace (ver archivo .env)

Instalación

1. Clona el repositorio

2. Crea y activa un entorno virtual

3. Instala las dependencias

4. Configura las variables de entorno

   • Crea un archivo .env en la raíz con tus claves:

     WHISPERER_API_KEY=tu_api_key_whisperer
     HF_API_KEY=tu_api_key_huggingface

5. Aplica migraciones

6. Crea un superusuario (opcional, para admin)

7. Ejecuta el servidor

      python manage.py runserver

8. Accede a la plataforma

   • Abre tu navegador en: http://127.0.0.1:8000/documents/register

Notas

• Los documentos subidos se almacenan en la carpeta media/documents/.
• Para usar las funciones de IA, asegúrate de tener las claves de API configuradas.
• El proyecto usa SQLite por defecto; para producción se recomienda migrar a PostgreSQL.

Estructura del proyecto

topPaperless/
├── manage.py
├── db.sqlite3
├── documents/
│   ├── models.py
│   ├── views.py
│   ├── utilsIa.py
│   └── ...
├── topPaperless/
│   ├── settings.py
│   ├── urls.py
│   └── ...
├── media/
│   └── documents/
└── requirements.txt

Créditos

Desarrollado por Javiera Labrín.

Desafío empresa The Optimal