SP Documentos

Plataforma para obtener la documentación de una propiedad en Chile (informe de títulos y saneamiento) y generar el borrador del informe con IA.

Este repositorio contiene el MVP (fase 1): cuentas, onboarding particular/empresa, selección de trámite, región, comuna y rol, catálogo de documentos con precios, selección del informe y checkout con una pasarela de pago simulada. La arquitectura y las fases siguientes (agente IA, scrapers, pagos automáticos, informe con OpenRouter) están en docs/ARQUITECTURA.md.

Stack

Next.js 15 (App Router, Server Actions) · TypeScript · Prisma · PostgreSQL (Supabase) · Tailwind CSS · Vitest

Cómo correrlo

npm install
cp .env.example .env      # ajusta AUTH_SECRET y DATABASE_URL/DIRECT_URL (Postgres)
npx playwright install chromium   # navegador para los conectores
npm run db:migrate        # crea las tablas
npm run db:seed           # regiones, 346 comunas, documentos y trámites
npm run dev               # http://localhost:3000

Pasarela simulada: cualquier tarjeta se aprueba salvo las terminadas en 0002. Los correos se imprimen en la consola del servidor.

Scripts

Comando	Qué hace
npm run dev	Servidor de desarrollo
npm run build	Build de producción (incluye lint y typecheck)
npm test	Tests unitarios (RUT, rol, requisitos y totales)
npm run db:migrate	Aplica las migraciones pendientes
npm run db:reset	Borra la base y vuelve a cargar el seed
npm run worker	Motor de obtención: toma trabajos de la cola y corre los conectores
npm run obtener -- 1001	Procesa en la terminal los documentos de una solicitud

Despliegue (Vercel + Supabase + Cloud Run Santiago): docs/DESPLIEGUE.md.

Estructura

prisma/            schema, seed y datos (regiones/comunas, catálogo)
src/app/           páginas y server actions
src/lib/           auth, reglas de negocio, pagos, correo, informes, almacenamiento
src/lib/fulfillment/  motor de obtención: cola, conectores por emisor (SII, TGR)
src/worker/        proceso del motor (corre en Chile)
docs/              arquitectura y plan por fases