Sistema de Gestión — Cooperativa Mercado San Miguel
Gestión integral de la cooperativa: clientes, facturación mensual automática,
cobranza con imputación por prioridad, cheques, cajas con arqueo automático,
tesorería, energía, gastos, reportería y portal del socio.
El principio rector: el dato entra una sola vez — el cobro en el puesto, la
lectura del medidor, el gasto — y el sistema imputa, arquea y reporta solo.
Arrancar
pnpm install
pnpm dev
Abrí http://localhost:3000. Las credenciales de Supabase ya están en .env.local.
Usuarios
Se entra con el DNI y la contraseña. Los usuarios los crea el Líder de Procesos
(equipo) o Administración (socios) desde Configuración → Usuarios. El
superadministrador del sistema (se marca solo desde la base, perfiles.superadmin)
puede ver y operar el sistema con cualquier rol desde el selector "Ver el sistema
como", incluido el portal de un cliente en vista previa de solo lectura.
Arquitectura
- Next.js 16 (App Router, Server Components, Server Actions,
proxy.ts) +
Tailwind v4 + shadcn/ui. Tipografías: Archivo (Omnibus-Type) y Big Shoulders
Stencil para los códigos de concepto.
- Supabase: Postgres + Auth + Storage. RLS estricta en todas las tablas;
el socio solo ve lo suyo; tesorería es invisible para administración.
- Multitenant: todo cuelga de
organizaciones (org_id) — listo para
venderle el mismo sistema a otro mercado.
- La lógica de negocio vive en Postgres (funciones
security definer con
chequeo de rol): generación mensual idempotente, imputación de pagos por
prioridad con descuento por pronto pago, arqueo de caja, validación de
tesorería, flujo de caja y reportería. El frontend nunca la reimplementa.
- Migraciones en
supabase/migrations/ (0007–0008 = fase 2), seed reproducible en supabase/seed.sql + supabase/seed_fase2.sql.
Configuración pendiente para producción
SUPABASE_SECRET_KEY en .env.local (solo servidor) para crear accesos de
socios desde Configuración → Usuarios.- Revisar los supuestos declarados al final de
PRODUCT.md con Franco
(precios reales, regla exacta del descuento, orden de imputación).
- Cargar los clientes reales y los saldos iniciales de tesorería.
Documentos
PRODUCT.md — verdad del producto y supuestos.DESIGN.md — sistema visual (mundo "etiqueta de cajón de mercado").docs/GUIA-MODULOS.md — contrato técnico para extender el sistema.docs/FASE2-CONTRATO.md — lo nuevo de la fase 2 (roles, tablas, RPCs, regla de aprobación, rutas).docs/reunion-2026-07-24.md — transcripción de la reunión de requerimientos.docs/codigos-conceptos.md — códigos oficiales de la cooperativa.
