Hoseg Dashboard
- Registrado: 2026-08-29
- Cliente: Hoseg / 14 Diez SAC
- Fuente de datos: Odoo (API JSON-2, sandbox 19.2 + futuro sandbox 19.3) + BD propia para metas (Excel de Cindy → carga validada)
- Estado: ✅ EN PRODUCCIÓN — https://hoseg-dashboard.disoftx.solutions · Actualizado 2026-09-21: Venta Promociones ahora toma montos de Odoo (cuadra 100% con el Reporte de Ventas, NC neto), filtro global único (fecha/semana, semana nueva automática los lunes) y Corregir Promociones como pestaña dentro de Configuración (con catálogo y pestañas por punto de venta). Detalle completo abajo ⬇️.
- Repo: github.com/dannyelito/hoseg-dashboard (privado) · Deploy: Zeta →
/home/opsmgr/proyectos/hoseg-dashboard(docker compose build && up -d) - Acceso dashboard viejo: https://cvminiversiones.pe/hoseg/reportes (credenciales en
credentials/— gitignored)
📦 Módulos actuales (menú lateral, en orden)
| Menú | Endpoint | Notas |
|---|---|---|
| 📊 Reporte Diario | /api/reportes/diario |
KPIs + 4 charts + tablas diaria/mensual + ranking D2C |
| 🏷️ Venta por Categoría | /api/reportes/categorias |
Incluye fila "(sin categoría)" → cuadra con el Diario |
| 🧥 Venta por Modelos | /api/reportes/modelos |
Tablas por categoría |
| 🎯 Venta Promociones | /api/reportes/promociones |
Montos desde Odoo (iguales al Reporte de Ventas, con NC neto); el Excel solo aporta la etiqueta de promoción |
| 💹 Margen y Contribución | /api/reportes/margen |
3 vistas con fila TOTAL + banner de totales; JOIN de costos deduplicado |
| 📦 Valorizado de Inventario | /api/reportes/valorizado |
Categoría/talla/artículo + género |
| 📅 Registro por días | /api/reportes/registro-visitas |
Visitas Odoo |
| 📑 Reportes | /api/reportes/* |
Ventas · Inventario · Resumen Diario · Detallado · Comisiones (todos programables por correo + Excel) |
| ⚙️ Configuración | /api/config/* |
Puntos · Mapeo · Sin mapear · Metas · Costos · Usuarios (matriz de permisos) · ✏️ Corregir Promociones (pestaña para supervisoras) |
Permisos: src/menus.js (claves diario, categorias, modelos, promociones, margen, valorizado, registro, reportes, config); requireMenu en el backend (403 si no tiene el menú); el menú lateral se filtra por usuario. Roles: admin (todo + usuarios) y usuario (todo menos Configuración). (2026-09-21) el menú Configuración aparece si el usuario tiene permiso config o promociones; dentro de Configuración cada pestaña se muestra según permiso (las supervisoras solo ven Corregir Promociones).
📋 Análisis del dashboard antiguo (2026-08-29)
Stack: PHP + MySQL (sin framework), Bootstrap + jQuery + Chart.js, sesiones PHP, login simple, codificación latin-1. Host: cvminversiones.pe.
Módulos encontrados
- KPIs (resumen_cards.php): VENTA TOTAL NETA, CONVERSIÓN, CUMPLIMIENTO META
- Reporte Diario (reporte_diario.php) — EL CORAZÓN:
- 4 gráficos: Participación por Local (pie) · Venta Local 2026 vs 2025 (bar) · Venta Categoría 2026 vs 2025 (bar) · Evolución Venta Total Diaria (line)
- Tabla diaria por local: VISITAS, TICKETS, PROD., VTA SIN IGV, META (diaria), % ÉXITO, T. PROM, CONV.
- Tabla mensual por local: META MES, VTA 2025, VTA 2026, VAR %, % CUMPL, % PROY, T. PROM, CONV., P.E., %P.E.
- Canales: D2C (LARCOMAR, CUSCO, HOSEG WEB, MARRIOTT, MARRIOTT CUSCO, CASA HOSEG, AEROPUERTO, POP UP) · WHOLESALE (LIVINGSTONE, CUSCO CAFE, MORPHO PERU, MORPHO CHILE, CUSCO WHOLESALE) · OTROS (EXTERNOS DIGITAL)
- Ranking de vendedores: vendedor, venta total, % part.
- Venta por Categoría + desglose por POS + gráfico (CASACA 44%, CHALECO 20%, POLO 8% — jun 2026)
- Venta por Modelos (ANDEAN TEAL, HOODED PHANTOM, PLUM...)
- Margen y Contribución: por POS (venta, costo, contribución, margen %) · por categoría · por artículo
- Valorizado de Inventario (3 vistas): por categoría · por talla · por artículo — con Vta 6M, stock actual, meses de venta (rotación), valor stock; por género (HOMBRE/MUJER/UNISEX)
- Hoseg Proyectos (hoseg_proyectos.php): control de tareas por proyecto — CASA HOSEG (55%), CUSCO REGOCIJO (5%), POP UP HOSEG (20%) — tareas con responsable, cronograma, prioridad, status (Completado/En Fecha/En Riesgo/Retrasada), avance. Módulo SEPARADO de ventas.
Metas
- NO están en la web: Daniel las subía directo a MySQL desde Excel de Cindy (meta DIARIA por POS/canal; mensual = suma).
- En el reporte se ven como META (diaria) y META MES por local + P.E. (punto de equilibrio).
- En el nuevo: BD del dashboard + carga Excel validada (formato: Fecha, Punto de venta, Canal, Meta S/).
✅ Agosto + Setiembre 2026 cargados (2026-09-15)
- Fuente:
META_DIARIA.xlsxde Daniel (2 hojas: Agosto / Setiembre, matriz Tienda × días; col B = total mes, valores diarios ya distribuidos). - Script:
scripts/cargar_metas.js(parsea el xlsx →metas_diarias, fuente=excel, INSERT OR REPLACE). Backup previo:db/backup_pre_metas_20260915.db; xlsx archivado endb/metas/META_DIARIA_20260915.xlsx. - Resultado: 2026-08 = S/ 303,600.09 (228 filas/12 PV) · 2026-09 = S/ 285,941.34 (198 filas/12 PV). Reemplazó el placeholder de agosto (copia de julio, 455,700.62).
- Mapeo de nombres (Excel → BD): CUSCO PLAZA→008 CUSCO · MARRIOTT LIMA→043 MARRIOTT · MARRIOTT CUSCO→044 · LARCOMAR→004 · HOSEG WEB→025 · CORPORATIVO→104 (canal OTROS) · CASA HOSEG→048 · POP UP→998 · HOSEG CAFÉ→006 CUSCO CAFE · LIVINGSTONE→034 · MORPHO PERU→039 · ALGUIS→103.
- ⚠️ Pendiente por confirmar con Daniel: (1) HOSEG CAFÉ → CUSCO CAFE (asumido; coincide 4,000/mes del histórico) · (2) POP UP (998) y AEROPUERTO (035) están inactivos en el dashboard → sus metas no salen en reportes (POP UP = 16,800 ago / 18,900 sep) · (3) filas con 0/sin datos (MORPHO CHILE, APTO TBC→AEROPUERTO?, CUSCO WHOLESALE) no se cargaron · (4) el rótulo "D2C" de la hoja Setiembre (181,840) es un residuo: el real es 243,940.
Qué conservar / mejorar
Conservar: métricas diarias por local con meta, YoY 2025 vs 2026, cumplimiento mensual + proyección + P.E., ranking vendedores, venta por categoría/modelo con desglose por POS, margen y contribución, valorizado con rotación, control de proyectos.
Mejorar: stack moderno (React + API), validación de carga Excel, roles/permisos, diseño, respaldo histórico.
Riesgos: "visitas" no existe en Odoo (¿de dónde salen? → preguntar), histórico 2025 no está en Odoo (¿migrar?), meta diaria = data externa (BD propia), el módulo de proyectos quizá no tiene relación con Odoo.
Preguntas abiertas (para Daniel)
- [x] ¿De dónde salen VISITAS y TICKETS? → Web pequeña donde el personal registra visitas del día. Daniel dará acceso al código fuente para ver cálculo (ticket prom = ?visitas/ventas). PENDIENTE: recibir código + SQL.
- [x] Histórico: 2024, 2025 hasta 19-jul-2026 en MySQL (ERP viejo); desde 20-jul-2026 en Odoo. Comparativo YoY = capa histórica importada en BD del dashboard (Odoo no tendrá 2025).
- [x] Hoseg Proyectos (tareas) → NO va al nuevo dashboard (era para la migración a Odoo). DESCARTADO.
- [ ] ¿Quiénes usan el dashboard (roles)?
- [ ] SQL de metas, puntos de venta, visitas y ventas (estructura) — pedir a Daniel
Decisiones tomadas (2026-08-29 14:13)
- Comparativo YoY (2025 vs 2026): SÍ se puede. Odoo = data desde 20-jul-2026; histórico 2024→19-jul-2026 se importa del MySQL viejo a la BD del dashboard (capa histórica). El comparativo se calcula en el backend del dashboard, no en Odoo.
- Visitas: el personal registra visitas en una web pequeña; ticket promedio y conversión se calculaban en el código viejo. Daniel dará acceso al código fuente → replicar fórmula exacta.
- Hoseg Proyectos: NO va en el nuevo dashboard.
- Arquitectura (confirmada 14:19): HÍBRIDA con BD del dashboard como centro:
- MySQL viejo → importación ÚNICA (2024 → 19-jul-2026) a la BD del dashboard
- Odoo → sync periódico de solo lectura (ventas y stock cada 30 min; valorizado puede ser nocturno) a la BD del dashboard
- Metas (Excel) → carga mensual validada a la BD del dashboard
- Reportes se calculan SIEMPRE sobre la BD local (rápidos, YoY incluido). Odoo = fuente de verdad, sin escritura.
- Casos puntuales de tiempo real (ej: stock exacto ahora) pueden consultar Odoo en línea.
✅ Decisiones finales (2026-08-29 20:05)
- Stack: React + Node/Express + SQLite (mejor-sqlite3) — igual que FitSemana
- Repo:
dannyelito/hoseg-dashboard(privado) · Deploy: Zeta → hoseg-dashboard.disoftx.solutions - Categorías 2025 vs 2026: por ahora solo período actual; mapeo vieja→nueva después
- Visitas Odoo: modelo
x_registro_de_visitascreado y verificado por API ✓ (campos: x_name, x_studio_fecha, x_studio_company_id, x_studio_cantidad). Empresa autollenada por sucursal ✓. Defaults 'Visita' por compañía (multi-company). - Sync Odoo: incremental cada 30 min (ventas pos+sale, visitas, stock). Solo lectura. Reportes sobre BD local (rápido, YoY posible). Explicado a Daniel ✓.
- Fase 1 iniciada: README + .gitignore + db/schema.sql (punto_venta, pv_mapeo, ventas, visitas, metas_diarias, usuarios, sync_state)
✅ Fase 3 — Frontend React (2026-08-30)
- Frontend completo en
frontend/(Vite + React + recharts + react-router): - Login JWT · Layout con sidebar + botón "Sincronizar Odoo"
- Reporte Diario: rango fecha (default mes actual), 3 KPIs (venta total, conversión, cumplimiento), 4 charts (pie participación por local, barras local 2026 vs 2025, barras categoría 2026 vs 2025, línea evolución diaria), tabla diaria por local, tabla mensual (YoY, %cumpl, %proy, P.E.), ranking vendedores
- Categorías: chart + totales + desglose por POS · Modelos: tabla · Margen: tabs por PV/categoría/artículo
- Configuración: CRUD puntos de venta, CRUD mapeo Odoo, cola SIN MAPEAR con asignación en línea, metas (plantilla Excel + validar + commit)
- Fix sync (Fase 2.5): syncPos/syncSale ahora guardan
codigo_articulo=default_code ynombre_categoria(nivel superior de categoría Odoo, ej. CASACA de "CASACA / ALPAFILL") → categorías de agosto YA funcionan (CASACA S/29k, CHALECO S/17k...). Re-sync completo OK (pos 1,585 líneas, sale 408). - Verificado end-to-end vía proxy: login, reporte diario (kpis S/42,692.77 ago, 18 filas, 9 vendedores), categorías 16, margen 10 PV, plantilla Excel 89KB, sinmapear 83.
- Build:
npm run buildOK (612KB js / 172KB gzip). Commits 1811462 + 5e6f1cf. - Usuarios:
diturrizaga/cverde· clavehoseg2026@
✅ Fase 4 — Deploy PRODUCCIÓN (2026-08-30)
- URL: https://hoseg-dashboard.disoftx.solutions (wildcard DNS *.disoftx.solutions → 154.38.186.254, sin cambios DNS)
- Contenedor
hoseg-dashboarden Zeta: Dockerfile node:24-slim (node:sqlite builtin, sin deps nativas), red caddy_net, restart unless-stopped, env_file backend.env (ODOO creds, no va a git) - Backend sirve frontend/dist como SPA (express.static + fallback regex ^(?!\/api))
- Caddy site deploy/hoseg-dashboard.caddy con headers de seguridad (mismo patrón hoseg-cash)
- Verificado público: HTTPS 200 (SPA), login diturrizaga OK, reporte diario agosto S/42,592.86 (18 filas, 9 vendedores), consistente con instancia local
- Instancia dev de Omni (:3016) DETENIDA — Zeta es la única fuente
- Commits: feba565 (deploy) + f046cae (README)
- Actualizar: docker compose build && up -d + caddy reload
⏳ Pendientes post-deploy
- Conectar Odoo de PRODUCCIÓN real (2026-08-30): el dashboard sincroniza desde
hoseg-sandbox-193.odoo.com(instancia de pruebas, max pos.order id 779, sin ventas reales de tiendas — Cusco Plaza vendió S/2,400 hoy y NO aparece porque no está en el sandbox). Daniel confirmó que trabajamos con el sandbox. Pendiente: URL + API key del Odoo de producción (¿v19.2 SaaS?) para apuntar el sync a la fuente real. También confirmar si alguna tienda aún usa el sistema viejo (cvminversiones.pe). - Deploy Zeta:
hoseg-dashboard.disoftx.solutions(systemd + Caddy, servir frontend/dist) - Modelos (Odoo): vacío — definir mapeo de "modelo" (atributos de producto vs nombre del ERP viejo)
- Valorizado de inventario: requiere sync de stock (cantidad) desde Odoo
- Costos: solo 261 productos con standard_price → cargar costos en Odoo para margen completo
📝 Bitácora sesión 2026-08-30 — avance completo del frontend (revisado con Daniel)
Aprobado por Daniel (frontend OK, resta validar data con Odoo producción)
- Reporte Diario ✅ — KPIs (Venta total, Conversión, Cumplimiento, Ticket Promedio) centrados; gráficas estilo anterior (pie con %, barras 2026 morado/2025 fucsia, etiquetas de variación sobre barras, sin montos en eje Y); evolución diaria a ancho completo; tablas diaria/mensual agrupadas por canal (D2C/WHOLESALE/OTROS) sin columna Canal, con subtotales por canal y TOTAL; columna PROD; ranking de vendedores SOLO retail D2C.
- Venta por Categoría ✅ — gráfico Top 10 vs Otros (categorías fijas: CASACA, CHALECO, POLO, CAMISA, HOODIE, GORRA, SWEATSHIRT, MEDIAS, SOUVENIR, PANTALÓN + OTROS) primero a ancho completo; luego tablas Consolidado (todos los PV) y Participación; después Desglose con una tabla por PV D2C. Todas con Categoría/Unidades/Venta/%Part + TOTAL.
- Venta por Modelos ✅ — tablas separadas por categoría (Modelo/Unidades/Venta/%Part + TOTAL). 124 modelos / 16 categorías con data sandbox.
- Margen y Contribución ✅ — pestaña Por Punto de Venta agrupada por canal con subtotales y TOTAL CONSOLIDADO (Venta S/. · Costo · Contribución · Margen %); pestañas Por Categoría y Por Artículo.
- Valorizado de Inventario (nuevo módulo) — tabs Por Categoría / Por Talla / Por Artículo + filtro género; Vta 6M, stock, meses de venta (rotación), valor stock.
Fijaciones transversales
- Montos y porcentajes SIN decimales en todo el dashboard; ventas con prefijo S/ en tablas.
- Cabeceras de tabla centradas desde 2da columna (1ra a la izquierda); números centrados.
- Logo Hoseg (versión blanca sidebar + roja login); menú hamburguesa (collapsible desktop / drawer móvil); responsive móvil (KPIs 2×2, gráficas 1 col, tablas scroll).
- Bug fix: página en blanco por import faltante de LabelList.
Hallazgos de DATA (para validar con Odoo producción)
- Patricia Medina S/121k falso: era el user_id de Odoo que digita las OCs wholesale (220 de ~290 órdenes) → todo OECHSLE (S/101,237) caía a su nombre. Fix: ranking solo retail (D2C) → quedó en S/19,142 real.
- Venta negativa agosto: el sync Odoo escribe comprobante 'BOLETA' (singular) pero la fórmula solo aceptaba 'BOLETAS' (plural del ERP viejo) → las boletas se restaban. Fix: aceptar ambos.
- Categorías vacías en Odoo: sync ahora guarda nombre_categoria (nivel superior de categoría Odoo, ej. CASACA de "CASACA / ALPAFILL").
- CORPORATIVO = EXTERNOS DIGITAL: fusionados (036→104, 430 ventas históricas S/541,969 preservadas); CORPORATIVO en canal OTROS.
- Modelos vacíos en Odoo: resuelto leyendo atributos de producto (Talla 7, Género 2, Modelo 16 vía product.template.attribute.value) + backfill a ventas.
Infraestructura (Zeta)
- Contenedor
hoseg-dashboard(node:24-slim, caddy_net, restart unless-stopped, env_file backend.env). - ⚠️ FIX CRÍTICO: la BD estaba dentro de la imagen y se perdía en cada rebuild → ahora volumen persistente
./db:/app/db. - Caddy site con headers de seguridad; DNS wildcard *.disoftx.solutions → 154.38.186.254 (sin cambios DNS).
- Actualizar:
docker compose build && docker compose up -den /home/opsmgr/proyectos/hoseg-dashboard (+caddy reload solo si cambia el site). - Instancia dev de Omni :3016 DETENIDA.
GitHub
- Repo creado: github.com/dannyelito/hoseg-dashboard (privado, 27 commits, rama master). Usuarios/credenciales en backend.env (no versionado).
Pendientes (post-sesión)
- Conectar Odoo de PRODUCCIÓN (URL + API key) — el dashboard sincroniza del sandbox (hoseg-sandbox-193.odoo.com, max pos.order 779, datos de prueba). Sin esto, las ventas reales de tiendas no aparecen.
- Cargar costos en Odoo (solo 261 productos con standard_price) → margen y valorizado parciales.
- Registrar visitas en Odoo (x_registro_de_visitas) → conversión real (hoy 129% por falta de visitas).
- Módulo Hoseg Proyectos (descartado del alcance original; no va).
📑 Módulo REPORTES — 3 reportes en producción (2026-09-08) ⭐
Menú lateral "Reportes" (📑) → índice con tarjetas (dinámico desde GET /api/reportes/catalogo). Programación de envío por reporte con botón (frecuencia diario/semanal/mensual + hora + destinatarios + Editar/Eliminar/Enviar ahora). Scheduler interno cada 60s en horario Perú (UTC−5 explícito). Tablas BD: reportes_programados (+col parametros JSON), envios_log.
1) Reporte de Ventas (/reportes/ventas) — key ventas
- Detalle línea por línea desde Odoo producción en línea (réplica byte a byte del script Python
reporte_ventas_hoseg_excel.py, validado 473/473 filas idénticas). BD local NO tiene marca/costo/notas/método pago → se lee Odoo directo. - Columnas: Fecha, N° Semana (ISO lunes), Mes (mmmm español), Orden, Local, Variante, Cliente, Almacén, Vendedor, Equipo, Empresa, Cant, Subtotal, P.unit, Total, Estado, Lista precios, Estado factura, Categoría odoo, SKU, Orden2, Género/Marca/Talla/Modelo, Empleado, Recibo/Factura, Método pago, COSTO, Notas producto, Notas pedido. (31 cols)
- Caché 10 min. Export Excel (exceljs, header E22B4F, freeze A2, autofilter).
2) Reporte de Inventario (/reportes/inventario) — key inventario
- Solo conteo (Daniel quitó Costo Unit./Valor Stock 2026-09-08). 11 columnas: Almacén|SKU|Producto|Categoría|Modelo|Género|Talla|Marca|Cantidad|Reservada|Disponible. Disponible=Cant−Res.
- Lee Odoo en línea (stock.quant por location
{code}/Existencias; atributos incl. Marca/manufacturer). Sucursales 100% dinámicas de stock.warehouse (hoy 10: CASA HOSEG, CUSCO PLAZA, MARRIOTT CUSCO/LIMA, LARCOMAR, HOSEG WEB/CAFE, WH, CTI, Agente Logístico) → sucursales futuras aparecen solas. Caché 5 min. - Programación lleva
parametros.sucursal_id→ cada supervisora recibe su tienda (hoy prueba a daniel@disoftx.solutions). - ⚠️ A validar con Daniel: ¿"TODAS" debe ser solo retail o incluir WH/CAFE/WEB/CTI? ¿cargar costos Odoo (hoy standard_price=0 en muchos)?
3) Resumen de Ventas Diarias (/reportes/resumen-diario) — key resumen_diario
- Lee BD local (rápido). PV D2C activos dinámicos (7 hoy: MARRIOTT, CUSCO, MARRIOTT CUSCO, LARCOMAR, CASA HOSEG, HOSEG WEB, POP UP).
- KPIs: venta total, tickets, ticket prom, var % vs período anterior (día/semana/mes previo corrido). Tabla por tienda con %part y var ▲/▼. HTML responsive (correo) + texto plano (WhatsApp) + Excel adjunto.
- Formatos aprobados por Daniel (2026-09-08): correo = diseño a color; WhatsApp/celular = texto con emojis (📊💰🧾🏬 •).
parametros.desplazamiento_diasen diario: 0=hoy (envíos nocturnos 22:30), -1=ayer (default, matutino).
Infra SMTP y caché SPA
- SMTP Mailu Zeta: host mail.disoftx.solutions:465 SSL (NO IP → error cert), user nexus@disoftx.solutions (pass en credentials/mailu-zeta.json). Vars SMTP_* en backend.env de Zeta.
- Firma correos: "Nexus · Asistente virtual de Disoftx Solutions — disoftx.solutions".
- Fix caché (2026-09-08): index.html con
Cache-Control: no-store(servido por lectura directa) → navegador siempre toma bundle nuevo (evita rutas viejas → redirect al home). - ⚠️ Deploy: Zeta NO es repo git → rsync por subdirectorios (backend/ y frontend/ por separado, SIN
--deleteen la raíz) +docker compose up -d --build. Lección 08/09: rsync con trailing slash + --delete aplanó la estructura (backup en backup_hoseg_predeploy_20260908/).
4) Reporte Detallado Mensual (/reportes/detallado) — key detallado ⭐ (2026-09-09)
- Qué es: réplica ACTUALIZADA del Excel mensual del ERP viejo (
2._B2C_-_REPORTE_DETALLADO_JUNIO_2026, formato B2C retail). Daniel lo usa como modelo; el reporte real es mensual (agosto fue el primero, desde Odoo). Es para gerencia → el Excel debe verse profesional (sin logo; identidad por color). - Alcance: SOLO retail D2C (6 tiendas fijas): CUSCO PLAZA (008), MARRIOTT (043), MARRIOTT CUSCO (044), LARCOMAR (004), CASA HOSEG (048), HOSEG WEB (025). Excluye wholesale (LIVINGSTONE/MORPHO/OECHSLE) y OTROS (EXTERNOS DIGITAL/CORPORATIVO/PRINCIPAL/B2B). OJO: el Excel viejo sumaba 158,495.16 incluyendo wholesale; D2C puro junio = 150,256.41.
- Fuente: BD local (histórico ERP viejo + Odoo sync). Reglas validadas: BOLETAS/BOLETA/FACTURA suman, NC resta, estados Aceptado/Registrado, excluir
COALESCE(codigo_articulo,'')<>'00000001', USD×3.70, hora Perú. Con IGV = sin × 1.18 (criterio Excel viejo). - Backend:
reporteDetallado.js(detalladoMensual(mes)),detalladoExcel.js(xlsx multi-hoja), rutas enroutes/reportes.js. Comparativo vs mes anterior (agosto vs julio) agregado sin romper contrato frontend (kpis.prev_venta/var_pct, filas.prev_val/var_pct). - Costos — tabla propia
costos(default_code PK, nombre, costo, fuente, updated_at): precargada desdedb/costos_data_lista_jun2026.csv(Data Lista Excel viejo: 1,037 filas, 1,004 con costo, fuente='data_lista'); seed en db.js si vacía. CRUD + importar Excel/CSV + plantilla +faltantes?mes=(SKUs vendidos sin costo). Margen: costo tabla → fallback productos.standard_price (Odoo) → 0. ⚠️ Odoo standard_price incompleto (~261 prod) → tabla local es el puente; a futuro completar Odoo. - Excel 10 hojas (formato profesional, rediseñado 2026-09-09): 1) Resumen Ejecutivo (6 KPIs tarjetas + tabla por tienda con VAR vs mes ant. verde/rojo + Top 5 productos) · 2) Ventas Netas · 3) Transacciones Netas · 4) Por Categorías (pivot×6 tiendas) · 5) Por Género · 6) Por Producto (top100+%acum) · 7) Por Talla · 8) Por Vendedor · 9) Margen por Tienda · 10) DATA (detalle). Plantilla: banda #E22B4F "HOSEG · REPORTE DETALLADO MENSUAL" + título + subtítulo mes/criterios + tabla header rojo/filas alternadas/total #FDF0F2 + nota pie. Moneda
S/ #,##0.00. - Frontend:
ReporteDetallado.jsx(selector mes, KPIs, tabs, export Excel, programación, gestión costos). Vista web quedó funcional simple; solo el Excel fue criticado ("muy sencillo") y ya rediseñado. - Programación mensual: asunto
Reporte Detallado Hoseg — {Mes Año}, xlsx adjunto. Programación id 5 (mensual día 1 08:00, daniel@disoftx.solutions) — confirmar día/hora con Daniel.
Validación montos (verificada): local BD ~29/08: agosto 129,888.46 · PRODUCCIÓN (mes completo): agosto = S/ 140,449.43 sin IGV → 165,730.33 con IGV · 1,410 und · 612 tkts. Tiendas: CUSCO 44,334.85 · CASA HOSEG 23,709.65 · MARRIOTT CUSCO 23,551.24 · HOSEG WEB 19,412.24 · MARRIOTT 17,128.22 · LARCOMAR 12,313.23 (suma exacta). Junio cuadra al centavo con Excel viejo D2C 150,256.41. Var ago vs jul: −22.1% (julio distorsionado por migración ERP→Odoo 20/07 — validar base si Daniel lo cuestiona).
⚠️ Pendientes Reporte Detallado:
- Feedback de Daniel sobre Excel rediseñado (enviado 09/09 WhatsApp tmp_hoseg/Hoseg_Reporte_Detallado_Agosto_2026.xlsx + correo programación 5). Aún NO convence del todo — revisará mañana.
- 55 SKUs AW2026 vendidos en agosto SIN costo (no estaban en Data Lista junio) → pedir Data Lista actualizado o cargar manual.
- Comparativo: evaluar base justa (julio tiene corte migración 20/07).
- Archivos de referencia: SPEC_DETALLADO.md y SPEC_EXCEL_PRO.md en repo.
🔧 Exclusión de SKU de no-venta — delivery/estampado/reparaciones (2026-09-09) ⭐
- Motivo: Daniel actualizó en Odoo producción los default_code de SERVICIO DE ESTAMPADO (ESTAMPADO_008/009) y SERVICIO DE REPARACIÓN (REPARACIONES_010) para poder filtrarlos de los reportes (no son venta de producto). Delivery ya se excluía solo como 00000001 (ERP viejo); en Odoo es Delivery_007 (Standard delivery) + cajas C0000002/C0000006.
- Implementación: nuevo
backend/src/excluidos.jsconSKUS_NO_VENTA+ fragmento SQLsinServicios(alias)(por SKU + fallback nombre'SERVICIO DE %'para líneas Odoo viejas sin SKU). Reemplaza el filtro viejo<>'00000001'en reportes.js (diario/categorías/modelos/margen/valorizado), reporteDetallado.js, resumenDiario.js y routes/reportes.js (faltantes). Commit a240c5c. - Lista: ERP viejo: 00000001, 000000002, 00000015, S0000025, 99999999 · Odoo: Delivery_007, C0000002, C0000006, ESTAMPADO_008, ESTAMPADO_009, REPARACIONES_010.
- Re-sync completo (reset sync_state ventas_pos/sale → restart contenedor): líneas Odoo viejas ahora llevan los códigos nuevos (0 líneas servicio sin SKU). Backup BD pre-cambio:
db/backup_pre_sku_excl_20260909.dben Zeta. - Impacto agosto (D2C retail): 140,449.43 → 139,312.38 sin IGV (−1,137.05: delivery −1,052.31 neto en HOSEG WEB/LARCOMAR + reparación −84.74 en CASA HOSEG/LARCOMAR) · 1,410 → 1,332 und · 612 → 608 tkts · con IGV 164,388.61. Sept 1-9: 30,150.70 sin IGV.
- Mantener: si Daniel agrega/cambia un SKU de servicio en Odoo → agregarlo a
excluidos.js+ redeploy + re-sync. Estampado facturado está en PV 104 CORPORATIVO (fuera del detallado D2C).
🧾 Auditoría data de Cindy vs dashboard (2026-09-09)
- Daniel comparó su export Odoo de agosto vs la hoja DATA del detallado: no cuadraban montos ni unidades.
- Δ total S/315.70 (0.23%), 100% explicada — la data del dashboard coincide con Odoo:
- S00127 y S00128 (web) duplicados en la data de Cindy (+S/442.40, +3 und): cada línea aparece 2 veces; Odoo tiene 1 factura y 1 unidad por línea (verificado
account.move+sale.order.line). - CUSCO PLAZA - 000181 falta en la data de Cindy (−S/126.70, −1 und): en Odoo existe (19/08, done, CAMISA EXPLORER MANGA LARGA UV, 50% dscto). 442.40 − 126.70 = 315.70 exacto.
- Sin efecto en montos: regalo 100% dscto (MARRIOTT CUSCO-000047 CHALECO 10001133, S/0) = 1 und en Nexus y 0 en Cindy; etiquetas de SKU distintas en 000115 (Cindy 10002868 vs Odoo 10002722) y 000051 (Cindy asigna SKU a POLO COMFY que en Odoo no tienen); 45 líneas vacías de Odoo (sin producto, 0 und, S/0) que el DATA lista y Cindy descarta (1418 vs 1369 líneas).
- Informe:
tmp_hoseg/Auditoria_Cindy_vs_Nexus_Agosto2026.xlsx(Resumen · Diferencias · Por tienda).
Pendientes (2026-09-08/09)
- Prueba única 22:30 (resumen día 08/09) a daniel@disoftx.solutions por correo + WhatsApp (programación #4 auto-eliminable; cron Nexus 22:30/22:35). ⚠️ Confirmar limpieza de #4 y si Daniel aprueba envío diario 22:30 fijo.
- Daniel definirá número/hora fijos para el resumen (WhatsApp a supervisoras = requiere API Meta de pago; a Daniel = vía Nexus sin costo).
- Correos de supervisoras de inventario (Daniel los agrega desde la web tras validar).
- Costos Odoo (para Valorizado/Margen completos; inventario ya no los usa).
🔧 Fix descuadre Reporte Diario vs Venta por Categoría (2026-09-09)
- Síntoma: Diario (todas las ventas) ≠ Consolidado de Categorías (por diseño excluía líneas sin categoría).
- Fix:
ventaCategoriay el chart de categorías dereportes.jsagrupan NULL/vacío como '(sin categoría)' → consolidado siempre cuadra con el Reporte Diario (septiembre y agosto Δ=0). sync.js: backfill denombre_categoria(los cambios de categoría en Odoo se propagan en el sync de 30 min sin re-sync completo) + se ignoran líneas de sección/nota (display_type) y sin producto con 0 monto.- Pendiente data: categorizar en Odoo los 20 SKUs B2B de agosto (CASACA B2B ALPAFULL CUSQUEÑA, GORRA B2B TRUCKER, POLO B2B MP/P12A) + TRAVEL ORGANIZER 10002749. BOLSA 250GR quedó en 'Food'.
🔧 Fix Margen y Contribución: totales (2026-09-09)
- Síntoma: Por Punto de Venta daba S/67,634 vs S/68,056.87 del Diario (no cuadraba).
- Causa: JOIN a
productospordefault_codemultiplicaba líneas con SKUs duplicados en la tabla (ej. SKU 10001879 ×2 → NC de −423.31 en HOSEG WEB contada dos veces). - Fix: subconsulta dedup
(SELECT default_code, MAX(standard_price) ... GROUP BY default_code); Por Categoría con '(sin categoría)'; Por Artículo sin LIMIT y un renglón por SKU; filas TOTAL en el frontend (Margen.jsx) para las 3 vistas. - Verificado: septiembre y agosto Δ=0 en las 3 vistas vs Reporte Diario. Nota:
productospuede tener default_code duplicado (SKUs repetidos en Odoo) → cualquier JOIN nuevo debe deduplicar.
📊 Reporte de Comisiones (2026-09-09) — nuevo
- Ubicación: menú Reportes → tarjeta "Reporte de Comisiones" (
/reportes/comisiones). BackendreporteComisiones.js; programable (diario/semanal/mensual) y exportable a Excel. - Bloques: pivot Local→Vendedor con Comisión calculada (1.5% si el local ≥50% de su meta; Patricia Medina y Valeria Gutierrez "No Comisiona" por venta), tabla de metas por local (metas_diarias del rango) y cuadro de comisión de supervisoras (≥110% 1.25% · ≥100% 1% · ≥90% 0.75% · ≥80% 0.5% · menos No Comisiona). Patricia → CASA HOSEG/LARCOMAR/MARRIOTT; Valeria → CUSCO PLAZA/MARRIOTT CUSCO.
- ⚠️ Puntos a confirmar con Daniel: metas del dashboard 25% arriba de su captura; su fórmula usa ($L$3 = meta CASA HOSEG) fija para todos los locales; los montos de su captura no cuadran con Odoo; variantes de nombre del histórico (VALERIA MEDINA / VALERIA NICOLE MEDINA SOTO).
👤 Usuarios y permisos por menú (2026-09-09) — nuevo
- Configuración → pestaña Usuarios (solo rol admin): crear / editar / desactivar (reactivable) usuarios + matriz de checks por menú (se guarda al instante). Roles:
admin(todos los menús) yusuario(todos menos Configuración) como preset; los checks son individuales. - Backend:
menus.js(claves: diario, categorias, modelos, margen, valorizado, registro, reportes, config), columnausuarios.permisos(JSON), login devuelve permisos, middlewarerequireMenuen cada módulo (403 si no tiene permiso) y/api/config/*exige el menú config; el CRUD de usuarios exige rol admin.authrecarga el usuario de la BD → si lo desactivan, la sesión se corta. - Usuarios: diturrizaga (Daniel), cverde (Cindy), msantos (Mariale Santos), spareja (Sandy Pareja), ilanda (Ivonne Landa) → admin; pmedina (Patricia Medina), vgutierrez (Valeria Gutierrez) → usuario sin Configuración. Clave inicial de los nuevos:
hoseg2026@. - Crear usuarios también por API:
POST /api/config/usuarios {nombre, correo, rol, password, permisos[]}.
📱 PENDIENTE — App móvil del Hoseg Dashboard (Android + iOS, distribución PRIVADA)
Registrado: 2026-09-10 (idea de Daniel)
Estado: 🟡 Evaluación previa hecha (2026-09-15) → ver doc completo: wiki/proyectos/hoseg-dashboard-app-movil.md (enfoques, distribución privada, prerrequisitos, decisiones de diseño, estructura, riesgos, fases). Pendiente: cerrar decisiones con Daniel y arrancar Fase 0.
Objetivo: Llevar el dashboard a una app nativa Android + iOS, publicada en Play Store y App Store pero en modo privado: que NO sea descubrible y solo se pueda instalar compartiendo un link.
Cómo se hace (mecanismos por tienda)
- Android (Play): pista cerrada (closed testing) o interna (internal testing) → link de opt-in + whitelist de correos; no aparece en búsqueda pública. Máx. 100 testers por pista interna. No requiere los 12 testers/14 días (eso solo es para publicar a Producción).
- Alternativa empresa: Managed Google Play – app privada (solo dispositivos gestionados).
- iOS (App Store): Unlisted App Distribution → la app está en la App Store y pasa revisión, pero no es descubrible; solo se instala con link directo. Se solicita en App Store Connect (formulario: motivo, audiencia, regiones) y, una vez aprobada, es permanente (no se puede volver a pública). ⚠️ Cualquiera con el link puede instalar → mantener login en la app (ya existe).
- Alternativas: Apple Business Manager (custom app, solo organizaciones) o TestFlight (link, hasta 10k, expira cada 90 días).
Requisitos / costos / riesgos
- Cuentas: Google Play $25 (ya pagada 2026-09-06, cuenta personal) · Apple Developer Program $99/año (obligatorio para iOS).
- ⚠️ Riesgo de revisión (clave): Apple (guía 4.2 minimum functionality) rechaza apps que son “solo una web empaquetada”. El dashboard es web → hay que agregar valor nativo antes de enviar: notificaciones push (ej. Reporte Diario), gráficos nativos, biometría/PIN, compartir reportes, modo offline, etc. Google Play tiene una política similar (más laxa).
- Build iOS: requiere Mac/Xcode o nube → reutilizar Codemagic (ya usado en Fideliza).
- Enfoque recomendado: envolver con Capacitor (mismo stack que Fideliza/Hoseg Cash) + 2-3 features nativos.
- Plan B si Apple rechaza: TestFlight o instalarlo como PWA (Add to Home Screen) mientras.
- Mantenimiento: Apple exige SDKs recientes (desde abr-2026: Xcode 26 / iOS 26+).
Pasos propuestos (cuando se retome)
- Decidir stack (Capacitor sobre el frontend React actual) y features nativos mínimos.
- Crear cuenta Apple Developer + registrar la app en App Store Connect.
- Generar builds (Android AAB + iOS IPA) con Codemagic.
- Android → pista cerrada con los correos de Hoseg/Cindy. iOS → solicitar unlisted y compartir link.
- Documentar aquí el link privado y los correos autorizados.
🔧 Fix "Notas por producto" / "Notas del pedido" en el Reporte de Ventas (2026-09-10)
- Síntoma reportado por Daniel: la columna "Notas por producto" del Reporte Detallado salía literalmente
Falseen casi todas las filas. - Causa raíz: se mapeaba a
product.product.description_sale(descripción de venta del producto) — campo vacío en las 3,852 fichas de producto →limpia(false)devolvía la cadena'False'. La columna estaba mal desde el origen (también en el script Python de referencia). - Dato correcto: los cajeros registran la nota en
pos.order.line.note("Product Note"), poblada desde los Modelos de nota de Odoo (Punto de Venta → Configuración → Modelos de nota). Modelos configurados:Wait,Promo AlpaFill 2x1,pack de polos,Emergency,No Dressing. - Formato: Odoo guarda las notas como JSON del widget:
[{"text":"REF 4013","colorIndex":0}]. Se agregó el helpernotaTexto()que parsea el JSON → texto limpio (REF 4013/A | B) y devuelve''si vienefalseo'[]'. - "Notas del pedido": ya usaba el campo correcto (
pos.order.internal_note;general_customer_noteestá siempre vacío) pero mostraba el JSON crudo → ahora también pasa pornotaTexto(). - Pedidos de venta (SO/OC): no tienen nota por línea en Odoo → "Notas por producto" queda vacío.
- Verificado en producción (2026-09-10): agosto 2026 → 34 líneas con nota de producto y 79 filas con nota de pedido, mostrando texto limpio (antes: 2,535 de 2,631 filas con "False").
- Nota: solo ~1% de las líneas trae nota de producto → los Modelos de nota casi no se están usando en tienda (capacitación pendiente con los cajeros).
- Archivos:
backend/src/odooReporteVentas.js(+scripts/reporte_ventas_hoseg_excel.pyen el repo Nexus). Commit dashboard9549f80.
📊 Sesión 2026-09-13 — Resumen Diario, Valorizado y aviso por WhatsApp ⭐
1) Resumen de Ventas Diarias (reporte resumen_diario)
Pedidos de Daniel, todos en producción ✅ (commit b36644e, pusheado):
- Card "Tiendas con Venta" → "Venta Histórica": ahora muestra la venta del mismo día del año anterior (detalle: Venta del DD/MM/AAAA), calculada con anioAnterior() (mismo rango −1 año, contempla 29-feb).
- Columna "VAR. VS DÍA ANT." (antes "VAR. VS ANT.") + columna nueva "VAR. VS AÑO ANT." (email, web y Excel).
- Excel adjunto con 2 hojas (xlsxMultiHoja() en reportesExcel.js): hoja 1 Resumen (con Vta. año ant. y Var. vs año ant.) + hoja 2 Ventas DD/MM–DD/MM (detalle línea a línea: Fecha · PV · Comprobante · N° · Cliente · SKU · Artículo · Vendedor · Cantidad · Venta + TOTAL).
- Destinatarios: la programación id 4 (diario 22:30, hora Perú, desplazamiento 0) envía a daniel@disoftx.solutions + cindy@socialheater.com.
- UX programaciones: el campo Destinatarios quedó sin valor por defecto con placeholder genérico (correo1@empresa.com, correo2@empresa.com), aviso en el modal de que crea una programación nueva y que las existentes se editan/desactivan en la lista del reporte. Login: placeholder tu usuario.
- Aclaración importante: el dashboard solo envía por CORREO (scheduler interno → emailer.enviarCorreo con adjunto xlsx). No existe envío por WhatsApp desde el dashboard (verificado en git: nunca lo tuvo; la prueba del 08/09 fue con un cron de Nexus).
2) Valorizado de Inventario (reporte valorizado)
- Vta 6M en UNIDADES (no soles) — bug corregido:
VTA_CANT = SUM(CASE WHEN ES_VENTA THEN cantidad_venta ELSE -cantidad_venta END)(unidades netas, las NC restan).meses_venta = stock × días ÷ (30 × unidades). - Columna "Cobertura" ELIMINADA: su fórmula (
stock ÷ meses_venta) devolvía el consumo mensual (und/mes), no meses de cobertura; y "cobertura en meses" sería idéntica a "Meses venta". - Rotación por días de vida: ventana 180 días móviles (
ROT_DIAS_VENTANA); divisor = días desde la PRIMERA VENTA registrada del artículo, topado a 180 y con piso de 30 días (ROT_DIAS_MIN). Campos nuevos:dias_vida,parametros_rotacionynota(explicación del cálculo, pedida por Daniel) → se muestra al pie del reporte; los artículos con <180 días llevan*(base parcial). Referencia: el dashboard viejo usaba el mismo esquema con piso de 0.1 meses (3 días) → nosotros somos más conservadores. - Vista jerárquica + semáforo (réplica del dashboard viejo, cuyo código PHP quedó en
/tmp/dashboard-antiguo-hoseg/): - Semáforo Meses Vta: 🔴 > 6 = exceso de stock (
#dc3545) · 🟢 3,5 – 6 = normal (#198754) · 🟡 < 3,5 = rotación rápida (#ffc107). Vienen del backend ensemaforo {exceso_meses, bajo_meses}. - Jerarquía expandible de 5 niveles: Categoría › Artículo › Modelo › Género › Talla (definida en
NIVELES_JERARQUIA). El backend arma un árbol genérico recursivo (aNodo) con agregados y%part/%valorpor nivel; el frontend lo pinta conFilaNodo(recursivo) con ▸/▾ por fila y botón Expandir/Contraer todo. - Filtro de Género ahora va por API (
GET /api/reportes/valorizado?...&genero=MUJER): filtra las filas antes de armar el árbol y los % se recalculan sobre el subconjunto. - Estilos: categoría en lavanda suave
#f6f3fccon texto#4a3580(antes lila fuerte#6339C3), artículo#f9fafc, modelo/género/talla en blanco; clases.fila-cat/.fila-art/.fila-mod/.fila-gen/.fila-talla/.fila-total-jenstyles.css. - Hover arreglado: la regla global
table.tbl tr:hover tdpintaba la celda de claro dejando el texto blanco ilegible → cada nivel tiene ahora su propio hover (mismo tono, texto siempre legible). - Columna "Ingreso stock" (2026-09-15): fecha de entrada del stock actual desde Odoo
stock.quant.in_date. Se sincroniza ensync/sync.js → syncStockFechas()(corre al final desyncProductos, cada 30 min) → columnas nuevas enproductos:stock_in_date(in_date más antiguo de los quants internos con existencias = antigüedad del stock) ystock_in_date_max(último ingreso). En el reporte/UI se muestra la más antigua y el tooltip da el último ingreso; en grupos/jerarquía el nodo toma el mín (y máx) de sus hijos. ⚠️ Si el stock vino de una carga inicial de inventario (Odoo 02-jul-2026), esa es la fecha que aparece (no la de compra); para compra real usarstock.move/purchase.order.line. Migración idempotente endb.js(ALTER TABLE productos).
3) 📲 Aviso de VENTAS DEL DÍA por WhatsApp (cron de Nexus) — NUEVO
- Pedido: notificación corta al WhatsApp de Daniel con solo las ventas del día (no el reporte completo ni Excel).
- Vía elegida (sin costo): cron de Nexus que consulta el API del dashboard y manda un texto. (La alternativa — WhatsApp desde el dashboard — requiere la API de Meta de pago con plantillas aprobadas; descartada.)
- Script:
scripts/hoseg_ventas_wa.py(modo 600) → loginPOST /api/auth/login+GET /api/reportes/resumen-diario?f_inicio=<hoy>&f_fin=<hoy>; imprime: fecha, total S/, tkts, und, tkt prom, var vs día anterior, var vs año anterior y desglose por tienda (solo tiendas con venta > 0). Acepta fecha opcional (argv[1]). - Cron:
hoseg-ventas-wa-2230· idabd0e349-fa88-4700-af48-9f1c041720e1·30 22 * * *tz America/Lima · isolated · delivery announce → whatsapp +51999923033. - Destinatarios: Daniel (+51999923033) y Cindy (+51986370707) — Cindy agregada a pedido de Daniel el 13/09 22:35 (aplica desde la corrida del 14/09). El envío es el mismo texto exacto para ambos.
- Formato del aviso:
```
📊 VENTAS HOSEG — DD/MM/AAAA
Total: S/ X.XXX · N tkts · N und · tkt prom S/ N
vs día anterior: ▲x,x% · vs DD/MM/AAAA(-1): ▲x,x%
Por tienda
• TIENDA: S/ X.XXX (N tkts) (▲x,x%)
...
Fuente: Hoseg Dashboard · N de 7 tiendas con venta
``
- **Prueba real 13/09 19:03:**status ok,delivered: true,messageToolSentTo: whatsapp +51999923033,mediaUrl: null→ llegó como **TEXTO** ✅. Próxima corrida: 13/09 22:30.
- **⚠️ Truco TTS (importante):** comomessages.tts.auto=always, el cron escribe antes~/.openclaw/settings/tts.json={"tts":{"auto":"off"}}` para que el aviso salga como texto, y lo borra al terminar. Si algún día el aviso llega como nota de voz → revisar que ese pref no haya quedado huérfano.
4) 📱 Cabecera de la tabla en el correo — legible en celular (2026-09-13, 22:50)
- Problema (Daniel, con captura): en el celular la cabecera de la tabla del correo se veía amontonada/solapada ("TICKETSUNID.", "VAR. VS DÍA ANT." pisada) y la letra no se apreciaba bien.
- Causa: 8 columnas con
white-space:nowrap, anchos fijos y padding lateral grande (14px) → el contenido no cabía en ~314px útiles. - Solución aplicada en
backend/src/resumenDiario.js(htmlResumen): - Cabecera: font-size 8px,
line-height:1.2, etiquetas en 2 líneas con<br>(PUNTO/DE VENTA · VENTA/S/ · TKT/PROM · %/PART · VAR. VS/DÍA ANT. · VAR. VS/AÑO ANT.), padding 3px y anchos recalculados 20,5 / 10,5 / 12 / 8 / 9 / 12 / 14 / 14 %. - Filas: fuente 10px (PV) y 9,5px (números), padding 4px 3px, barra de % más fina (4px);
overflow-wrap:break-worden el nombre del PV. - Menos padding lateral en el correo (contenedor 14→4px, celdas 14→6px y 14→6px) → se ganan ~24px de ancho de tabla.
- Verificación (Chromium headless vía playwright-core,
tmp/check_email.js): con los datos reales del 13/09, a 360px y 375px de ancho → 0 solapes de columnas y desborde máximo de 2px (fila TOTAL). Ver también la previsualización entmp/previews/resumen_nuevo_390.png. - Desplegado (rsync +
docker compose up -d --build) y correo de prueba enviado a daniel@disoftx.solutions con los datos del 13/09. Commit02b3cd0pusheado. - Herramienta reutilizable:
tmp/check_email.js(+tmp/gen_real.js) mide solapes/desbordes del correo a cualquier ancho de pantalla con datos reales de producción — útil para futuros cambios de diseño del email.
⏳ Pendientes / decisiones abiertas
- Decisión de Daniel sobre
messages.tts.auto=always: hoy convierte todo texto saliente (incluidas las respuestas a Daniel) en nota de voz, lo que contradice la regla "voz solo cuando Daniel manda audio". Pendiente 3ª vez (13/09). - ✅ Resuelto 13/09 22:35: el aviso de WhatsApp también va a Cindy (+51986370707) desde el 14/09. Sigue abierto: ¿otra hora (ej. 21:00) o un segundo aviso más temprano?
- App móvil privada (Android/iOS) — sin iniciar (ver sección arriba).
⚙️ Configuración — Punto de venta POP UP desactivado (2026-09-13, 23:10)
- Pedido de Daniel: "En Hoseg dashboard hay un punto de venta llamado Pop up, puedes desactivarlo".
- Acción:
punto_ventacódigo 998 · POP UP · canal D2C · activo 1 → 0 (víaPUT /api/config/puntos/998). Se mantuvo el registro y supe_monto(5.000) → reversible:activo=1lo vuelve a mostrar. NO se tocópv_mapeo(no tenía mapeos). - Efecto inmediato (verificado en producción):
- Resumen Diario (correo 22:30 y vista web): pasa de 7 a 6 tiendas (CASA HOSEG, CUSCO, HOSEG WEB, LARCOMAR, MARRIOTT, MARRIOTT CUSCO). El encabezado ahora dice "x de 6 tiendas con venta".
- Reporte Diario / KPIs: POP UP sale de la lista de PV activos → fuera de las tablas por local, charts y KPIs que filtran
pv.activo=1(vendedores, tickets, visitas). - Detallado: ya lo excluía (lista fija
PV_D2C = ['008','043','044','004','048','025']). - Las ventas históricas de POP UP siguen en la BD (solo se oculta el punto de venta).
- Para reactivar:
PUT /api/config/puntos/998con{"nombre":"POP UP","canal":"D2C","pe_monto":5000,"activo":1}o desde Configuración → Puntos. - Otros PV ya inactivos de antes: AEROPUERTO (035), B2B (027), CUSCO WHOLESALE (999), EXPORTACIONES (037), EXTERNOS DIGITAL (036), PRINCIPAL (001).
✅ Subcategorías + desglose jerárquico (2026-09-14)
- Reporte de Ventas: nueva columna Subcategoría (a la derecha de
Categoría - odoo).Categoría - odooahora = nivel superior (CASACA); antes mostraba la hoja (ALPAFILL) por usarname. ✅ - Reporte de Inventario: nueva columna Subcategoría (entre Categoría y Modelo). ✅
- Venta por Categoría → Desglose por Punto de Venta: tablas expandibles por POS con jerarquía Categoría › Subcategoría › Modelo › Género › Talla (patrón Valorizado), columnas Unidades/Venta/% Part, botón Expandir/Contraer. ✅
- Origen de la subcategoría: 2do nivel de
complete_namedeproduct.categoryen Odoo ('CASACA / ALPAFILL' → ALPAFILL). Categorías de 2 niveles confirmadas: CASACA (ALPAFILL, CORTAVIENTOS, DAKOTA, PLUMAS, RAINCOAT, SOFTSHELL, TASLAN, THINSULATE), CHALECO (ALPAFILL, DAKOTA, PLUMAS, SOFTSHELL, TASLAN, THINSULATE), POLO (COMFY, EXPLORER, PIQUE), SHORT (COMFY, EXPLORER). - "SHERPA" NO es subcategoría en Odoo (solo aparece en el nombre de 3 productos).
- Sync:
nombre_subcategoriaen ventas +productos.subcategoriacon backfill; migración idempotente en db.js. - Commits:
79d02bc,3d8d4eb,1fce91f(master).
✅ Venta por Modelos — desglose por PV interno (2026-09-14)
- Submenú interno por categoría: botón colapsable "Desglose por Punto de Venta (n)" → pestañas por POS (D2C) + una tabla de modelos por POS. Colapsado por defecto (evita scroll infinito).
- Backend
reportes.ventaModelos()→{ modelos, desglose }. Commit7674c2e.
✅ Pestañas D2C | Wholesale (2026-09-14)
- Venta por Categoría y Venta por Modelos: pestañas de canal (D2C por defecto). Backend filtra por
pv.canal; endpoints?canal=D2C|WHOLESALE. Commit550a712. - Canal OTROS no incluido en las pestañas.
✅ Pestaña Corporativo (2026-09-14)
- Tercera pestaña Corporativo en Venta por Categoría/Modelos →
canal=OTROS. CORPORATIVO = PV código 104 (único activo del canal OTROS). Commit2604a6f.
✅ Venta por Categoría: doble gráfica YoY (2026-09-14)
- 2 gráficas de participación (año actual + año anterior, mismo periodo), cada una con % en texto. Backend devuelve
totales_anterior+periodo_anterior. Commitc0dc69b.
✅ Configuración → Costos de productos (2026-09-14)
- Nuevo tab en Configuración: SKU, artículo, categoría, subcategoría, talla, género, precio unit., Costo Odoo (read-only) y Costo editable (BD local). Búsqueda + filtro "sin costo" + paginación. Endpoints
GET/POST /api/config/productos-costos. Commit9c51b02. - Prioridad de costo hoy: Detallado = local → Odoo; Margen/Valorizado = solo Odoo (pendiente unificar).
✅ Opción C — costo efectivo unificado (2026-09-14)
- Vista
costos_efectivo(manual > Odoo standard_price > data_lista) usada por Margen, Valorizado, Reporte Detallado y faltantes. Configuración → Costos: columna Costo efectivo + ⚠ diferencias vs Odoo + filtro "Solo diferencias". Commitd69b48c. - Reporte de Ventas (detalle Odoo) aún usa el costo crudo de Odoo.
✅ Fix sync rodante + recarga orden (2026-09-14)
- Reconciliación de 10 días por
write_dateen cada sync (POS y wholesale) + candado anti-solape. Commits8ad3023,da9917d. - Diferencia CUSCO (16,346.48 vs 15,758.19) era la orden Odoo 940 ausente (creada en borrador, cerrada después). Corregido; cuadre total con el Reporte de Ventas.
⚠️ Resumen Diario — rebotes de destinatarios (2026-09-17)
- Cindy reportó que Mariale, Patrick y Juanca no recibían el Resumen Diario (agregado el 15/09).
- Verificado: el cron (prog id 4, diario 22:30) sí envía;
envios_log= "ok"; el SMTP de Mailu (Zeta) entregó a Google con 250. - Google rebotó (NDR) 2 de 5:
psznak@socialheater.comymsantos@socialheater.com→ no existen.juanca@socialheater.comsí llegó (sin rebote).daniel@ycindy@OK. - Lección: nodemailer registra "ok" porque Google acepta en el SMTP y rebota después (accept-then-bounce). El dashboard NO detecta esos rebotes.
- Temporales: las NDR llegan al buzón
nexus@disoftx.solutions(Mailu las cifra en disco; se leen por IMAP). - Pendiente: direcciones correctas de Patrick y Mariale → actualizar prog id 4 + reenvío de prueba. Mejora propuesta: monitorear DSN en nexus@.
- Re-verificado 11:55 (Daniel preguntó): NDR confirmadas 2×15/09 + 2×16/09 (solo
psznak@ymsantos@);postqueuevacío. Ojo: Daniel escribió el dominio comosocialeater.com→ typo;socialeater.comestá parqueado (afternic, sin MX). El NDR de Google es la única validación fiable (el RCPT de Google acepta cualquier dirección fake de socialheater.com). Reportado a Daniel; pendiente que consiga las direcciones de Hoseg.
✅ Corrección (2026-09-17 ~12:00)
- Direcciones correctas confirmadas por Cindy: patrick@socialheater.com y mariale@socialheater.com (el patrón es nombre@socialheater.com).
reportes_programadosid 4 actualizado a: daniel@disoftx.solutions, cindy@, patrick@, mariale@, juanca@socialheater.com.- Reenvíos verificados (250 Google, 0 NDR). Correo especial [TEST DE VERIFICACIÓN] con la nota de "prueba" + "recibirás todos los días a las 10:30 pm" + "confirma por WhatsApp a Cindy".
- Rutina final: Resumen de Ventas Diario → todos los días 22:30 (Lima) a los 5 destinatarios.
✅ Renombre de etiquetas en notas/promociones (2026-09-21)
- Pedido Daniel: "Base & Warmth" → "Fresh & Warmth" · "Final Sale" → "Hoseg Final Sale" (notas de pedido / nota de producto).
- Origen del dato:
Base & Warmth= valor PROMOCION del Excel (tablapromociones_venta);Final Sale= notas en Odoo producción (pos.order.line.note + pos.order.internal_note, widget JSON). - Helper:
backend/src/notas.js→normalizaNota()(case-insensitive; idempotente: no re-prefija "Hoseg Final Sale"). - Aplicado en:
odooReporteVentas.js(Notas por producto + Notas del pedido),reportes.jsventasDetalleAnual(Notas por producto) yventaPromociones(promoción). - Commit
49c8cdb+ push. Deploy Zeta (scp backend/src/*.js + docker compose build && up -d). Verificado en prod. - Corrección (2026-09-21): el reemplazo correcto es "FRESH & WARMTH" (mayúsculas). Commit
9fb7ff2+ redeploy. Pendiente confirmar si "Hoseg Final Sale" debe ir en mayúsculas también.
📊 Sesión 2026-09-21 — Venta Promociones con datos Odoo + Corrección de promociones ⭐
1) Venta Promociones ahora cuadra con el Reporte de Ventas
- Cambio de fuente: los montos de
/promocionesya no salen del Excel; salen de la tablaventas(Odoo) con las MISMAS reglas del Reporte de ventas. El Excel solo aporta la etiqueta de promoción. - Join:
p1pororden_nombre(=ventas.numero_comprobante) +sku+fecha;p2fallback porodoo_order_id+sku+fecha;COALESCE(p1,p2). Cada subconsulta deduplica conGROUP BY … MAX()(inmune a doble carga). - Hallazgo clave: la columna "Orden" del Excel =
ventas.numero_comprobante(p.ej."CUSCO PLAZA - 000042"), NO el id interno POS. Match 165/165 verificado (semana 38 D2C). - NC siempre incluidas (neto): venta/cantidad/costo firmados por comprobante (
CASE WHEN comprobante IN ('BOLETAS','BOLETA','FACTURA') THEN + ELSE −), idéntico al reporte principal. Se quitó el checkbox de NC. - Canonicalización de etiquetas: agrupación por
UPPER(REPLACE(promocion,' ',''))→ une variantes (VENTA REGULAR, ALPAFILL 25%, TRIPACK POLOS, HOSEG REWARDS/Hoseg Rewards). - Import Excel semana 38:
import_promociones.jstolera ambos formatos (Local|Almacén,Total|TOTAL S IGV,Notas por producto|PROMOCION,N° Semana|SEMANA, año desde la fecha si no hay columnaAÑO). Cargó 169 filas (99 sin promo). Se evitó doble carga (borrada la dearchivo='odoo_2026-09-14_2026-09-20'). - Validación: semana 38 D2C con NC = S/ 30.587,85 (und 162, costo 8.754,05, margen ~71,4%) = idéntico al Reporte de Ventas (DIF 0,00). Todas las semanas (27, 30–38) DIF 0,00.
- Fix timezone:
utils.jsx defaultRange()usabanew Date().toISOString()(UTC) → después de ~19:00 Lima mostraba el día siguiente. Se agregóisoLocal(). También corregido en Valorizado (hoy), Configuración (mes) y ReporteVariantes (nombre de archivo). - Commits:
61ae28b,052dd61,a945cf7,8462e88.
2) Filtro GLOBAL único (fecha/semana)
- Barra arriba de todo (
components/Layout.jsx): Semana (lunes–domingo) + Desde/Hasta + Aplicar a todos / Limpiar. Persiste en localStorage (hog_filtro_global) y recarga → todos los reportes la usan. - Se eliminaron los filtros de fecha duplicados dentro de Reporte de Ventas, Venta por Categoría, Venta por Modelos, Margen y Venta Promociones (quedaron solo leyendas chicas).
- Sin selector de canal en la barra global (los reportes ya traen sus pestañas por canal).
- Semana nueva automática los lunes: la lista se calcula por fecha (
semanasRecientes(16)enutils.jsx), no por datos cargados. Ej.: Semana 39 = 21/09 → 27/09. - Helper
defaultCanal()para el canal por defecto de cada reporte. - Commits
0cabe7d,e980940.
3) Corrección de promociones (supervisoras) — dentro de Configuración
- Catálogo
promociones_catalogo(id, nombre UNIQUE, habilitado, orden) con semilla de 15: VENTA REGULAR, 2X1, 3X1, TRIPACK POLOS, PACK 2 POLOS, ALPAFILL 25%, HOSEG FINAL SALE, FRESH & WARMTH, PACK ADVENTURE, PROMO ONE, HOSEG REWARDS, WHOLESALE, CORPORATIVO, B2B, NC. - Pantalla
pages/CorregirPromociones.jsx— es la pestaña ✏️ Corregir Promociones DENTRO de Configuración (ya no está en el menú lateral). - Pestañas por punto de venta: Todas · CUSCO · MARRIOTT · MARRIOTT CUSCO · CASA HOSEG · LARCOMAR · HOSEG WEB…
- Agrupada por Orden, corrección por línea (SKU): SKU · Producto · Cant · Subtotal · P.Unit · %Dscto · selector de promoción.
- Solo el admin ve el CRUD del catálogo (crear + habilitar/deshabilitar).
- %Dscto =
1 − (precio pagado ÷ precio de lista), conlist_pricedel producto (productos.list_price, sin IGV). Ejemplos reales (MARRIOTT CUSCO - 000003): pagado 106,02 vs lista 117,80 → 10%; 84,32 vs 117,80 → 28%; 380,93 vs 761,86 → 50%; venta a lista → 0%. Con cantidad 1 ⇒ Subtotal = P.Unit. Pendiente que Daniel valide; columna "P. Lista" en pausa hasta su OK. - Endpoints (
server.js): GET /api/reportes/promociones/catalogo·POST/PATCH /api/reportes/promociones/catalogo[/:id](solo rol admin)GET /api/reportes/promociones/puntos→ puntos activos (pestañas). Permisopromociones.GET /api/reportes/promociones/lineas?f_inicio&f_fin&canal(aceptacanal=TODOS)POST /api/reportes/promociones/lineas{items:[{orden,sku,fecha,promocion}]}→ upsert enpromociones_ventaconarchivo='manual'(autoritativo); promoción vacía = quitar.- Permisos: supervisoras = Patricia Medina (
pmedina) y Valeria Gutierrez (vgutierrez) (rolusuario). El menú Configuración se ve con permisoconfigopromociones; dentro se muestran solo las pestañas permitidas. Commits3104438,9bbfc63.
Deploy (recordatorio)
- Repo
dannyelito/hoseg-dashboard. Deploy =npm run build(frontend local) →scpa Zeta (opsmgr@100.83.7.25, llave~/.ssh/zeta_nexus) reemplazandofrontend/distysrc→docker compose up -d --build(contenedorhoseg-dashboard, puerto 3016; público vía Caddy enhoseg-dashboard.disoftx.solutions). - Pruebas rápidas de API dentro del contenedor:
docker exec hoseg-dashboard node /tmp/script.js(con JWT firmado conJWT_SECRETo el defaulthoseg-dashboard-dev-secret).
🆕 Menú «Inventario» (2026-09-27)
- Pedido (Daniel): nuevo menú Inventario con tabla de productos desde la ficha de Odoo (SKU, nombre artículo, categoría, subcategoría, modelo, género, talla, marca, precio unitario) + buscador en la cabecera por cualquier campo.
- Backend:
GET /api/inventario(auth+requireMenu('inventario')) lee de la tabla localproductos(sync Odoo): 2.177 SKUs. Devuelve{filas:[{sku,nombre,categoria,subcategoria,modelo,genero,talla,marca,precio_unitario}], total, actualizado}. Soporta?q=. - Frontend:
pages/Inventario.jsx(ruta/inventario), entrada enLayout.jsx(📋, permisoinventario) y enmenus.js. - Permisos: se añadió
inventarioa los permisos guardados de los 11 usuarios existentes (todos coincidían con su preset de rol). - Deploy Zeta: commit
0e1492d. Verificado: sin token 401 · con token 200 (total 2.177) ·?q=WETSHORT→ 12 · bundle nuevo 200. - Precio unitario =
list_pricede Odoo (redondeado a 2 decimales).
🏷️ Marcas en el catálogo (consulta 2026-09-27, tabla productos)
| Marca | Productos |
|---|---|
| HOSEG | 1741 |
| FLUYE | 78 |
| INDOSOLE | 45 |
| EAGLE CREEK | 42 |
| PIOLA | 40 |
| FSV | 34 |
| NATUREHIKE | 13 |
| HOSEG CAFE | 2 |
| (sin marca) | 182 |
- 8 marcas, sin variantes de escritura (todo limpio en mayúsculas).
- ⚠️ 4NOMADS no aparece (0 productos con esa marca en el catálogo local).
- Total productos: 2177. Origen: atributo Odoo «Marca» (
productos.marca), sync product.product. - Uso: base para el módulo Proveedor (scope por marca). Pendiente definir qué marcas tendrán acceso y sus usuarios.
🚚 Módulo «Proveedor» con scope por marca (2026-09-27)
Pedido (Daniel): marcas proveedoras (Fluye, Piola, 4Nomads, FSV…) con acceso al dashboard solo a sus marcas; menús de venta del día / del mes / inventario por punto de venta, sin margen ni costos.
Decisión: 1 menú Proveedor con 3 pestañas (Venta del día · Venta del mes · Inventario por punto de venta).
Backend:
- Tabla marcas (clave, nombre, aliases, activo, orden) — semilla de 8. usuarios.marcas (JSON array de claves).
- Rol nuevo proveedor → preset permisos ['proveedor']. Se excluyó proveedor del preset usuario.
- GET /api/proveedor/marcas · GET /api/proveedor/ventas?f_inicio&f_fin[&marca] · GET /api/proveedor/inventario[?marca].
- Scope server-side: clavesDe(user) (admin=todas) → valoresRaw() → filtro SQL UPPER(TRIM(p.marca)) IN (...). Ventas: join por SKU a un subselect 1-fila-por-SKU de productos (evita duplicados). Inventario: reutiliza odooReporteInventario (Odoo en línea, cache 5 min) filtrando por marca.
- Sin costos ni márgenes en ningún endpoint de proveedor.
Frontend: pages/Proveedor.jsx (ruta /proveedor), NAV 🚚 + permiso proveedor; filtro global de fechas oculto para rol proveedor; botón «Sincronizar Odoo» solo para admin; Configuración → Usuarios: rol Proveedor + checkboxes de marcas y columna «Marcas».
Catálogo de marcas (semilla): FLUYE, INDOSOLE, EAGLE CREEK, PIOLA, FSV, NATUREHIKE, HOSEG CAFE, HOSEG.
Deploy: commits 96f7acd, b290513 (Zeta). Verificado: admin ve 8 marcas; usuario proveedor FLUYE ve solo FLUYE (ventas S/268.64 vs admin S/127,025.30); 403 en módulos fuera de su permiso.
⚠️ Lección de deploy: el SPA va dentro de la imagen (Dockerfile: COPY frontend/dist/). Cambios de frontend requieren docker compose build (no basta up -d).
Pendiente: crear los usuarios proveedores reales (uno por marca) desde Configuración → Usuarios; decidir si se agregan más marcas al catálogo. Las 182 líneas de producto sin marca (y ~201 líneas de venta sin SKU en catálogo) no aparecen para ningún proveedor.
Proveedor — mejoras v2 (2026-09-27, commit 3618c74)
- Filtros: Venta del día → calendario (tope hoy); Venta del mes → select de Mes + Año (rango auto: 1° → último día, acotado a hoy si es el mes en curso).
- Landing arreglado: nueva página
Homeen la ruta/→ muestra el primer módulo permitido segúnuser.permisos(un proveedor aterriza en /proveedor, ya no cae en el 403 del Reporte de Ventas). Si no tiene módulos → mensaje "Sin módulos habilitados".NAVyPERMS_POR_RUTAse exportan desdeLayout.jsx. - Gráficos (Recharts, mismo estilo del dashboard): Venta por punto de venta (día y mes), Venta por día (mes), Disponible por PV (inventario).
Proveedor — fix permisos (2026-09-27, commits e269c9b + d29b3cc)
- Causa: la migración de
db.jsdel módulo Notificaciones push agregaba el menúnotificacionesa TODO usuario sin él → el rol proveedor (ej.fluye) terminaba con['proveedor','notificaciones']y le aparecía la pestaña. - Fix (3 frentes): (1) backend: rol
proveedorfuerzapermisos=['proveedor']en POST/PUT y en un saneo al boot; (2) la migración de Notificaciones salta el rol proveedor; (3) UI: con rol Proveedor los checkboxes de menús quedan bloqueados ("fijados"). - Verificado:
fluye→ permisos["proveedor"], marcas["fluye"]. El usuario debe cerrar sesión y volver a entrar (los permisos del sidebar se guardan del login).
UI general — sidebar y footer (2026-09-27, commit e05df35)
- Sidebar: logo Hoseg arriba y "Dashboard de Ventas" debajo (se quitó la línea "Hoseg" porque ya está en el logo). En modo colapsado se sigue viendo solo el logo.
- Footer:
v0.4 · Fase 3+4/© 14 Diez SAC/ disoftx.solutions (link a https://disoftx.solutions).
🔎 Conversión de setiembre al ~32% — diagnóstico (2026-09-27)
- Fórmula:
conv = COUNT(DISTINCT numero_comprobante) / SUM(visitas.cantidad)del rango (KPIs del Reporte de Ventas). - Setiembre 2026: 192 tickets ÷ 613 visitas = 31%. · Agosto: 630 ÷ 403 = 156% (¡imposible!). · Julio: 540 ÷ 739 = 73%.
- Causa raíz: las VISITAS están muy subregistradas (dato manual en Odoo
x_registro_de_visitas): - Solo ~5 tiendas registran visitas (004 LARCOMAR, 008 CUSCO, 043 MARRIOTT, 044 MARRIOTT CUSCO, 048 CASA HOSEG; 006 CUSCO CAFE 1 vez).
- Volúmenes irreales: CASA HOSEG ~24 visitas en agosto con 117 tickets → de ahí el 156%.
- Puntos con ventas y 0 visitas (HOSEG WEB 102 tickets ago / 8 sep, CORPORATIVO, LIVINGSTONE) suman al numerador.
- Bugs menores del KPI: (1) el numerador incluye NOTA DE CREDITO (el KPI del día sí las excluye); (2) mezcla canales sin visitas.
- Conclusión: el 32% no es una conversión real; es un artefacto de datos incompletos. Pendiente decisión de Daniel (empujar el registro de visitas y/o ajustar el cálculo).
- Decisión (2026-09-27): dejarlo así por ahora; Daniel avisará si le piden mover el cálculo. Cambios propuestos (excluir NC + puntos sin visitas) quedan listos para aplicar cuando lo confirme.
📊 Promociones: la nota del cajero (Odoo) ahora llena "Venta Promociones" (2026-10-06) ⭐
- Contexto: el Reporte de Ventas (Odoo en línea) ya mostraba las notas que escriben los cajeros (
pos.order.line.note, "Notas por producto"), pero el módulo Venta Promociones usaba SOLO la tablapromociones_venta(Excel/manual) → aparecía casi todo como "(SIN PROMOCIÓN)". - Regla implementada (acordada con Daniel): promoción por línea = corrección MANUAL (supervisora,
promociones_venta) > notA del CAJERO (Odoo) > "(SIN PROMOCIÓN)". Texto de la nota tal cual (canonicalizado). Solo nota por producto (nointernal_note). - Cambios de código:
backend/src/db.js: migraciónventas.nota_producto TEXT.backend/src/notas.js: helpersnotaTexto()ylimpia()(parsean el widget JSON de notas de Odoo POS).backend/src/sync/sync.js: el sync depos.order.linetraenote→ guarda enventas.nota_producto.backend/src/reportes.js:ventaPromocionesyventasDetalleAnualusan el COALESCE de 3 niveles.backend/src/server.js/api/reportes/promociones/lineas: devuelvenota_cajero+origen('manual'|'cajero') y precarga el valor efectivo.frontend/src/pages/CorregirPromociones.jsx: badge cajero en las líneas que vienen de la nota (pendientes de confirmar).backend/scripts/backfill_notas.js: rellena notas históricas (node backend/scripts/backfill_notas.js YYYY-MM-DD).- Deploy: Zeta
~/proyectos/hoseg-dashboard→docker compose build && up -d. En prod quedó migrada la columna y backfill Sept→hoy. - Limitación: los cajeros usan poco los "Modelos de nota" (~1% de líneas) y algunas notas son números/referencias; la corrección de supervisoras sigue siendo necesaria.
🔐 Sesión de larga duración (refresh tokens) + Release 1.4.0 (2026-10-10)
Motivo (reporte de Daniel): la app "desconectaba el login" y por eso no llegaban las notificaciones. Causa raíz: el JWT de acceso duraba 12 h y, al vencer, api.js limpiaba la sesión y mandaba a /login; además el push solo se registraba con sesión activa, así que si FCM rotaba el token durante ese lapso, el backend quedaba con un token viejo → no llegaban avisos.
Solución (estándar): access token corto + refresh token largo y rotativo.
- Backend (server.js, db.js):
- Tabla nueva refresh_tokens (id, user_id, token_hash SHA-256, expira_at, revocado, origen, ultimo_uso).
- ACCESS_TTL = 60 min (JWT_ACCESS_TTL). REFRESH_DIAS = 180 (REFRESH_TOKEN_DIAS).
- POST /api/auth/login → { token, refreshToken, usuario }.
- POST /api/auth/refresh → valida (no revocado, no vencido, usuario activo), rota (revoca el usado y emite uno nuevo) → { token, refreshToken, usuario }.
- POST /api/auth/logout → revoca el refresh (o todos con todos:true + Bearer).
- Limpieza de vencidos al boot y en cada refresh. El refresh NUNCA se guarda en claro (solo su hash).
- Frontend (api.js, auth.jsx):
- Guarda hd_refresh; ante 401 en endpoints no-auth → renovarSesion() (petición única compartida) → reintenta UNA vez; si falla → limpia y vuelve a /login.
- logout() limpia local y revoca en el servidor (best-effort).
- Efecto: la app/web quedan conectados hasta 180 días sin volver a pedir contraseña (se renueva solo); las notificaciones dejan de caer.
- App: Android versionCode 6 / 1.4.0 · iOS build 3 / 1.4.0. Incluye además los cambios recientes de Promociones (nota del cajero).
- Extra: el fallback del SPA ya no devuelve index.html en /descargas/<faltante> (200→404 correcto).
- Artefactos (entregables/):
- HosegDashboard-1.4.0-release.aab — 4,897,193 B — sha256 4c1d2eebf572c164dbc4cea252bb5efd3020b6d7fc28bb7a2892fd5e7a5b92c4
- HosegDashboard-1.4.0-release.apk — 5,265,999 B — sha256 2b8b6a07432b6d163c603855c38199511dab1e14870bdad501ef1e63dabcd7bb (md5 093fa6cc5c9d2483ceb178f1b0bef89c)
- Descarga pública: https://hoseg-dashboard.disoftx.solutions/descargas/hoseg-dashboard-1.4.0.apk
- Deploy: Zeta ~/proyectos/hoseg-dashboard → docker compose build && up -d (backup previo .bak_deploy_20261010_132516). Bundle index-DzERgc9S.js. Commit af8453f.
- iOS: build Codemagic 6aca8372d1259ee7cc7e9506 (workflow ios-testflight) → TestFlight.
- Probar en prod (hecho): login mal creds 401 · refresh sin token 400 · APK 200 (type correcto) · APK viejo 404 · index 200.
- Pendiente: subir el AAB 1.4.0 a Play Console (prueba interna) — requiere acceso a la consola (Daniel).
📈 Venta por Categoría — Histórico 2025 + detalle por Punto de Venta (2026-10-13)
- Pedido de Cindy: en el menú Venta por Categoría agregar la venta histórica 2025; y en el Desglose por Punto de Venta la información de venta (soles) y unidades.
- Backend (
backend/src/reportes.js,ventaCategoria): nueva datahistorico_2025(año completo 2025-01-01..2025-12-31, por categoría, respeta canal/filtros) yhistorico_2025_periodo. La jerarquía por PV ahora incluyeund_2025/vta_2025en cada nodo (categoría→subcategoría→modelo→género→talla) y en el total del PV. El árbol se construye conconstruirPorPv()y el histórico 2025 se mapea por ruta de niveles (flat25). - Frontend (
frontend/src/pages/Categorias.jsx): nueva sección "Venta Histórica 2025 (año completo)" (gráfico de participación por categoría + tabla). En Desglose por Punto de Venta el encabezado de cada PV muestra2026: Venta S/ · undy2025: Venta S/ · und; la tabla expandible agrega columnas Und 2025 y Venta 2025. - Deploy (Zeta): build del
frontend/dist+ copia debackend/src/reportes.js;docker compose build && up -d. Backup:.bak_deploy_20261013_071524. Commit en GitHubb12a6a9. - ⚠️ OJO: en Zeta la carpeta
frontend/srcestá desactualizada (el deploy usafrontend/distprecompilado desde el repo). Fuente de verdad = repo GitHub. - Verificado: bundle nuevo
assets/index-Z5jGTIrd.jsen línea + la función en el contenedor devuelve los campos 2025 por PV.
Corrección (2026-10-13 ~09:20)
- Cindy observó que la venta 2025 por categorías no cuadraba y preguntó si se estaba considerando el filtro de fechas/PV. Diagnóstico: la sección tomaba año completo 2025 y solo respetaba el canal → no respetaba el filtro de fechas.
- Fix:
historico_2025y el detalle 2025 por PV ahora usanrangoAnterior(f_inicio,f_fin)(mismo periodo del filtro, un año atrás) →historico_2025=totales_anterior. Etiquetas del frontend: "Venta 2025 — mismo periodo del filtro". Deploy en Zeta + backup.bak_deploy_20261013_091953. Commit GitHubfix(categorias).
🧥 Sesión 2026-10-15 — Venta por Subcategoría, rediseño Proveedor y "meses venta" ⭐
1) Venta por Modelos — jerarquías (commits 712b7de, 51fa9e2)
- Tabla semanal de Venta por Modelos: orden Modelo ▸ Categoría ▸ Subcategoría ▸ Género ▸ Talla.
- Tarjetas y Desglose por PV: dentro de cada tarjeta = Modelo ▸ Subcategoría ▸ Género ▸ Talla (la categoría es la tarjeta).
NodoMV/TablaModeloscon propbasepara indentación relativa.
2) Marcas auto-sincronizadas desde Odoo (commit 6f6bf00)
- La lista de marcas del módulo Proveedor era fija (semilla en
db.js, 8 marcas) → no aparecía TENAYA. - Nuevo
db.sincronizarMarcasOdoo(): tomaDISTINCT productos.marca(atributo marca de Odoo), slug comoclave, e inserta las que falten. Se ejecuta al final del sync deproductos(POST /api/sync) y enGET /api/config/marcas. Marca (clave, nombre, orden 100).
3) Nuevo menú «Venta por Subcategoría» (commit 4c1333a, fix ed18afc)
- Mismo diseño que Venta por Modelos; desglose Subcategoría ▸ Categoría ▸ Modelo ▸ Género ▸ Talla. Tarjetas por subcategoría + Desglose por PV + matriz semanal.
- Backend:
ventaSubcategoria()enreportes.js, rutaGET /api/reportes/subcategorias(requireMenu('subcategorias')). Menú nuevo enbackend/src/menus.js. - Frontend:
pages/Subcategorias.jsx(icono 🧵), NAV + PERMS_POR_RUTA enLayout.jsx, ruta/subcategorias. - Las subcategorías vacías se agrupan como tarjeta "(sin subcategoría)" (≈35% de líneas) para no ocultar data.
- Extra: quitado el "S/ S/" duplicado en el título de tarjetas (Modelos + Subcategorías).
4) Orden de menús (commit d4e7b51)
- Orden del sidebar: Reporte de Ventas → Venta por Categoría → Venta por Subcategoría → Venta por Modelos → Venta Promociones → … (
menus.js+Layout.jsxNAV).
5) Módulo Proveedor — rediseño (commit beea876)
- 2 pestañas: Ventas e Inventario por punto de venta (se eliminó "Venta del día"/"Venta del mes").
- Ventas: rango desde/hasta + marca; cards Venta/Unidades/Comprobantes/Ticket promedio; gráficos (venta por día + venta por punto de venta); tabla jerárquica Punto de venta ▸ Producto (Venta/Unidades/Comprobantes/Participación).
- Inventario: detalle por producto con jerarquía pto venta ▸ modelo ▸ SKU ▸ producto (árbol expandible) + buscador.
- Backend
routes/proveedor.js: BASE conMAX(name); nuevopor_pv_producto. Front reescrito (ArbolTabla/Filagenéricos).
6) Proveedor — columnas de stock/rotación (commit 9ae3b9c)
- Ventas → col "Unidades que quedan" = stock total del artículo (por SKU).
- Inventario detalle → cols Vta U (6M) / Stock / Meses Vta, con la misma lógica del Valorizado: ventana 180 días; Vta U = unidades netas vendidas en 180 días (NC restan); Stock =
MAX(productos.stock_qty)por SKU; Meses Vta = Stock × días_vida ÷ (30 × Vta U), días_vida = días desde la 1ª venta registrada (piso 30, tope 180). - Nota: "Unidades que quedan" usa stock total del artículo (no por almacén) porque los nombres de PV (ventas) y de almacén (Odoo) no siempre coinciden (Mapeo Odoo: 004 LARCOMAR, 008 CUSCO→CUSCO PLAZA, 025 HOSEG WEB→14 Diez SAC (HOSEG WEB), 043 MARRIOTT, 044 MARRIOTT CUSCO, 048 CASA HOSEG; almacenes sin PV: Hoseg, MARRIOTT LIMA, Agente Logístico ( Externo ), CONSIGNACION | TAMBO DEL INCA, HOSEG CAFE).
7) Fix «meses venta» en nodos agregados — Proveedor y Valorizado (commits 8bea57a, ecd45fa)
- Síntoma: en el detalle de inventario de Proveedor (marca TENAYA), la fila agregada CASA HOSEG mostraba 188 m.
- Causa: en los nodos agregados se tomaba
días_vida = máximoentre TODOS los SKUs; los SKUs sin ventas devuelven 180 (default) → inflaba (94 stock × 180 ÷ (30×3) = 188). - Fix:
días_vidaen la agregación solo considera artículos/skus con ventas (unidades > 0). CASA HOSEG pasó a 31,33 m; TAHOE 13,67 m; MARRIOTT LIMA 26 m. - Misma corrección aplicada al Valorizado de Inventario (
reporteValorizado, jerarquía):a.dias_vida = Math.max(...)solo sif.unidades > 0, ytotDiasidem. Verificado en prod: categorías raíz 6,5/17,9/6,1/18,6/11,1/9,4; TOTAL 8.452 u · stock 80.102 · 56,9 m · S/ 929.677 (el total alto es real: mucho stock vs ventas).
Nota de flujo: el sync de marcas y las correcciones se probaron copiando el archivo al contenedor y ejecutando consultas con
docker exec -i -w /app/backend hoseg-dashboard node -antes de reconstruir la imagen.
Ciclo 27/10/2026 — Conciliación de ventas vs reportes de Mariale
Origen: correo de Mariale Santos (23/10) con 9 diferencias entre el dashboard y sus reportes/Excel de cierre. Se revisó punto por punto contra la base y contra los archivos enviados (Cusco agosto, Hoseg Web agosto).
Correcciones aplicadas (código + BD)
1) SKU de no-venta faltantes — backend/src/excluidos.js
- Se agregaron 00009999 (PAGO ANTICIPADO) y 00000046 (SERVICIOS ADMINISTRATIVOS).
- Impacto medido: S/ 24,692.39 entre ene–jun 2026, todo en PV 001.
- ⚠️ El ajuste "de ayer" no estaba aplicado: el archivo tenía fecha 09/09 y el backup del 26/10 era idéntico. Es el segundo caso del día de archivos que revierten (el primero fue el frontend).
2) Tipo de cambio por comprobante — tc_override
- Tabla tc_override(numero_comprobante PK, tasa, motivo, creado_at) + config.tasaSql(alias).
- Reemplazado ${TASA} por ${TASA_SQL} en reportes.js (16 usos), reporteDetallado.js (2), resumenDiario.js (2).
- reportes.js además usa TC_OVERRIDE (Map) para el cálculo en JS (no SQL).
- Cargados: F036-0000034 (OWS HOME) 3.363; F036-0000046 (McKinsey) 3.435.
- Sobrevive al delete+insert del sync.
3) Purga de documentos anulados — sync/sync.js → purgarAnulados()
- Bug: el sync incremental filtra state in ['sale','done'], así que una orden cancelada nunca vuelve a leerse y su fila quedaba congelada como venta para siempre. El delete+insert solo borra los ids que recibe.
- Ahora busca cancelados con write_date >= RECON_DIAS (10) y borra sus líneas. Verificado con S00058 (88 líneas).
- Límite conocido: no cubre anulaciones de más de 10 días.
4) Reclasificación manual — tabla pv_override + aplicarOverrides()
- pv_override(numero_comprobante PK, codigo_pv, motivo).
- Se aplica al final de runSync (gana sobre la clasificación automática).
5) Clasificación por nota de factura — tabla nota_pv + clasificarPorNota()
- nota_pv(patron, codigo_pv, activo); lee account.move.line con display_type='line_note'.
- Ojo: en la línea de nota move_id[1] es el display_name (F FFI-00000075 (S00592)), no el nombre de la factura → se enlaza por ID, y luego invoice_origin (= nombre del sale.order = numero_comprobante en ventas).
- Probado end-to-end con una regla temporal: movió 3 comprobantes / 20 líneas; se revirtió y se restauraron las filas.
6) Nuevo PV "MUESTRAS B2B" — código 108, canal OTROS, activo.
- Agregado a pdv_catalogo (4ª etiqueta) y regla MUESTRA → 108 en nota_pv.
- Funciona con facturas de pedidos de venta (S00xxx). Con boletas POS no enlaza (su invoice_origin es una numeración interna tipo 2633-2-000018).
7) Reporte Detallado multi-canal — detalladoExcel.js
- El backend ya tenía setAlcance() y CANAL_PVS (D2C / WHOLESALE / OTROS=104 / TODOS) y el frontend ya tenía selector.
- Se hizo dinámico el Excel: CANAL_LABEL, etiquetaCanal(), reglas(); xlsxDetallado() fija CANAL_ACTUAL y TIENDAS_ACTUAL desde data.
- Antes todos los títulos decían "Retail D2C". Ahora: "Corporativo · BD local", "(1 tienda)" etc.
- Verificado agosto: D2C 139,312.38 (6 tiendas) · Wholesale 136,150.24 (7) · Corporativo 39,141.25 (1).
Los 9 puntos — causa exacta
| Punto | Correcto | Reporte | Causa |
|---|---|---|---|
| Corporativo feb | 20,625.20 | 20,625.00 | 22,887 previo = 1,610.29 servicios admin (alquiler Marriott Lima) + 651.51 TC OWS (USD 1,933.26, 3.70→3.363) |
| Corporativo may | 8,319.94 | 8,644.94 | +325.00 estampado incluido en el reporte; TC McKinsey 3.70→3.435 = 67.79. F036-0000047 (6,581.51) "Anulado por confirmar" no se suma |
| Corporativo ago | 39,141.25 | 35,841.25 | −3,780 Tiendas Tambo (no incluida) + 480 estampado (incluido) |
| Alguis jul | 64,143.15 | 64,143.15 | 128,286.30 previo = factura S00058 duplicada (88 líneas / 360 und / 64,143.15), idéntica a S00079 |
| F&F ene | 70.59 | 71 | Principal 2,147.04 − 2,076.45 servicios admin = 70.59 (1 comprobante F001-0000298) |
| F&F feb | 954.24 | 954 | Principal 8,849.80 − 6,660.00 anticipos (9 fact. USD 1,800) − 1,235.56 servicios = 954.24 (18 boletas) |
| Larcomar may | 40,904.28 | 41,079.28 | +175.00 estampado incluido (el reporte sí excluye delivery 55.08) |
| Cusco ago | 44,334.85 | 44,208.15 | −126.70: boleta CUSCO PLAZA - 000181 (19/08, Camisa Explorer, consumidor final) omitida en el export |
| Hoseg Web ago | 18,398.06 | 18,840.46 | +253.39 duplicado S00128 + 189.01 duplicado S00127 |
Margen Cusco setiembre: dashboard 69.59% (venta neta 44,073.28 · costo 13,403.30) vs 68.60% del reporte = 0.99 pp ≈ S/ 436 de costo. El 59% no se reproduce con la data actual (13 NC distintas, 7,567.31; si se restaran dos veces daría 63.3%, no 59%) → se atribuye a captura previa a la carga de costos del 08/09.
Aprendizajes operativos
- El backend va dentro de la imagen: solo
db/está montado. Cualquier cambio enbackend/srcexigedocker compose up -d --build. - npm no está en el host: el frontend se compila con
docker run --rm -v "$PWD/frontend":/app -w /app node:24-slim npm run build. - Página en blanco:
index.htmlpedía/assets/index-5o73ia3p.jsinexistente (build parcial: assets nuevos, HTML viejo). Solución:mv dist dist.bak_*+ build limpio + rebuild. Verificar que el script del HTML exista enassets/. - Archivos que revierten: dos veces hoy (frontend
pages/*.jsxyexcluidos.js). Sin causa identificada. Si vuelve a pasar, revisar procesos de restore/backup.
Pendientes del ciclo
- Enviar el correo a Mariale (borrador aprobado, formato "monto correcto + cuadro de conciliación por punto"). Falta enviarlo.
- F&F/Marketing/Casacas por nota: las notas reales de Odoo (76, desde julio) no contienen las etiquetas F&F/MARKETING/CASACA; usan textos como "TRANSFERENCIA GRATUITA" (16), "REGALO/PREMIO" (3), "EMBAJADOR" (4), "DONACIÓN" (1), "CANJE" (1). Falta definir el mapeo de palabras clave.
- Muestras B2B por POS: si alguna muestra se emite como boleta, el enlace por
invoice_originno funciona; habría que resolver por pos.order. - Pedido vs factura: el dashboard lee
sale.order, no la factura. Si la factura detalla tallas y el pedido no, se pierde el desglose (153 líneas sin talla en 73 pedidos). Si la factura trae más productos, el dashboard los ignora. Opciones planteadas: detallar el pedido, control de diferencias, o tomar la factura como fuente. - Anulaciones > 10 días: la purga no las cubre; forzar a mano si aparece un caso.
Ciclo 30/10/2026 — F&F y Marketing como canales propios
Pedido del cliente (Mariale): incorporar el margen de F&F al Reporte Detallado y, en Margen y Contribución, filtrar el costo de Principal para que solo tome F&F, de modo que ambos números coincidan. Deadline: fin del día 30.
La regla
- F&F = líneas de Principal (PV 001) con
valor_venta_total > 0 - MARKETING = líneas de Principal con
valor_venta_total = 0(regalos / transferencias sin importe) - Desde adelante manda la NOTA de la factura. Si la nota trae la etiqueta, esa clasificación gana; el valor queda como respaldo para el histórico, que no tiene notas.
Validado contra los montos que Mariale ya había reportado: enero 70.59 y febrero 954.24. El reparto de febrero cierra: 7 comprobantes con valor (F&F) + 11 en cero (Marketing) = 18 boletas.
Implementación
1. Vista ventas_pv — expone pv_rep calculado con esta prioridad:
1. nota_factura coincide con un patrón de nota_pv → ese canal
2. codigo_pv = '001' y valor = 0 → 001M (MARKETING)
3. codigo_pv = '001' → 001F (F&F)
4. resto → codigo_pv original
2. Tabla pv_reporte — 20 puntos de venta (los activos + 001F y 001M). Reemplaza a punto_venta en los reportes; no tiene columna activo porque solo lista los vigentes.
3. Columna ventas.nota_factura y lectura de line_note en el sync (clasificarPorNota). Las reglas que apuntan a 001F/001M no tocan codigo_pv (son virtuales): la vista resuelve el canal.
4. Migración idempotente en db.js — crea columna, tablas, patrones y vista al arrancar. Importante: antes la vista vivía solo en el archivo SQLite y se perdía al restaurar un respaldo.
5. Reportes que ahora usan la vista:
- Reporte Detallado (alcance TODOS por defecto, 20 puntos)
- Margen y Contribución (la fila de Principal pasa a llamarse F&F)
- Reporte de Ventas (diario)
- Venta por Categoría, Subcategoría y Modelos
- Proveedor queda fuera a propósito: muestra Principal entero (mira stock y rotación, no canales)
Corrección de redondeo
El Reporte Detallado calculaba el costo por SKU con el unitario redondeado a un decimal y sumaba filas ya redondeadas. Eso producía 9 céntimos de diferencia contra Margen y Contribución. Ahora acumula con precisión completa y redondea solo al presentar.
Verificación final (MATCH = venta y costo iguales en ambos reportes):
2026-01 · F&F venta 70.59 · costo 19.11 · 72.9% MATCH ✅
2026-02 · F&F venta 954.24 · costo 1,179.51 · −23.6% MATCH ✅
El margen negativo de febrero es real: varios SKU se vendieron por debajo del costo. Confirmado por Daniel como situación única.
Marketing
Queda fuera del margen y se muestra como tarjeta informativa en Margen y Contribución: comprobantes, unidades y costo, con venta cero. En febrero: 11 comprobantes · 37 und · S/ 1,674.21. Antes, ese costo se sumaba al de F&F y hundía el margen de Principal a −199%.
Incidentes del ciclo (todos corregidos)
- Import faltante (
ffVenta): el archivo importaba desde'./excluidos.js'y el reemplazo buscaba sin extensión → contenedor en bucle de reinicio, ~2 min de caída. CREATE OR REPLACE VIEW: no existe en SQLite. Se cambió aDROP VIEW IF EXISTS+CREATE VIEW.pv.activoresidual: tras migrar las consultas apv_reporte, quedaron 12 filtros pidiendo una columna inexistente → error 500 en Reporte de Ventas. Corregido enf34d4b1.- Import de la vista:
SELECT v.pv_repdevolvía la columnapv_reppero el JS leíacodigo_pv→ todos los reportes en cero. Se resolvió con aliasAS codigo_pv.
Lección de proceso: validar sintaxis (node --check dentro del contenedor) antes de cada build, y probar todas las rutas afectadas por un reemplazo masivo, no solo la que se está cambiando.
Commits
08209ce F&F y Marketing como puntos de venta propios
838e434 tarjeta informativa de Marketing
312e748 clasificación por nota con respaldo por valor
6fca1ca F&F y Marketing en Reporte Diario y Margen
28488fc F&F y Marketing en Categoría, Subcategoría y Modelos
f34d4b1 fix: quitar pv.activo (error 500)
Pendiente
- 289 filas basura con
codigo_pv = 'undefined'(monto 0, todas de febrero). No afectan totales; se pueden borrar. - Excel con 20 columnas: revisar legibilidad de las hojas que abren una columna por tienda.
- Los PV
105(F&F) y106(MARKETING) creados antes de esta regla quedaron desactivados para no duplicar filas.
Correcciones manuales y exclusiones (2026-11-12)
ordenes_excluidas(tipo, odoo_order_id, motivo): el sync (backend/src/sync/sync.js) filtra esos ids antes del delete+insert. Hoy contiene('sale', 8), porque el pedido S00008 se reemplazó por las líneas de la factura FFI-00000024.comisiones_excluidas(comprobante, motivo):reporteComisiones.jsaplicaNOT INen el bloque corporativo. Hoy contieneFFI-00000024(Patricia no comisiona).- Ojo:
odoo_order_idse repite entresaleypos. TodoDELETEdebe filtrarodoo_order_type; sin eso se borran ventas POS ajenas (pasó con CUSCO PLAZA - 000003 y se restauró desde respaldo). - Respaldos del día:
hoseg.db.20261112_102322yhoseg.db.20261112_111403.