CVMI Ventas — Registro de ventas + inventario (Zephyra & Cyclofun)
Registrado: 2026-08-25 · Empresa: CV Multi Inversiones EIRL · Estado: ✅ EN PRODUCCIÓN
URL: https://ventas.disoftx.solutions · Servidor: Zeta (contenedorcvmi-ventas, redcaddy_net)
Qué es
Mini-CRM de ventas para Zephyra y Cyclofun: registrar ventas (canal: Falabella/WhatsApp/Presencial/Web), descuenta stock automáticamente en WooCommerce de ambas tiendas, dashboard con métricas, usuarios con login (Daniel + Cindy).
Stack / Arquitectura
- Node.js + Express + mysql2 (contenedor Docker
cvmi-ventas, puerto 3000 interno) - BD propia:
crm_cvmien MariaDB dezephyra_db(usuariocvmi_app@ 172.18.0.%) - Sync de stock: UPDATE directo a
zephyra_wordpressycyclofun_wordpress(tablaswp_postmeta+wp_wc_product_meta_lookup) — mismo patrón del update manual - Caddy:
ventas.disoftx.solutions→cvmi-ventas:3000(site filesites/ventas.caddy) - Credenciales BD: usuario
cvmi_app(pass en.envdel proyecto en Zeta:/home/opsmgr/proyectos/cvmi-ventas/.env)
Datos de acceso app
- Daniel (admin): daniel@disoftx.solutions / Zephyra2026!Cambia — ⚠️ cambiar
- Cindy Verde (user): cverde@cvminversiones.pe / Cindy2026!Cambia — ⚠️ cambiar
- Usuarios se crean desde pestaña Usuarios (admin); pestaña Usuarios solo visible para admin
API (para Nexus)
POST /api/login→{token}(headerx-session-tokenpara el resto)POST /api/service/sales— headerx-api-token: cvmi_ventas_service_2026_nexus- Body:
{sku, price, qty, channel_id, commission_pct?, boleta(OBLIGATORIO), notes?, sale_date?, apply_stock?} apply_stock:false= registrar sin tocar stock (backfill)GET /api/stats?month=YYYY-MM·GET /api/sales?month=·GET /api/products?q=·POST /api/sync-products
Canales (comisión % por defecto)
- Falabella: 15% (rango real 8–25% según categoría — Daniel debe confirmar su % en Seller Center)
- WhatsApp / Presencial / Web: 0%
Flujo WhatsApp (Nexus)
Daniel escribe la venta → Nexus llama POST /api/service/sales con apply_stock:true → registra + descuenta stock en la tienda correcta → confirma a Daniel con neto y stock.
🔐 Seguridad / endurecimiento ✅ (2026-08-25)
- Rate limiting: 300 req/min por IP global en /api; login: 10 intentos fallidos → bloqueo 15 min (429)
- Headers: CSP, HSTS (includeSubDomains), X-Frame-Options DENY, X-Content-Type-Options nosniff, Referrer-Policy no-referrer, Permissions-Policy
- Errores 500 genéricos ("Error interno"); detalles solo en consola
- Sesiones expiran a 30 días (WHERE created_at > NOW() - INTERVAL 30 DAY) + limpieza en boot
app.disable("x-powered-by"),trust proxy 1(Caddy), body limit 100kb- Contraseñas rotadas 2026-08-25 →
credentials/cvmi-ventas.json(chmod 600) - ⚠️ El contenedor se actualiza con
docker cp+docker restart(no hay bind mounts) — al recrear el contenedor se pierden cambios de código - Service token
/api/service/sales: sin rotar (solo en archivos privados); rotar si se expone
🗄️ Backup
- crm_cvmi incluido en
backup_zeta.sh(sección 3.1): mysqldump vía TCP a IP de zephyra_db (cvmi_app no tiene acceso localhost) → gzip en tar diario 3am + subida Drive - Pendiente histórico: cuota Google Drive 106/15 GiB (bloquea subidas) — decisión de Daniel pendiente
Ventas registradas
- 2026-08-25: Denim Chunky Black - 37 (SKU 240602420423061524), Falabella, S/149, com 15% (S/22.35), neto S/126.65 — Boleta EB01-86 ✅ (registrada 2026-08-25)
- 2026-10-12: Bicicleta de Balance Jungle Kids - Rosado (SKU 240501010101020105), Falabella, S/329.90 (sin IGV S/279.576), com 15% (S/49.48), neto S/280.42, cliente Cesar Vargas Barahona (DNI 40544265), orden Falabella 5006495148 — Boleta EB01-87 ✅ (registrada 2026-10-13,
apply_stock:falseporque el sync ya bajó el stock 2→1)
UI: pestañas por marca en inventario ✅ (2026-08-25)
- Pestaña Productos: dropdown de tienda reemplazado por pestañas (Todas / Zephyra / Cyclofun)
- Filtro vía
GET /api/products?store=(ya existía). Frontend enpublic/index.html→docker cpal contenedor (sin rebuild). ⚠️ Al recrear el contenedor se pierde el cambio si no se rebuilda la imagen.
Pendientes
- [x] Usuarios creados: daniel@disoftx.solutions (admin) + cverde@cvminversiones.pe (Cindy Verde) ✅ 2026-08-25
- [x] Campo N° de boleta obligatorio en ventas ✅ 2026-08-25
- [x] Lista de productos ampliada a 500 (Cyclofun visible) ✅
- [x] N° de boleta de la venta del 25/08 (backfill) ✅ EB01-86
- [ ] Confirmar % comisión real de Falabella
- [ ] Reporte mensual automático por WhatsApp (opcional, cron)
- [ ] Retirar contenedor viejo
crm_zephyra_api(obsoleto, solo 3 orders de prueba) — con OK de Daniel