Manual de IngestCore — instalación, rutinas y flujo del sistema

Flujo del sistema

IngestCore es una tubería de documentos: entra un archivo, sale un dato estructurado. El diagrama siguiente es el camino completo — cada caja corresponde a una pantalla o rutina descrita en este manual.

Un documento retenido por el análisis de seguridad sigue legible dentro del producto — lo que no puede hacer es salir: exportación, integración y nube quedan bloqueadas hasta la liberación con justificación.

Instalación

Descargue XCODEF-IngestCore-1.0.0-Setup.exe desde la página del producto o desde Microsoft Store y ejecútelo. La instalación:

No pide administrador — se instala en su perfil de usuario;
Lleva todo adentro: API local, worker de lectura, OCR (portugués e inglés) y el gestor de IA local;
Crea acceso directo en el menú Inicio y en el escritorio;
Guarda sus datos fuera de la carpeta del programa, en %LOCALAPPDATA%\XCODEF\IngestCore — actualizar o reinstalar nunca se lleva sus documentos.

Requisitos: Windows 10/11 de 64 bits, 8 GB de memoria (16 GB recomendados para IA local), 1 GB de disco para el producto más espacio para sus documentos. La tarjeta de video es opcional — con ella, la IA local va más rápido y el propio producto recomienda mejores modelos.

Primer uso

En la primera apertura, un asistente de nueve pasos configura lo esencial en unos dos minutos: carpeta de entrada, idioma del OCR, IA local (opcional) y un resumen de lo que queda activo de seguridad. “Ahora no” es una respuesta válida en cualquier paso — todo puede configurarse después, y el asistente no vuelve a aparecer solo.

Bienvenida y preparación — dónde quedan los datos;
Verificación de componentes — base, OCR y área de datos comprobados en el acto;
Carpeta de entrada — elija una carpeta suya (ej.: Documentos\IngestCore\Entrada). El asistente rechaza carpetas internas del producto;
OCR — idioma principal de los documentos;
IA local — “Analizar esta computadora” mide procesador, memoria y tarjeta de video y recomienda el modelo correcto, con el tamaño de descarga visible antes de cualquier clic;
Nube (opcional) — apagada por defecto; exige tres decisiones suyas para existir;
Seguridad — resumen de lo que está activo;
Concluir — el producto ya está trabajando.

Cockpit gerencial

La pantalla que responde lo que pregunta el dueño de la operación: cuántos documentos entraron, cuántos pasaron sin intervención humana, cuál es la confianza media, dónde se gasta el tiempo y qué necesita atención hoy.

Los indicadores se recortan por hoy, 7 días, 30 días o todo el período. Hacer clic en un tipo documental filtra todo el cockpit por él — así se descubre que el atraso está solo en las facturas de un proveedor.

Carpeta vigilada e importación

La carpeta vigilada es el corazón de la operación: todo archivo que cae en ella se importa automáticamente (XML, PDF, JPG, PNG). Tras la lectura, el original se mueve a la subcarpeta leídos\<TIPO> — organizado por tipo documental — y lo que falla va a _error con el motivo en un archivo al lado.

También se puede importar manualmente con el botón Importar y reprocesar cualquier documento sin que vuelva a contar en la licencia.

Automatización de entrada: la carpeta vigilada, el destino de los leídos y el intervalo de verificación.

Operación y verificación

La pantalla Operación es la mesa de trabajo: cola de procesamiento, documentos esperando verificación y el detalle completo de cada uno — datos extraídos, texto leído, resultados por etapa y auditoría.

Operación: cola a la izquierda, documento abierto a la derecha, con clasificación y acciones.

Los documentos por debajo de la regla de confianza del tipo entran en verificación: usted ve el documento y los campos lado a lado, corrige lo necesario y aprueba. La regla se configura por tipo documental — una factura de proveedor puede exigir 95%, un recibo interno puede aceptar 80%.

Datos consolidados: encabezado, ítems y totales en el formato que va a la integración.

Las pestañas del documento muestran cada etapa por separado, lo que facilita descubrir dónde algo salió mal: si el texto del OCR está bien pero el campo salió vacío, el problema es de extracción, no de lectura.

