Tiki
MVP armado para Shippear 3.0 (Rosario, 24 de octubre de 2026). Publicás un plan, lo compartís por WhatsApp o con un QR y se suma gente que no conocés pero tiene ganas de lo mismo. Cuando llegás al plan y te encontrás con otra persona del grupo, ganás puntos para canjear por descuentos en negocios asociados.
Qué hace
- Armar un plan (con cuenta). Quien organiza crea una cuenta con usuario y contraseña, sin mails ni confirmaciones. Carga qué es, dónde (con sugerencias de direcciones y mapa de Google), día, horario, cupo fijo o sin límite y una descripción opcional. Nombre y teléfono se piden la primera vez y quedan en la cuenta.
- Sumarse sin cuenta. Desde el link o el QR, con nombre y teléfono. Si el navegador ya se anotó antes, se suma en un toque.
- Compartir por WhatsApp. El plan arma el mensaje con el link listo para mandar; también se puede copiar el link o usar el menú de compartir del celular.
- Encuentros. Desde 2 horas antes del plan, quien se sumó ve el botón Llegué. Ahí tiene su QR, que cambia cada 30 segundos, y un botón para escanear el de otra persona del plan. Alcanza con que escanee uno de los dos para que la llegada quede confirmada para ambos. El primer encuentro da 50 puntos a cada uno y cada persona nueva que conocés después suma 10, hasta 5. Las dos pantallas muestran la misma pregunta para arrancar la charla. Quien organiza participa como cualquier otra persona. Si alguien escanea el QR con la cámara del teléfono en lugar de hacerlo desde Tiki, se abre una página para confirmar el encuentro.
- Puntos. Se ganan en los encuentros; sumarse a un plan no da puntos. En Puntos están el saldo, los movimientos y los beneficios. El canje descuenta los puntos y genera un código de 6 letras que vence a los 30 minutos; la pantalla del código tiene un reloj en vivo, porque en una captura vieja la hora queda congelada.
- Pantalla para proyector. En
/e/<código>/pantalla: QR grande y contador de gente anotada que se actualiza solo cada 3 segundos. Cuando empiezan los encuentros, muestra también cuántas personas llegaron y cuántos encuentros hubo.
- Tiki en Claude (MCP). En
https://planes-mvp.vercel.app/api/mcp, sin cuenta: buscar planes, ver uno y sumarse con nombre y celular. Para crear un plan, Claude devuelve un link a /crear con el formulario completo, y ahí Tiki pide iniciar sesión. La portada tiene un botón Conectar con Claude que abre el formulario de conector de claude.ai con todo cargado. El diseño está en docs/mcp.md.
Todos ven todos los planes. La identidad visual sigue el template Next.js boilerplate de v0: fondo casi negro, rojo como color principal, Montserrat en los títulos e Inter en el texto.
Correr en local
Hace falta Node 20 o más nuevo y Docker.
npm install
cp .env.example .env.local
docker compose up -d
npm run db:reset
npm run dev
La app queda en http://localhost:3000.
Para probar el QR con el celular, abrí la app desde la compu con su IP de la red wifi (por ejemplo http://192.168.0.15:3000): el QR y los links usan la misma dirección con la que se abrió la página, así que un celular en la misma wifi los puede abrir. El navegador solo deja usar la cámara con HTTPS o en localhost, así que con la IP de la red el escáner de Llegué no abre: para probar un encuentro así, escaneá el QR con la cámara del teléfono, o usá la versión publicada.
npm run db:reset borra todo y vuelve a cargar los negocios de ejemplo de supabase/seed.sql. Para aplicar migraciones nuevas sin borrar datos: npm run db:migrate.
Con npm run dev andando, npm run test:mcp prueba el MCP con el cliente MCP oficial contra la base local. Para usarlo desde Claude Code: claude mcp add --transport http tiki-local http://localhost:3000/api/mcp.
Cómo está armado
- Next.js 16 con App Router, Server Actions y Tailwind 4. Sin librerías de componentes.
- Postgres 17. Las tablas y la lógica (sumarse, cupo, encuentros, puntos, canje, cuentas) están en funciones SQL dentro de
supabase/migrations, en un esquema app que la API de Supabase no expone: solo el servidor de Next.js accede, con la cadena de conexión. En local corre en Docker y en producción en Supabase.
- Identidad sin cuenta para sumarse. El teléfono se normaliza a formato internacional (en Argentina se asume celular con el 9). Cada navegador guarda un token aleatorio en una cookie
httpOnly y en la base queda solo su hash. El primer navegador que se anota con un número queda vinculado: desde otro navegador esa persona se puede sumar igual, pero no ve ni canjea los puntos. Así nadie usa los puntos de otra persona con solo saber su número.
- Cuenta de quien organiza. Usuario y contraseña propios (
app.accounts), con la contraseña guardada como hash scrypt y sesiones en una cookie httpOnly (en la base, solo el hash del token). La primera vez que organiza, la cuenta se vincula con su teléfono solo si ese número es nuevo o ya se anotó desde el mismo navegador. Después, entrar con la cuenta en otro celular vincula ese celular y le da acceso a sus puntos.
- Puntos en un libro de movimientos (
app.points_ledger): el saldo es la suma. La llegada a un plan se paga una sola vez (lo asegura un índice único) y cada par de personas se cuenta una sola vez por plan, en app.encounters. Si quien organiza quita a alguien del plan, se le descuenta todo lo que ganó en ese plan. El cupo, el canje y los encuentros bloquean las filas correspondientes, así dos personas no ocupan el último lugar ni gastan el mismo saldo al mismo tiempo.
- QR de encuentro firmado. El QR lleva a
/e/<código>/encuentro/<token>. El token tiene el id de la persona, la ventana de 30 segundos en la que se generó y una firma HMAC hecha con ENCOUNTER_SECRET, así que nadie puede armar uno a mano. El servidor acepta solo la ventana actual y la anterior, por eso una captura mandada por WhatsApp vence en menos de un minuto. El encuentro cuenta solo entre dos personas anotadas en el plan, desde 2 horas antes hasta 6 horas después del horario. La cámara se lee en el navegador con BarcodeDetector (Chrome en Android) o con jsQR (Safari en iPhone).
- MCP público (
src/app/api/mcp y src/lib/mcp), con mcp-handler y Streamable HTTP sin estado. Lee con el rol de Postgres , que solo ve las columnas públicas y no puede escribir; la única escritura es sumarse, con la misma función SQL que la web. Cada pedido queda en (sin nombres ni teléfonos) y pasa por un límite por IP.
Google Maps con API key
Con un proyecto de Google Cloud (facturación activada y una API key restringida al dominio de la app) se puede:
- Cambiar el mapa embebido por la Maps Embed API oficial, en
src/lib/maps.ts.
- Cambiar las sugerencias de direcciones por Places API (New), en
src/app/api/places/route.ts. El formulario solo habla con esa ruta, así que el cambio queda acotado ahí.
Pasar a Supabase y Vercel
- Subir el esquema al proyecto de Supabase con
npx supabase link y npx supabase db push, o pegando en orden los archivos de supabase/migrations en el SQL Editor. Después, supabase/seed.sql con los negocios reales.
- En Vercel, cargar
DATABASE_URL con la cadena del pooler compartido (aws-1-sa-east-1.pooler.supabase.com:6543; el host db.<proyecto>.supabase.co solo funciona por IPv6 y Vercel no llega), ENCOUNTER_SECRET y MCP_LOG_SECRET con textos largos y aleatorios (en .env.example está el comando para generarlos) y, si hace falta, NEXT_PUBLIC_SITE_URL con la URL pública.
Pendientes
- Verificar el teléfono con un código por SMS o WhatsApp. Hoy se confía en el número que escribe cada persona.
- Recuperar la contraseña y limitar los intentos de ingreso.
- Panel para que los negocios den de alta beneficios y validen los códigos.
- Pedir la ubicación al confirmar un encuentro y compararla con la del lugar. Hoy dos personas que no fueron podrían mostrarse el QR por videollamada.
- Cancelar la asistencia y lista de espera cuando el plan se llena.
- Modo claro, como el template.
