diff --git a/docs/FASES_IMPLEMENTADAS.md b/docs/FASES_IMPLEMENTADAS.md index 0ef80a3..4219ed9 100644 --- a/docs/FASES_IMPLEMENTADAS.md +++ b/docs/FASES_IMPLEMENTADAS.md @@ -1,6 +1,6 @@ # Nexus POS — Resumen de Fases Implementadas -**Fecha:** 2026-04-28 +**Fecha:** 2026-04-26 **Versión DB:** v3.2 **Tests:** 73/73 pasando (pytest) @@ -123,7 +123,7 @@ | Nginx | — | 80/443 | ✅ gzip, cache 6M, auto-serve .min | | Gunicorn | — | 5001 | ✅ gthread, 4×4, max_requests=1000 | | Celery | — | — | ✅ 4 prefork workers, broker redis://localhost:6379/1 | -| Quart PoC | — | 5002 | ✅ hypercorn manual, no en producción | +| Quart async catalog | hypercorn | 5002 | ✅ systemd `nexus-quart.service`, nginx upstream `/pos/api/catalog/async-search` | --- @@ -163,44 +163,56 @@ METABASE_URL=http://localhost:3000 --- +## ✅ Completados recientemente + +| # | Mejora | Fecha | Commit | +|---|--------|-------|--------| +| — | **Particionar `vehicle_parts` en producción** | 2026-04-26 | `f24f25e` | +| — | **Quart async catalog en producción** | 2026-04-26 | `b829e4f` | +| — | **Arreglar `scripts/minify-assets.sh`** | 2026-04-26 | `b829e4f` | +| — | **Dashboard outage fix (env vars + static files)** | 2026-04-26 | `27cb4ee` | +| — | **IA por Voz (STT + TTS) en POS y Dashboard** | 2026-04-26 | `afb3b24` | +| — | **Fix chat.js null reference (`chatTtsToggle`)** | 2026-04-26 | — | +| — | **Optimizar PostgreSQL config** | 2026-04-26 | — | + +--- + ## Mejoras Pendientes (Roadmap Actualizado) ### 🔴 Crítico — Deuda Técnica | # | Mejora | Descripción | Bloqueo | |---|--------|-------------|---------| -| 1 | **Particionar `vehicle_parts` en producción** | Script `partition_vehicle_parts.py` listo. Ejecutar en staging primero, luego producción. Reduce 254 GB → particiones HASH 16. | Necesita ventana de mantenimiento | -| 2 | **Quart async catalog en producción** | PoC en puerto 5002 funciona. Integrar con nginx reverse proxy, migrar endpoints críticos. | Necesita hypercorn + monitoreo | -| 3 | **Arreglar `scripts/minify-assets.sh`** | Itera sobre `*.js`/`*.css` incluyendo `.min.*`, generando `.min.min.*`. Filtrar archivos ya minificados. | Riesgo de archivos corruptos en deploy | +| 1 | **PostgreSQL restart para aplicar config** | `shared_buffers=8GB`, `work_mem=64MB`, `max_wal_size=8GB` configurados. Requiere `systemctl restart postgresql` (downtime ~30s). | Ventana de mantenimiento | ### 🟠 Alto — Features de Negocio | # | Mejora | Descripción | Esfuerzo | |---|--------|-------------|----------| -| 4 | **WhatsApp Business API (Meta Cloud)** | Actualmente solo webhook Baileys. Migrar a Meta Cloud API para escalabilidad real. Requiere verificación de cuenta Meta. | 2-3 semanas | -| 5 | **BNPL real** | Integrar APLAZO/Kueski/Clip para "compra ahora, paga en 15/30 días". Ahora solo es stub. | 2 semanas | -| 6 | **ERP Sync real** | Conectar con Aspel/Contpaqi/SAP/Odoo vía API o archivos de intercambio. Ahora solo es stub. | 2-3 semanas | -| 7 | **Mercado Libre / Amazon sync** | Publicar inventario de bodegas en marketplaces. API de ML Seller + Amazon SP-API. | 3 semanas | -| 8 | **PWA mejorada** | Offline mode, install prompt, background sync para catálogo y carrito. | 1-2 semanas | +| 2 | **WhatsApp Business API (Meta Cloud)** | Actualmente solo webhook Baileys. Migrar a Meta Cloud API para escalabilidad real. Requiere verificación de cuenta Meta. | 2-3 semanas | +| 3 | **BNPL real** | Integrar APLAZO/Kueski/Clip para "compra ahora, paga en 15/30 días". Ahora solo es stub. | 2 semanas | +| 4 | **ERP Sync real** | Conectar con Aspel/Contpaqi/SAP/Odoo vía API o archivos de intercambio. Ahora solo es stub. | 2-3 semanas | +| 5 | **Mercado Libre / Amazon sync** | Publicar inventario de bodegas en marketplaces. API de ML Seller + Amazon SP-API. | 3 semanas | +| 6 | **PWA mejorada** | Offline mode, install prompt, background sync para catálogo y carrito. | 1-2 semanas | ### 🟡 Medio — Diferenciadores | # | Mejora | Descripción | Esfuerzo | |---|--------|-------------|----------| -| 9 | **App móvil nativa (Capacitor)** | Wrap del POS como app iOS/Android. Camera nativa, push notifications, biometrics. | 3-4 semanas | -| 10 | **Portal de proveedores** | Dashboard para que proveedores vean demanda por zona y tipo de parte. | 2 semanas | -| 11 | **Dashboard in-app** | Gráficos de rendimiento en tiempo real (ventas, productividad, conversión) en el POS. | 1-2 semanas | -| 12 | **Crédito basado en comportamiento** | Evaluación automática de línea de crédito por historial de pagos del cliente. | 2 semanas | -| 13 | **Programa de embajadores** | Referidos con recompensas, tracking de conversiones. | 1 semana | +| 7 | **App móvil nativa (Capacitor)** | Wrap del POS como app iOS/Android. Camera nativa, push notifications, biometrics. | 3-4 semanas | +| 8 | **Portal de proveedores** | Dashboard para que proveedores vean demanda por zona y tipo de parte. | 2 semanas | +| 9 | **Dashboard in-app** | Gráficos de rendimiento en tiempo real (ventas, productividad, conversión) en el POS. | 1-2 semanas | +| 10 | **Crédito basado en comportamiento** | Evaluación automática de línea de crédito por historial de pagos del cliente. | 2 semanas | +| 11 | **Programa de embajadores** | Referidos con recompensas, tracking de conversiones. | 1 semana | ### 🟢 Bajo — Polish | # | Mejora | Descripción | |---|--------|-------------| -| 14 | **Cache warming automatizado** | Agregar systemd timer/service para correr `warm_cache.py` diariamente (ahora es manual). | -| 15 | **Backup automatizado** | El último backup es del 27/04. Automatizar con cron + S3/GCS. | -| 16 | **Monitoreo/Alerting** | Prometheus/Grafana o similar para gunicorn, PostgreSQL, Redis, Celery. | -| 17 | **Tests de integración frontend** | Playwright/Cypress para flujos críticos (checkout, búsqueda, login). | +| 12 | **Cache warming automatizado** | Agregar systemd timer/service para correr `warm_cache.py` diariamente (ahora es manual). | +| 13 | **Backup automatizado** | Último backup 2026-04-27. Automatizar con cron + S3/GCS. | +| 14 | **Monitoreo/Alerting** | Prometheus/Grafana o similar para gunicorn, PostgreSQL, Redis, Celery. | +| 15 | **Tests de integración frontend** | Playwright/Cypress para flujos críticos (checkout, búsqueda, login). | ---