🔗 Nexus

← Volver a notas
86 KB 12/11/2026 11:57
🔗

Hoseg Dashboard

📦 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

  1. KPIs (resumen_cards.php): VENTA TOTAL NETA, CONVERSIÓN, CUMPLIMIENTO META
  2. Reporte Diario (reporte_diario.php) — EL CORAZÓN:
  3. 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)
  4. Tabla diaria por local: VISITAS, TICKETS, PROD., VTA SIN IGV, META (diaria), % ÉXITO, T. PROM, CONV.
  5. Tabla mensual por local: META MES, VTA 2025, VTA 2026, VAR %, % CUMPL, % PROY, T. PROM, CONV., P.E., %P.E.
  6. 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)
  7. Ranking de vendedores: vendedor, venta total, % part.
  8. Venta por Categoría + desglose por POS + gráfico (CASACA 44%, CHALECO 20%, POLO 8% — jun 2026)
  9. Venta por Modelos (ANDEAN TEAL, HOODED PHANTOM, PLUM...)
  10. Margen y Contribución: por POS (venta, costo, contribución, margen %) · por categoría · por artículo
  11. 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)
  12. 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

✅ Agosto + Setiembre 2026 cargados (2026-09-15)

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)

Decisiones tomadas (2026-08-29 14:13)

  1. 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.
  2. 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.
  3. Hoseg Proyectos: NO va en el nuevo dashboard.
  4. Arquitectura (confirmada 14:19): HÍBRIDA con BD del dashboard como centro:
  5. MySQL viejo → importación ÚNICA (2024 → 19-jul-2026) a la BD del dashboard
  6. Odoo → sync periódico de solo lectura (ventas y stock cada 30 min; valorizado puede ser nocturno) a la BD del dashboard
  7. Metas (Excel) → carga mensual validada a la BD del dashboard
  8. Reportes se calculan SIEMPRE sobre la BD local (rápidos, YoY incluido). Odoo = fuente de verdad, sin escritura.
  9. Casos puntuales de tiempo real (ej: stock exacto ahora) pueden consultar Odoo en línea.

✅ Decisiones finales (2026-08-29 20:05)

✅ Fase 3 — Frontend React (2026-08-30)

✅ Fase 4 — Deploy PRODUCCIÓN (2026-08-30)

⏳ Pendientes post-deploy

📝 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)

Fijaciones transversales

Hallazgos de DATA (para validar con Odoo producción)

Infraestructura (Zeta)

GitHub

Pendientes (post-sesión)

📑 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

2) Reporte de Inventario (/reportes/inventario) — key inventario

3) Resumen de Ventas Diarias (/reportes/resumen-diario) — key resumen_diario

Infra SMTP y caché SPA

4) Reporte Detallado Mensual (/reportes/detallado) — key detallado ⭐ (2026-09-09)

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) ⭐

🧾 Auditoría data de Cindy vs dashboard (2026-09-09)

Pendientes (2026-09-08/09)

🔧 Fix descuadre Reporte Diario vs Venta por Categoría (2026-09-09)

🔧 Fix Margen y Contribución: totales (2026-09-09)

📊 Reporte de Comisiones (2026-09-09) — nuevo

👤 Usuarios y permisos por menú (2026-09-09) — nuevo


📱 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)

Requisitos / costos / riesgos

Pasos propuestos (cuando se retome)

  1. Decidir stack (Capacitor sobre el frontend React actual) y features nativos mínimos.
  2. Crear cuenta Apple Developer + registrar la app en App Store Connect.
  3. Generar builds (Android AAB + iOS IPA) con Codemagic.
  4. Android → pista cerrada con los correos de Hoseg/Cindy. iOS → solicitar unlisted y compartir link.
  5. Documentar aquí el link privado y los correos autorizados.

🔧 Fix "Notas por producto" / "Notas del pedido" en el Reporte de Ventas (2026-09-10)

📊 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)

3) 📲 Aviso de VENTAS DEL DÍA por WhatsApp (cron de Nexus) — NUEVO

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)

⏳ Pendientes / decisiones abiertas

⚙️ Configuración — Punto de venta POP UP desactivado (2026-09-13, 23:10)

✅ Subcategorías + desglose jerárquico (2026-09-14)

✅ Venta por Modelos — desglose por PV interno (2026-09-14)

✅ Pestañas D2C | Wholesale (2026-09-14)

✅ Pestaña Corporativo (2026-09-14)

✅ Venta por Categoría: doble gráfica YoY (2026-09-14)

✅ Configuración → Costos de productos (2026-09-14)

✅ Opción C — costo efectivo unificado (2026-09-14)

✅ Fix sync rodante + recarga orden (2026-09-14)

⚠️ Resumen Diario — rebotes de destinatarios (2026-09-17)

✅ Corrección (2026-09-17 ~12:00)

✅ Renombre de etiquetas en notas/promociones (2026-09-21)


📊 Sesión 2026-09-21 — Venta Promociones con datos Odoo + Corrección de promociones ⭐

1) Venta Promociones ahora cuadra con el Reporte de Ventas

2) Filtro GLOBAL único (fecha/semana)

3) Corrección de promociones (supervisoras) — dentro de Configuración

Deploy (recordatorio)

🆕 Menú «Inventario» (2026-09-27)

🏷️ 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

🚚 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)

Proveedor — fix permisos (2026-09-27, commits e269c9b + d29b3cc)

UI general — sidebar y footer (2026-09-27, commit e05df35)

🔎 Conversión de setiembre al ~32% — diagnóstico (2026-09-27)

📊 Promociones: la nota del cajero (Odoo) ahora llena "Venta Promociones" (2026-10-06) ⭐

🔐 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)

Corrección (2026-10-13 ~09:20)

🧥 Sesión 2026-10-15 — Venta por Subcategoría, rediseño Proveedor y "meses venta" ⭐

1) Venta por Modelos — jerarquías (commits 712b7de, 51fa9e2)

2) Marcas auto-sincronizadas desde Odoo (commit 6f6bf00)

3) Nuevo menú «Venta por Subcategoría» (commit 4c1333a, fix ed18afc)

4) Orden de menús (commit d4e7b51)

5) Módulo Proveedor — rediseño (commit beea876)

6) Proveedor — columnas de stock/rotación (commit 9ae3b9c)

7) Fix «meses venta» en nodos agregados — Proveedor y Valorizado (commits 8bea57a, ecd45fa)

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

Pendientes del ciclo

  1. Enviar el correo a Mariale (borrador aprobado, formato "monto correcto + cuadro de conciliación por punto"). Falta enviarlo.
  2. 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.
  3. Muestras B2B por POS: si alguna muestra se emite como boleta, el enlace por invoice_origin no funciona; habría que resolver por pos.order.
  4. 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.
  5. 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

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)

  1. 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.
  2. CREATE OR REPLACE VIEW: no existe en SQLite. Se cambió a DROP VIEW IF EXISTS + CREATE VIEW.
  3. pv.activo residual: tras migrar las consultas a pv_reporte, quedaron 12 filtros pidiendo una columna inexistente → error 500 en Reporte de Ventas. Corregido en f34d4b1.
  4. Import de la vista: SELECT v.pv_rep devolvía la columna pv_rep pero el JS leía codigo_pv → todos los reportes en cero. Se resolvió con alias AS 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

Correcciones manuales y exclusiones (2026-11-12)