Proyecto
Billing / Invoices: automatización de procesos de facturación
Este proyecto aborda un problema operativo recurrente: convertir documentos de facturación entrantes en registros contables verificables sin perder trazabilidad ni control humano sobre las mutaciones. No es un producto comercial ni un caso de estudio con cliente identificable; es un trabajo de ingeniería sobre un dominio real, anonimizado donde hace falta.
El problema no es solo OCR
Capturar texto de una factura es el primer paso, no el objetivo. El flujo completo incluye validación contra reglas de negocio, detección de duplicados, umbrales de aprobación, codificación fiscal y publicación en sistemas contables. Cada etapa puede fallar de forma distinta y dejar el pipeline en un estado parcial.
La arquitectura separa esas responsabilidades en etapas reconocibles:
- Capture — OCR y parsing estructurado del documento.
- Validate — comprobaciones de datos, reglas de negocio y duplicados.
- Approve — workflows humanos o automáticos según umbrales.
- Post — integración con ERP, subledger y auditoría.
El diagrama del proyecto muestra además un motor de orquestación y reglas, integraciones downstream y un panel de operaciones con excepciones.
Automatización observable
Playwright valida flujos de interfaz en entornos containerizados. Docker proporciona runtimes reproducibles para servicios auxiliares y para pruebas visuales con CDP/X11 cuando hace falta inspección gráfica. FastAPI expone la API de dominio; PostgreSQL almacena el estado operativo.
La interfaz humana y la interfaz agéntica comparten la misma API. Ningún script accede directamente a la base de datos para mutaciones de negocio: el contrato pasa por endpoints con semántica explícita.
Forecast y rehearsal antes de mutar
Procesar un lote de facturas puede afectar miles de registros contables. Antes de ejecutar un Post real, el proyecto utiliza los patrones descritos en Forecast Pattern y Rehearsal Pattern:
- Rehearsal: ensayar el flujo completo sobre fixtures o entornos aislados.
- Forecast: proyectar excepciones, duplicados probables y carga sobre integraciones.
Un run exitoso en staging no autoriza automáticamente producción. La aprobación exige evidencia acumulada y alcance acotado.
Validación y excepciones
El panel de operaciones distingue capturados, en progreso, pendientes de aprobación y completados. Las excepciones —errores de validación, PO ausente, duplicados, aprobaciones vencidas— requieren intervención explícita, no silencio.
Los tests cubren contratos de API, reglas de validación y escenarios de integración con fixtures. Playwright ejecuta smoke de UI sobre flujos críticos sin mezclar datos de producción en las pruebas.
Límites declarados
Este resumen no documenta endpoints internos, credenciales, volúmenes reales ni nombres de sistemas empresariales. Describe la forma del trabajo —pipeline, API, contenedores, validación— para que los artículos de patrones tengan un anclaje concreto sin convertir el archivo en documentación confidencial.