3. Tareas Jeysson - PREX Sistema Completo

Fase 1: Base de Datos PREX actual

1.1 Diseño y Migraciones ganttchart

• [8] Crear migraciones completas ➕ 2026-01-15 🛫 2026-01-15 📅 2026-01-17
  • Tabla empresas_prex (clientes, plan, API key, orden_api_key)
  • Tabla usuarios_prex (auth, rol, empresa_id)
  • Tabla proveedores (RNC, nombre, tipo_documento, para matching)
  • Tabla facturas_prex (voucher, hash_archivo, estado, usuario_id)
  • Tabla datos_extraidos (campos OCR + confidence + alertas_calculo)
  • Tabla logs_exportacion (historial export ORDEN/Excel)
• [3] Índices y optimización ➕ 2026-01-17 🛫 2026-01-17 📅 2026-01-18
  • UNIQUE (empresa_id, rnc, ncf, monto) prevención duplicados
  • Índice compuesto (empresa_id, mes, estado)
  • Índice hash_archivo para búsquedas rápidas

---

Fase 2: Backend PREX - API next

2.1 Setup Backend

• [5] Setup proyecto backend ➕ 2026-01-20 🛫 2026-01-20 📅 2026-01-21
  • FastAPI + estructura servicios (IA, Storage, Contabilidad)
  • Conexión prex_db + CORS
  • Variables entorno (.env)

2.2 CRUD Básico

• [8] APIs gestión datos ➕ 2026-01-22 🛫 2026-01-22 📅 2026-01-24
  • POST /api/auth/register, /api/auth/login
  • CRUD /api/empresas
  • CRUD /api/proveedores (maestro autocompletado)
  • CRUD /api/facturas (filtros por estado)

2.3 Upload con Prevención Duplicados (RF01)

• [8] Endpoint upload inteligente ➕ 2026-01-27 🛫 2026-01-27 📅 2026-01-29
  • POST /api/facturas/upload (multipart)
  • Generar hash SHA-256 del archivo
  • Validar hash + (RNC+NCF) contra BD antes de procesar
  • Storage S3/Spaces/local
  • Crear registro facturas_prex (estado: pendiente)
  • Upload batch (hasta 20 archivos)
  • Validar formato (PDF, JPG, PNG) y tamaño (10MB)

2.4 Procesamiento IA con Contexto (RF02 + RNF01)

• [13] Extractor con validaciones ➕ 2026-01-30 🛫 2026-01-30 📅 2026-02-05
  • Integrar Tesseract OCR + pre-procesamiento
  • Integrar Claude API con prompt optimizado
  • Extraer: RNC, nombre, NCF, fechas, montos, ITBIS, forma_pago
  • Data Enrichment: matching con proveedores maestro
  • Validación cálculos: Subtotal + ITBIS = Total
  • Calcular confidence_score por campo
  • Marcar alertas si cálculos no cuadran
  • Guardar en datos_extraidos
  • Meta precisión: ≥80% (RNF01)
• [5] Job queue asíncrono ➕ 2026-02-05 🛫 2026-02-05 📅 2026-02-06
  • Redis + Celery/Bull
  • ProcesarFacturaJob con reintentos (max 3)
  • GET /api/facturas/{id}/status

---

Fase 3: Frontend PREX

3.1 Setup Frontend

• [5] Setup proyecto frontend ➕ 2026-02-07 🛫 2026-02-07 📅 2026-02-09
  • React/Vue/Next.js + routing
  • Axios + state management
  • Login y Registro (RNF04)

3.2 Dashboard Principal (RF05)

• [5] Dashboard con métricas ➕ 2026-02-10 🛫 2026-02-10 📅 2026-02-11
  • Cards: subidas, procesadas, validadas, pendientes, alertas cálculo
  • Gráfico evolución (6 meses)
  • Tabla resumen Handsontable o estándar
  • Filtros: empresa, mes, estado

3.3 Upload UI (RF01)

• [8] Interfaz carga facturas ➕ 2026-02-12 🛫 2026-02-12 📅 2026-02-14
  • Drag & Drop (Filepond/Dropzone)
  • Preview + progress bar
  • Múltiples archivos
  • Selector empresa_cliente y mes/ciclo
  • “Procesar Todas”

3.4 Lista Facturas (RF06)

• [5] Tabla facturas procesadas ➕ 2026-02-15 🛫 2026-02-15 📅 2026-02-16
  • Columnas: thumbnail, fecha, proveedor, NCF, monto, estado, acciones
  • Filtros: mes, estado, empresa, proveedor
  • Paginación

3.5 Interfaz Auditoría/Validación (RF03 + RF04)

• [13] Vista 2 columnas validación ➕ 2026-02-17 🛫 2026-02-17 📅 2026-02-21
  • Columna izq: Visor PDF/imagen (zoom, rotar)
  • Columna der: Formulario editable todos los campos
  • Badges confianza: verde >80%, amarillo 50-80%, rojo <50%
  • Alerta visual si cálculos no cuadran
  • Autocompletado proveedores desde maestro
  • Opción “Guardar proveedor” on-the-fly
  • Auto-save (debounce 500ms)
  • Navegación Anterior/Siguiente
  • Botones: Validar, Rechazar, Editar
  • Registro auditoría de cambios (RF08)

3.6 Validación Batch

• [3] Aprobación masiva ➕ 2026-02-22 🛫 2026-02-22 📅 2026-02-23
  • Checkbox selección múltiple
  • “Validar Seleccionadas”
  • “Aprobar y Exportar a ORDEN”

