3. Tareas Jeisson - PREX

3. Tareas Jeysson - PREX Sistema Completo (BD + Auditoría)

Fase 1: Base de Datos PREX

1.1 Diseño y Migraciones

• Diagramar estructura de datos

• [8] Crear migraciones completas

  • Tabla empresas_prex: (clientes, plan, API key, orden_api_key).
  • Tabla usuarios_prex: (auth, rol, empresa_id).
  • Tabla proveedores_maestro: (rnc, nombre_comercial, categoria_gasto_default) → Para autocompletado.
  • Tabla facturas_prex: (voucher_id, hash_archivo, estado [pendiente, procesado, validado, error], usuario_id).
  • Tabla datos_extraidos: (campos OCR, confidence_score, campos_editados_json, alerta_calculo_bool).
  • Tabla logs_exportacion: (historial de envíos a ORDEN o Excel).

• [3] Índices y optimización

  • Índice UNIQUE (rnc, ncf, monto): Para prevención de duplicados.
  • Índice compuesto (empresa_id, estado): Para velocidad en el dashboard.

Fase 2: Backend PREX - API

• [5] Setup proyecto backend (FastAPI recomendado para manejo de archivos e IA).
  • Estructura de servicios para: IA, Almacenamiento, Contabilidad.
• [8] APIs de Gestión
  • CRUD /api/proveedores (Gestionar el maestro de proveedores).
  • CRUD /api/facturas (Filtros por estado de validación).

2.3 Upload y Prevención de Duplicados

• [8] Endpoint upload inteligente
  • Generar Hash del archivo para evitar subir el mismo PDF dos veces.
  • Validar contra la BD si el RNC + NCF ya existe antes de llamar a la IA (ahorro de costos).
  • Storage S3/Local + Registro en facturas_prex como estado PENDIENTE.

2.4 Procesamiento IA con Contexto (BD)

• [13] Extractor con Memoria
  • Integrar Claude API.
  • Data Enrichment: Si el RNC existe en el maestro, asignar categoría de gasto automáticamente.
  • Validación de Cálculos: Lógica interna para verificar que Subtotal + ITBIS = Total.
  • Guardar en datos_extraidos marcando alertas si los cálculos no cuadran.
• [5] Job queue (Redis + Celery/Bull) para proceso asíncrono.

Fase 3: Frontend (Interfaz de Auditoría)

3.1 Dashboard de Control

• [5] Cards de estado: Pendientes de revisar, Alertas de cálculo, Listas para exportar.
• [13] Validación en 2 columnas
  • Visor de Archivo vs Formulario.
  • Resaltar campos donde la confianza de IA es <80% o hubo error de cálculo.
  • Maestro On-the-fly: Opción de “Guardar proveedor y categoría” al validar.
  • Auto-save y navegación rápida entre facturas pendientes.

3.3 Gestión de Lotes

• [3] Selección múltiple para “Aprobar y Mandar a ORDEN” masivamente.

Fase 4: Exportación e Integración

4.1 Generador de Reportes

• [5] Generar Excel 606 basado en datos validados en la BD (no solo en el OCR).

4.2 Integración ORDEN.app

• [13] Exportador excel y API
  • Mapeo de campos entre PREX y ORDEN.
  • Registro de éxito/error en logs_exportacion.
  • Marcar en BD como EXPORTADO para evitar re-envíos.
• [3] Control de cuotas según el plan del cliente (ej. 50 factu ras/mes).

Fase 5: Deployment y DevOps

• [8] Desplegar
  • realizar test conexion con ORDEN
• Configuración de backups automáticos de la Base de Datos (fundamental ahora que no es solo Excel).

Fase 6: Monitoreo

8.1 Logs y Analítica

• [3] Dashboard interno para ver cuántas facturas requieren corrección humana (métrica de eficiencia de la IA).