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
• Documentos montados en Docker como /data

Configuracion de rutas

La app no sube archivos en v1. El usuario solo selecciona la carpeta a procesar. Internamente, la app traduce esa carpeta al path montado en Docker.

Si IPS_DOCUMENT_ROOT existe en el entorno de la app, la carpeta seleccionada debe estar dentro de ese root. Si no existe, la app toma la carpeta elegida como root local para traducirla a /data.

Para procesar documentos fuera de data, levanta Docker y la app con el mismo root local:

IPS_DOCUMENT_ROOT=/ruta/a/documentos docker compose up --build
IPS_DOCUMENT_ROOT=/ruta/a/documentos npm run dev

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 v1

1. Verificar conexion al gateway.
2. Seleccionar una carpeta local que este montada para los servicios Docker.
3. Configurar modo radicados o general.
4. Descubrir campos con /extraction/schemas.
5. Seleccionar campos y alias.
6. Estimar o crear tarea de extraccion.
7. Consultar el historial de tareas.
8. Ver filas extraidas desde la base de datos.
9. Exportar CSV local de forma opcional.

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