IPSExtractor/services/desktop_app/README.md

IPSExtractor Desktop App

Aplicacion desktop Windows/Mac para ejecutar el flujo de extraccion usando el API Gateway de IPSExtractor. Esta carpeta funciona como repo independiente.

Requisitos

• Node.js 20+
• Backend levantado con docker compose up --build
• Electron (incluido en npm run dev)

No necesitas montar la carpeta del usuario en Docker. La app indexa los archivos localmente y los sube uno a uno al servicio de extraccion.

Desarrollo

npm install
npm run dev

El gateway por defecto es http://localhost:8000.

Tests y build

npm test
npm run build
npm run dist

Flujo desktop

1. Verificar conexion al gateway.
2. Seleccionar una carpeta local (Electron indexa PDF/TIFF).
3. Configurar modo radicados o general.
4. Descubrir campos (POST /extraction/schemas/upload con un archivo de muestra).
5. Seleccionar campos y alias.
6. Ejecutar extraccion (POST /tasks/extraction con source=desktop + ingestas).
7. Consultar el historial de tareas.
8. Ver filas extraidas desde la base de datos.
9. Exportar CSV local de forma opcional.

Los PDFs permanecen en el disco del usuario. El servidor solo usa archivos temporales durante cada ingest y guarda JSON en Postgres.

La app no incluye limpieza, preclasificacion, postproceso ni dashboard completo en esta version.