Efficommerce — Sistema de Logística Interna

Suite web para gestión de inventario, etiquetas de bodega, almacén físico, manifiestos, alistamiento, devoluciones, conteos de mercancía y trazabilidad. Todo centralizado en una sola base de datos de tiendas y productos.

Frontend: HTML/CSS/JS vanilla (sin frameworks, sin build ni bundler) Backend: Vercel Serverless Functions (Node.js ESM) Base de datos: Supabase PostgreSQL (30 tablas) + Supabase Storage (fotos de conteos y recepciones) Deploy: Vercel (producción automática desde main)

---

Módulos

Cada módulo es una página independiente (HTML + JS + CSS propios). Solo comparten el código de public/shared/. Todos se abren desde el menú lateral del generador de etiquetas.

1. Generador de Etiquetas y Panel de Coordinador (/)

• Selección de tienda y producto con búsqueda en tiempo real
• Vista previa en formato 4×6" con actualización en vivo
• Cuatro formatos: Estándar, Solo Observaciones, Frágil y Numeración (hoja de corte)
• QR de ubicación física (activable/desactivable por el coordinador)
• Impresión individual y masiva por tienda
• Rótulo A4 horizontal para identificación de estanterías
• Logo de etiqueta y logo de rótulo personalizables (guardados en Supabase)
• Panel de Coordinador (requiere login), con pestañas:
  • Agregar Producto, Nueva Tienda, Gestionar Inventario — CRUD de tiendas y productos
  • Configuración — logos, QR de ubicación, "Imprimir por grupo" de Alistamiento, mostrar/ocultar los botones Gestión de Devoluciones y Trazabilidad del menú, decoración de temporada, cambio de contraseña, importar JSON
  • Usuarios — listar, crear y eliminar coordinadores
  • Devoluciones — guías devueltas por día, semana y mes
  • Conteos — consulta, traslado, exportación y sincronización con Google Sheets de los conteos
  • Impresión — estación de impresión automática de etiquetas de conteos
• Decoración de temporada (solo en pantalla, nunca se imprime): auto (Halloween del 1 de oct al 2 de nov, Navidad del 3 de nov al 6 de ene), halloween, navidad o ninguna

2. STOCKFORGE — Gestión de Almacén (/stockforge/almacen4.html)

• Mapa visual del almacén con racks, zonas y celdas
• Asignación de SKUs desde el catálogo real de productos por tienda
• Al escribir el código del producto, autocompleta el nombre desde la BD
• Al guardar, actualiza automáticamente productos.ubicacion → el QR de la etiqueta se actualiza solo
• Traslados de SKU entre celdas con registro de movimientos
• Reportes por SKU, celda, zona, responsable, vencimiento y movimientos
• Snapshots del inventario (hasta 7 rotantes)
• Modo Coordinador con login por email/contraseña (mismo usuario que el generador de etiquetas, pero sesión independiente). Editar y guardar exige el permiso "Editar y guardar el almacén" más "Nueva Tienda" y "Gestionar Inventario" (por defecto: administrador y coordinador sí, bodeguero no); sin ellos el mapa se ve en solo lectura. Cada guardado queda en la bitácora
• Sin sesión, el mapa se muestra sin los costos de los SKUs
• Defectos conocidos, pendientes de rework antes de un uso intensivo: el historial guarda solo los últimos 500 movimientos, el último guardado borra los cambios de otros usuarios, una tienda creada desde StockForge y asignada antes de recargar bloquea los guardados, y dos guardados seguidos desde el mismo navegador pueden aplicarse en orden inverso
• Botón Limpiar Cantidades para resetear stock sin borrar productos
• Soporte bilingüe (ES / EN) y tres temas visuales (Oscuro, Claro, Daltónico)
• Importación masiva desde Excel/CSV

3. Manifiestos (/manifiesto/manifiesto.html)

• Comparativo de manifiestos de envío contra las guías leídas con pistola
• Avance guardado en localStorage (hasta 24 h): si la pestaña se recarga o se cierra, se ofrece continuar donde se quedó
• Protecciones contra la pistola: el Enter del lector no confirma modales que cambian datos (marcar, borrar historial, exportar, reemplazar avance)
• Exportación a Excel

4. Alistamiento (/alistamiento/alistamiento.html)

• Cruza un Excel de alistamiento (guías que se despachan) con un PDF que contiene todas las etiquetas de guías
• Genera un PDF filtrado solo con las páginas de las guías presentes en el Excel (copia las páginas originales con pdf-lib, sin regenerarlas)
• Impresión por guía y orden "Agrupar por producto"; el botón Imprimir por grupo se habilita o deshabilita desde Configuración
• Todo corre en el navegador, sin backend

5. Devoluciones (/devoluciones/devoluciones.html)

• Gestión de devoluciones y generación de guías de courier
• Al pulsar "Exportar devueltas", las guías marcadas se registran en la tabla devoluciones_registro con la fecha del día. El conteo por día/semana/mes se consulta en el Panel de Coordinador, pestaña "Devoluciones"
• El botón del menú lateral está oculto por defecto; se activa en Configuración

This is the beginning of the README. Read the rest at the original. Read the full README ↗