Mi Punto de Venta

Aplicacion web para operacion de inventario, compras, movimiento de materiales, usuarios y punto de venta de La Carreta.

Stack

• React 19
• Vite
• Supabase
• Supabase Edge Functions

Modulos principales

• Materiales
• Proveedores
• Entrada por compra
• Movimiento de materiales
• Reportes
• Punto de venta
• Usuarios

Estructura importante

• src/: frontend de la aplicacion
• src/api/: servicios cliente para Supabase y Edge Functions
• src/pages/: pantallas principales
• supabase/migrations/: historial principal de cambios de base de datos
• supabase/functions/: Edge Functions desplegadas en Supabase
• sql/: scripts manuales o historicos de apoyo
• scripts/apply-supabase-sql.ps1: runner para ejecutar SQL remoto por ambiente

Ambiente local

Frontend local:

npm install
npm run dev

Validaciones:

npm run lint
npm run build

Variables de entorno

Desarrollo y produccion usan configuracion separada.

Archivos locales no versionados:

• .env.development.local
• .env.local o .env.production.local

Consulta ENVIRONMENT.md para la configuracion de frontend y conexiones SQL remotas.

Consulta tambien HOMOLOGACION_DEV_PRD.md para la guia de homologacion estructural y funcional entre desarrollo y produccion.

Consulta tambien SUPABASE_EDGE_FUNCTION_AUTH.md para el patron obligatorio de autenticacion y despliegue de Edge Functions.

Consulta tambien RELEASE_PRD_CASH_CONTROL.md para el checklist operativo de paso a produccion del modulo de caja.

Consulta tambien REGISTRO_CAMBIOS.md para la bitacora unica de cambios y liberaciones del proyecto.

SQL remoto por ambiente

Desarrollo:

npm run supabase:sql:dev -- -File sql/dev/tu-script.sql

Produccion:

npm run supabase:sql:prod -- -File sql/prod/tu-script.sql -AllowProduction

Notas operativas

• las Edge Functions protegidas deben usar requestClient con publishable key y adminClient con service role key
• las Edge Functions protegidas deben desplegarse con --no-verify-jwt si el proyecto usa tokens ES256
• scripts/refresh-dev-core-data-from-prod.ps1 esta pensado como reset controlado de DEV y tambien restaura el POS de desarrollo a 3 barras + 12 mesas
• no asumas que ese refresh preserva pedidos abiertos o estado operativo previo en DEV

Regla de mantenimiento

• cambios permanentes de esquema: supabase/migrations/
• cambios de logica backend en Supabase: supabase/functions/
• scripts puntuales por ambiente: sql/dev/ y sql/prod/