closetai：面向墨西哥的 AI 个人造型师应用

Estilista personal con IA para México. Fotografías tu ropa, la IA arma tus outfits, te los muestra puestos sobre tu propia foto y aprende tus gustos.

Fuente única de verdad: docs/DOCUMENTO-MAESTRO.md. Todo lo que contradiga ese documento está mal.

🌐 En vivo

https://closetai.lat · deploy automático desde main en Vercel

Estado

Las cuatro semanas están terminadas. El producto completo está en vivo.

Módulo	Estado
M1 · Cuentas y perfil	✅ registro, entrada, recuperación, rutas protegidas, tallas, borrado real de cuenta
M2 · Clóset digital	✅ subida por lotes, compresión a WebP, catalogación con IA, filtros, corrección manual
M3 · Estilista IA	✅ arma outfits con la ropa real, explica el porqué, usa el clima del día
M4 · Aprendizaje de gustos	✅ perfil de estilo con evidencia y confianza, editable · cron diario
M5 · Avatar y try-on	✅ foto base validada por IA · recorte de fondo · render con FASHN
M6 · Recomendaciones	✅ análisis de huecos conservador · enlaces con divulgación de comisión
M7 · Pagos	✅ Checkout + webhook firmado · idempotente · desbloqueo de $100 MXN
M8 · Panel admin	✅ gasto del día, uso por módulo, interruptor de try-on

Infraestructura

Pieza	Estado
Sitio en vivo	✅ closetai.lat con HTTPS
Repo + CI	✅ vestiamx-code/closetai
Base de datos	✅ `closetai-prod` · 13 tablas con RLS · 3 buckets privados
Catalogación con IA	✅ `gemini-3.5-flash-lite` verificado contra el modelo real
Pagos (Stripe)	✅ en modo prueba · falta borrar 2 endpoints viejos de webhook (ver PENDIENTES)
Pruebas	✅ 14 unitarias · 19 e2e (perfil móvil) · 5 pruebas contra APIs reales tras `PRUEBAS_VIVAS=1`
Variables en Vercel	✅ las 23 cargadas en producción y preview
Recorte de fondo (BiRefNet)	✅ vía fal.ai
Correos propios (Resend)	✅ configurado

Pendientes: PENDIENTES.md · Runbook: docs/SETUP-CUENTAS.md

Desarrollo

pnpm install
pnpm dev          # http://localhost:3000
pnpm test:unit    # Vitest
pnpm test:e2e     # Playwright (perfil móvil)
pnpm typecheck    # next typegen + tsc

node scripts/sembrar-demo.mjs   # cuenta de demostración con prendas catalogadas
node scripts/capturas.mjs       # capturas para la evidencia de la rúbrica

Nota de versión: este proyecto usa Next.js 16, donde middleware.ts está deprecado y se llama proxy.ts. La documentación de la versión instalada vive en node_modules/next/dist/docs/ — léela antes de escribir código.

Stack

Next.js 15 (App Router) · Tailwind v4 + shadcn/ui · Supabase (Postgres + Auth + Storage) · Vercel · Stripe MX · Gemini 2.5 · fal.ai (BiRefNet + FASHN) · Resend · Sentry. Justificación de cada elección: §4.1 del documento maestro.

Estructura

docs/            documento maestro + evidencia de rúbrica (§7)
supabase/        migraciones SQL versionadas (001-004, aplicadas)
scripts/         herramientas de desarrollo (sembrar demo, capturas)
src/
  app/(auth)/    registro, entrada, recuperación
  app/(app)/     clóset, prenda, perfil — todo detrás de sesión
  lib/ai/        adapter de Gemini + contratos de salida
  lib/supabase/  clientes navegador / servidor / servicio
  proxy.ts       sesión y protección de rutas (Next 16)
e2e/             Playwright

Convenciones

Rama main protegida y siempre deployable. Ramas feat/*, fix/*.
Commits convencionales en inglés (feat: garment batch upload); producto y docs en es-MX.
Toda tabla nueva nace con RLS activada y política owner-only.
Las API keys viven en .env.local y en Vercel env vars. Nunca en el repo, nunca en el cliente.