Texto leído por el OCR, con el motor utilizado y el tiempo de procesamiento.

Extracción por IA local, con el nivel de confianza de lo que se entendió.

Validaciones automáticas: suma de ítems contra el total, campos obligatorios, identificación fiscal bien formada.

Auditoría: cada paso del documento, desde la llegada hasta quién confirmó el tipo.

Historial completo: todos los documentos, con filtros por estado y tipo.

Tipos documentales

Cada tipo (factura, factura de servicio, boleto, recibo, contrato…) tiene su flujo: palabras clave de clasificación, prompt de extracción, esquema de validación, regla de verificación y nivel de confidencialidad. Los 19 tipos de fábrica cubren el día a día fiscal — y los tipos nuevos son datos, no código: su instalación puede ganar un tipo específico de su operación sin actualizar el producto (servicio XCODEF, R$ 150/h).

Tipos de documento: palabras clave, campos esperados y regla de verificación de cada uno.

IA local

La pestaña IA local en el Centro de IA es el gestor inteligente: mide su computadora (procesador, memoria, tarjeta de video, espacio) y recomienda la mejor configuración — usted no necesita saber qué es VRAM o cuantización.

Instalación asistida del motor (Ollama): origen oficial, integridad verificada por SHA-256, progreso real y cancelación;
Catálogo homologado: solo modelos probados por XCODEF, con el tamaño visible antes de la descarga;
Prueba con un clic: el modelo se aprueba en SU máquina antes de entrar en producción;
Sin IA también funciona: el OCR integrado sigue leyendo todo; la IA mejora la extracción, no es un requisito.

IA local: análisis de la computadora y modelos recomendados para ella.

Las demás pestañas cubren el ciclo completo de inteligencia: probar la extracción en un banco aislado, enseñar a la IA a partir de correcciones reales, elegir proveedores y modelos, y seguir el costo cuando se usa la nube.

Banco de pruebas: pegue un texto, ajuste el prompt y vea el JSON que saldría.

Enseñar a la IA: la corrección de hoy se vuelve acierto en el próximo documento del mismo proveedor.

Seguridad y cuarentena

Todo documento pasa por un análisis determinista (sin IA — no hay a quién “convencer”) que busca contenido intentando manipular la lectura: instrucciones escondidas, texto invisible, divergencia entre lo que el PDF muestra y lo que contiene. Riesgo alto significa cuarentena automática.

Un documento en cuarentena no exporta, no integra y no sube a la nube — pero sigue legible para que usted lo juzgue;
La liberación exige justificación y queda auditada;
Matriz de confidencialidad: cada tipo documental tiene nivel (Público / Interno / Confidencial / Restringido) y la consecuencia es visible — Restringido nunca sale de la máquina, ni con la nube configurada;
Cada bloqueo se convierte en evento de auditoría consultable.

Políticas: qué puede salir de la máquina, por tipo documental y por proveedor.

Protecciones activas por defecto, incluido el bloqueo de URLs encontradas dentro del documento.

Licencia y activación

El período de evaluación incluye 1.000 documentos o 120 días, lo que ocurra primero — sin registro. A partir del 80% de uso, un aviso muestra la barra de consumo, el código de la máquina (XCM-…) y el camino de compra.

Copie el código de la máquina en la pestaña Licencia (un clic);
Haga el pedido en xcodef.com/ingestcore/pedido informando el código;
Pague con Pix, boleto o tarjeta;
La clave llega por correo — péguela en la pestaña Licencia y haga clic en Activar. La activación es sin conexión: nada de su máquina se envía.

Pestaña Licencia: situación, consumo de la evaluación, código de la máquina y campo de activación.

Cuando termina la evaluación, la ingesta de documentos nuevos se pausa — todo lo ya procesado sigue accesible, consultable y exportable. Sus datos nunca quedan rehenes. ¿Cambió de computadora? XCODEF reemite la clave para el nuevo código.

Exportación y ERP

El resultado de cada documento es un JSON canónico — campos, ítems, totales y nivel de confianza en un formato estable. La exportación genera JSON y CSV listos para importar; los layouts específicos de su ERP se construyen a la medida y pasan a formar parte de su instalación.

