Vamos feo pa'lante 🤙
La libreta de cuentas de los panas: cada vez que salen, una salida con quién fue, cuánto fue, quién puso la plata y quién ya pagó. Hecha para la realidad venezolana: dólares, bolívares, euros y USDT con la tasa del día, pago móvil y compras con Cashea.
Qué hace
- Salidas paso a paso: qué fue (una o varias categorías), quiénes fueron, cuánto fue, quién puso la plata y cómo se divide (partes iguales, montos, porcentajes, por partes o por consumo, con servicio e IVA).
- ¿Quién ya pagó?: cada pana ve lo que debe y a quién; el que cobra confirma cada pago.
- Pagos guiados: los datos de pago móvil, Zelle o Binance del que cobra, con el monto exacto en Bs y botones para copiar en el formato que piden los bancos. Se puede adjuntar la captura del pago.
- Tasas: BCV ($ y €) y USDT (mediana de Binance P2P), guardadas a diario.
- Cashea: planes con inicial y cuotas cada 14 días. En modo espejo cada pana paga su parte al ritmo de las cuotas y la app le muestra su próxima cuota.
- Avisos: campanita y notificaciones push (también en iPhone con la app en inicio), recordatorio diario de deudas y cuenta regresiva de cuotas.
- IA (Claude): escanea la factura y arma la cuenta preguntando quién pidió qué; lee la captura del pago y revisa que el monto y el destino cuadren.
- Panel del administrador: quién tiene los avisos activos, consumo de IA y el cuadre de cada salida vista como cualquier participante.
- Solo por invitación: registro con un link de invitación; borrar la cuenta la elimina de verdad.
Stack
Next.js 16 (App Router, server actions) · React 19 · TypeScript · Tailwind CSS 4 · Drizzle ORM sobre Postgres (Neon en producción, PGlite en local) · web-push · Anthropic SDK · desplegada en Vercel con cron jobs.
Correr en local
npm install
echo "DB_DRIVER=pglite" > .env.development.local
npm run dev
En local la base es PGlite (Postgres embebido en .pglite/) y las migraciones de drizzle/ se aplican solas. El primer usuario que se registra es el administrador y puede registrarse sin invitación.
Variables de entorno
| Variable | Para qué |
|---|
DATABASE_URL, DATABASE_URL_UNPOOLED | Postgres de producción (Neon) |
DB_DRIVER=pglite, PGLITE_DIR | Base local embebida |
CRON_SECRET | Protege los cron de tasas y avisos |
NEXT_PUBLIC_VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY, VAPID_SUBJECT | Notificaciones push |
GMAIL_USER, GMAIL_APP_PASSWORD | Correos de "olvidé mi contraseña" |
ANTHROPIC_API_KEY, ANTHROPIC_WORKSPACE_ID, ANTHROPIC_MODEL | Funciones de IA (opcionales) |
Sin las claves de IA, push o Gmail la app funciona igual: esas funciones simplemente no aparecen.
Scripts
| Comando | Qué hace |
|---|
npx tsx scripts/probar-logica.ts | Pruebas de la lógica de dinero, cuotas, cuadre y recordatorios |
npx drizzle-kit generate --name <nombre> | Nueva migración desde lib/db/schema.ts |
npx tsx scripts/migrar.mts | Aplica las migraciones en Neon |
npx tsx scripts/revisar-cuadre.mts | Revisa (solo lectura) que todas las salidas cuadren |
npx tsx scripts/generar-iconos.mts | Regenera los íconos PNG de la app |
bash scripts/configurar-ia.sh | Guarda la API key de Claude sin mostrarla |
Estructura
app/ — páginas ((app) con sesión, (auth) sin sesión), server actions y rutas de API (cron, fotos, comprobantes).components/ — interfaz (asistente de salidas, lista de quién pagó, Cashea, avisos…).lib/ — lógica: dinero en centavos, repartos, saldos, tasas, Cashea, recordatorios, IA y base de datos.drizzle/ — migraciones SQL.scripts/ — pruebas y utilidades.
Todo el dinero se guarda en centavos enteros; cada cuenta guarda la tasa con la que se anotó.
