Files
IPSExtractor/services/desktop_app/README.md
T

60 lines
1.5 KiB
Markdown

# 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:
```bash
IPS_DOCUMENT_ROOT=/ruta/a/documentos docker compose up --build
IPS_DOCUMENT_ROOT=/ruta/a/documentos npm run dev
```
## Desarrollo
```bash
npm install
npm run dev
```
El gateway por defecto es `http://localhost:8000`.
## Tests y build
```bash
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.