Los documentos en cuarentena se retienen con aviso — la exportación dice cuántos quedaron fuera y por qué, para que la conciliación nunca cierre mal en silencio.

Central de Parámetros

Todo lo configurable vive aquí, agrupado por asunto y con diagnóstico integrado: estado de los componentes, automatización, lectura, IA y OCR, operación, carpetas, respaldo, seguridad, sistema y licencia. Los perfiles permiten exportar e importar la configuración entera — útil para estandarizar varias máquinas.

Servicios: todo lo que corre por debajo, con nombres claros, estado en vivo y el comando de cada pieza. Aquí se reinicia lo que se cayó.

Estado: diagnóstico en tiempo real del servicio local, la base, el OCR y el motor de IA.

Operación: ritmo del worker, intentos por tarea y los límites que disparan alerta.

Respaldo y registros: rutina automática con rotación, sin depender de que alguien se acuerde.

Guía de implantación (TI)

Privilegios	Instalación por usuario (%LOCALAPPDATA%). No exige administrador ni UAC en el uso normal.
Red	La API local escucha solo en 127.0.0.1 (puerto preferido 3333; si está ocupado, usa otro y lo registra). Ningún documento sale de la máquina sin proveedor de nube configurado + política que lo permita + presupuesto mayor que cero.
Salidas de red posibles	Solo las que el cliente habilite: descarga de modelos de IA (origen oficial) y proveedor de nube con la clave del propio cliente. Verificable por firewall.
Autenticación interna	Token aleatorio por sesión entre interfaz y API — sin secreto fijo en disco.
Instalación silenciosa	Setup.exe /S (NSIS). El mismo artefacto del sitio y de Microsoft Store.
Datos	%LOCALAPPDATA%\XCODEF\IngestCore (base SQLite, registros, respaldos, exportaciones). Desinstalar preserva los datos.
Actualización	Instalar la versión nueva encima; las migraciones corren solas en la primera apertura; datos preservados.
Procesos	Tres procesos: IngestCore.exe (interfaz), API local (Node integrado) y worker (Python integrado). Supervisados por la aplicación; cerrar la ventana mantiene la vigilancia en la bandeja; Salir termina todo.
Requisitos de IA local	Opcional. 8 GB de memoria como mínimo (16 GB recomendados); la tarjeta de video acelera; el producto mide y recomienda — sin tarjeta elige modelos ligeros o solo OCR.
Registros técnicos	%LOCALAPPDATA%\XCODEF\IngestCore\logs (desktop.log, api-local.log, worker-ingestcore.log).

Solución de problemas

La aplicación abre pero dice “el servicio local no inició”
Vea %LOCALAPPDATA%\XCODEF\IngestCore\logs\desktop.log — la causa está en la última línea [ERROR]. Ciérrela desde el ícono de la bandeja (Salir) y ábrala de nuevo.
Puse un archivo en la carpeta y no pasó nada
Confirme en Central de Parámetros → Automatización que la vigilancia está activa y apuntando a la carpeta correcta. Los archivos con falla van a la subcarpeta _error con el motivo al lado.
Un documento quedó en cuarentena
Es el análisis de seguridad haciendo su trabajo. Abra el documento → pestaña Seguridad → vea los hallazgos; si es un falso positivo, libérelo con justificación.
La clave de licencia no activa
Verifique que copió la clave entera (empieza con XCODEF.) y que fue emitida para esta máquina — la pestaña Licencia muestra el código local. ¿Difiere? Responda el correo de la clave pidiendo reemisión.
La IA local quedó lenta
Centro de IA → IA local → Probar. Si la prueba sugiere un modelo más ligero, acéptelo — fue elegido para su máquina real.
Necesito mover el producto a otra computadora
Instálelo en la nueva, copie la carpeta %LOCALAPPDATA%\XCODEF\IngestCore (datos) y pida la reemisión de la clave con el nuevo código de máquina.

¿No se resolvió? contato@xcodef.com — adjunte el paquete de diagnóstico (Central de Parámetros → Estado → Exportar diagnóstico).