Joyería ARIGA - Registro de ventas (Supabase)

Réplica de la aplicación de Apps Script "Aplicación Ariga", usando Supabase (esquema tiendaariga) en lugar de la hoja "Registro de ventas 2do".

Estructura

Archivo	Qué es
index.html, css/estilos.css, js/app.js	La aplicación web (equivale a Index.html + CSS.html + Código.gs)
js/config.js	URL de Supabase, clave publicable y esquema
supabase/01_esquema.sql	Tablas, vistas, funciones y seguridad
supabase/02_datos_*.sql	Datos del Excel (generados)
scripts/generar_datos_sql.py	Regenera 02_datos_*.sql desde el Excel

Pestañas

Venta, Buscar Pedido, Pagos, Clientes, Histórico, Cartera, Inventario, Maestros y, solo para administradores, Usuarios y Datos.

• Clientes: cada cliente tiene un código automático (consecutivo único, clientes.id). Ficha con DPI, NIT, teléfonos, correo, dirección y departamento. Al crearlo se puede indicar un saldo pendiente inicial, que queda como una venta "SALDO INICIAL" (envío SI-<código>).
• Venta / Pagos / Estado de cuenta: buscador de clientes por código, nombre, DPI, NIT o teléfono (muestra la lista si hay varios).
• Buscar Pedido: por envío, Id de pedido, nombre o código del cliente; la lista muestra la fecha de venta. Al abrir un pedido se ve su fecha.
• Pagos: el pago es un abono al total del cliente (opcionalmente aplicado a un envío). Muestra cuánto debe y cómo queda tras el pago. Pagos Recibidos: filtro por fechas, método, usuario y cliente, con totales por método de pago y por usuario (para saber cuánto hay que liquidar).
• Cartera: Saldos por Cliente, Estado de Cuenta (compras, pagos y saldo acumulado) y Por Envío.
• Histórico: incluye el código del cliente y se puede filtrar por él.
• Inteligencia: cartera por cobrar, gramos disponibles en todas las bodegas (por tipo y por bodega, más los que están en tránsito) y precio promedio del gramo vendido (general y por tipo, con periodo), con su evolución mensual.
• Inventario → Traslados: la bodega origen envía (sale de su inventario) y la destino recibe (entra al suyo); aviso de traslados por recibir; se pueden anular o rechazar mientras están en tránsito.
• Maestros: tiendas, bodegas, vendedores, métodos de pago, tipos y departamentos (agregar, activar/desactivar, eliminar si no están en uso).
• Todas las listas desplegables de los formularios terminan con + Crear nuevo….
• Histórico, Cartera, Pagos Recibidos, Clientes, Inventario y Datos tienen Exportar a Excel (exporta lo filtrado en pantalla).

Inventario

• Referencias: la tabla productos es el catálogo de referencias (nombre, código, tipo, unidad, controla inventario, activa). Solo las activas aparecen al vender. El nombre no se puede cambiar porque las ventas lo guardan.
• Cargar inventario: entradas (compras, inventario inicial, traslados) y salidas/ajustes por tienda y referencia (tabla ingresos_inventario).
• Saldos (vista inventario): entradas − (ventas + salidas + devoluciones a oficina), por tienda y referencia o total por referencia.
• Movimientos (vista inventario_movimientos): kardex con saldo acumulado.
• Cada tienda/referencia descuenta ventas desde su fecha de inicio: la de la hoja original (inventario_items) o, si no tiene, la de su primera carga.
• Al registrar una venta nueva, si no hay saldo suficiente la app avisa y pide confirmación (no bloquea).

Hojas → tablas

Hoja	En Supabase
Maestros	tiendas, tipos, vendedores, productos, metodos_pago
Clientes	clientes
Ventas	ventas
Pagos	pagos
Devoluciones	devoluciones
Ingresos de inventario	ingresos_inventario
Devolución a oficina	devoluciones_oficina
Coordenadas	coordenadas
Cartera 1	vista cartera_detalle (por envío)
Cartera 2	vistas cartera_clientes y estado_cuenta (por cliente)
Inventario	tabla inventario_items (tienda, producto y fecha de corte) + vista inventario

Funciones: buscar_clientes, crear_cliente, registrar_venta (genera el Id yyyyMMdd-NNN), actualizar_venta, eliminar_pedido, buscar_pedidos, lineas_pedido, vincular_clientes, admin_agregar_usuario y hacer_admin. Usuarios: tabla perfiles. Pagos recibidos: vista pagos_detalle.

Instalación

1. Crear o actualizar la base: en Supabase → SQL Editor, ejecutar supabase/01_esquema.sql. Se puede repetir sin perder datos.
2. Cargar datos del Excel (solo la primera vez): ejecutar en orden 02_datos_1.sql … 02_datos_7.sql. El primero vacía las tablas. El último vincula ventas y pagos importados con su cliente (vincular_clientes()).
3. Exponer el esquema: Project Settings → Data API → Exposed schemas debe incluir tiendaariga.
4. Actualizaciones: ejecutar en orden los scripts 03_…, 04_… de supabase/ (ver Actualizaciones de la base).
5. Administrador inicial: lo crea 03_usuarios_y_pedidos.sql: usuario admin, contraseña admin123. Cámbiela al entrar (botón Contraseña de la barra superior). Los vendedores se crean desde la pestaña Usuarios con usuario y contraseña; no se necesitan correos ni configurar el envío de correos de Supabase.
6. Publicar la web: ver Despliegue en Vercel. Para probar en local: npx serve . y abrir http://localhost:3000.

Actualizaciones de la base

01_esquema.sql es la base inicial. Cada cambio posterior va en un script propio y numerado, que se ejecuta una vez en el SQL Editor, en orden, y se puede repetir sin dañar datos: (si se vuelve a ejecutar uno anterior, hay que volver a ejecutar también los siguientes, porque algunos reemplazan funciones de los anteriores)

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