3.7 Historial y Auditoría (RF07 + RF08)

• [5] Vistas históricas ➕ 2026-02-24 🛫 2026-02-24 📅 2026-02-26
  • Ver Historial de Cargues (fecha/hora, usuario, cantidad)
  • Ver Historial de Cambios por Voucher (campo, valor anterior, nuevo, usuario, fecha)
  • Filtros por rango fechas, usuario, empresa

---

Fase 4: Exportación e Integración

4.1 Excel Export (RF10)

• [5] Generador Excel 606 ➕ 2026-02-27 🛫 2026-02-27 📅 2026-02-28
  • GET /api/exportar/excel?empresa_id=X&mes=202601
  • Generar .xlsx formato 606 desde datos_extraidos
  • Botón “Descargar Excel” en frontend

4.2 ORDEN Integration (RF09 + RNF09)

• [13] Exportar a ORDEN ➕ 2026-03-01 🛫 2026-03-01 📅 2026-03-05
  • POST /api/exportar/orden
  • Validar empresa tiene orden_api_key configurada
  • Preparar payload JSON (gastos array formato ORDEN)
  • Llamar POST https://orden.app/api/prex/import-gastos
  • Headers: X-ORDEN-API-KEY
  • Reintentos automáticos (max 3) en caso de fallo
  • Actualizar datos_extraidos (exportado_orden=true)
  • Guardar en logs_exportacion (timestamp, cantidad, status)
  • Frontend: Modal conectar ORDEN + botón exportar
  • Meta: ≥95% exportación exitosa (RNF09)

4.3 Historial Exportación

• [3] Vista logs exportación ➕ 2026-03-06 🛫 2026-03-06 📅 2026-03-07
  • Tabla: fecha, destino (ORDEN/Excel), cantidad, estado
  • Ver detalles + reenviar si falló

---

Fase 5: Configuración y Planes

5.1 Config Empresa (RF11 + RF12)

• [5] Panel configuración ➕ 2026-03-08 🛫 2026-03-08 📅 2026-03-10
  • Tab General: nombre, RNC, plan, límite facturas
  • Tab Integraciones: ORDEN API Key + test conexión
  • Tab Usuarios: lista + agregar
  • Selector empresa activo (multi-empresa)
  • Selector ciclo fiscal (mes/año)

5.2 Control Planes (RNF05)

• [3] Lógica límites ➕ 2026-03-11 🛫 2026-03-11 📅 2026-03-12
  • Verificar límite al subir (Gratis: 50, Básico: 200, Premium: 1000)
  • Modal “Mejora tu plan”
  • Dashboard uso mensual (facturas procesadas vs límite)

---

Fase 6: Testing y Calibración

6.1 Dataset y Precisión (RNF01)

• [8] Testing OCR/IA ➕ 2026-03-13 🛫 2026-03-13 📅 2026-03-18
  • Recopilar dataset de prueba (50+ facturas variadas)
  • Crear ground truth manual (datos correctos)
  • Procesar con PREX
  • Calcular precisión por campo y global
  • Meta: ≥80% precisión (RNF01)
  • Ajustar prompt Claude API si <80%
  • Re-test hasta alcanzar meta

---

Fase 7: Deployment

7.1 Deploy y Seguridad (RNF02 + RNF04 + RNF06 + RNF08)

• [8] Setup producción ➕ 2026-03-19 🛫 2026-03-19 📅 2026-03-22
  • VPS/PaaS (DigitalOcean/Heroku/Railway)
  • PostgreSQL 14+
  • Nginx + SSL (Let’s Encrypt)
  • Deploy backend (Git + PM2/Gunicorn)
  • Deploy frontend (build + Nginx SPA)
  • Storage S3/Spaces para vouchers
  • Backups automáticos: BD diario, archivos semanal (RNF08)
  • Disponibilidad 99% horario 8am-6pm (RNF02)
  • HTTPS obligatorio + autenticación (RNF04)
  • Validar formatos PDF/JPG/PNG 10MB max (RNF06)
• [3] Test integración ORDEN ➕ 2026-03-23 🛫 2026-03-23 📅 2026-03-24
  • Probar exportación end-to-end
  • Validar payload con API ORDEN
  • Confirmar recepción exitosa

---

Fase 8: Monitoreo y Mejora Continua

8.1 Logging y Analítica (RNF07 + RNF10)

• [3] Sistema monitoreo ➕ 2026-03-25 🛫 2026-03-25 📅 2026-03-26
  • Winston/similar (error, warn, info, debug)
  • Dashboard interno: % facturas requieren corrección humana
  • Alertas email si errores >10%
  • Usabilidad: tiempo promedio validación por factura
  • Cumplimiento: 100% archivos válidos según DGII (RNF10)
• [2] Optimización continua ➕ 2026-03-27 🛫 2026-03-27 📅 2026-03-28
  • Revisar facturas fallidas semanalmente
  • Optimizar costos Claude API
  • Actualizar prompt según patrones de error

---

Resumen PREX

Fase	Enfoque	Duración
Fase 1	Base de Datos	x días
Fase 2	Backend API + OCR/IA	x semanas
Fase 3	Frontend completo	x semanas
Fase 4	Exportación ORDEN/Excel	x semana
Fase 5	Configuración y Planes	x días
Fase 6	Testing y Calibración	x días
Fase 7	Deployment	x días
Fase 8	Monitoreo	x días
TOTAL	Sistema PREX completo	~x semanas