Volver al hub Stack técnico · arquitectura
JavaScript end-to-end · Vercel + Expo
Admin · Propuesta

Arquitectura técnica

Stack JavaScript Vercel · Fluid Compute
Cómo funciona end-to-end

Tres capas. Sin servidores propios.

Cliente → Plataforma → Carriers + WhatsApp + email · todo serverless sobre Vercel, una sola base de datos Postgres, una sola codebase TypeScript.

Clientes
Web
Next.js 15 App Router
Server Components, Server Actions, Streaming. SSR + ISR para SEO público.
TypeScript Tailwind React 19
Móvil · Fase 2
Expo / React Native
Mismo backend, una codebase. Push nativo, scanner barcode, deep-links.
iOS + Android Expo Push EAS Build
Plataforma
Runtime
Vercel Fluid Compute
Funciones Node.js que reusan instancias para concurrencia. Cron cada 15 min para pull de carriers.
Node 24 LTS Cron Jobs Edge Cache
Base de datos
Neon Postgres
Drizzle ORM · branching por feature · backups automáticos.
Drizzle Marketplace
Storage + Auth
Vercel Blob + Auth.js
Fotos de recepción · WhatsApp OTP login (no SMS).
Blob Auth.js v5
Mapas
Leaflet + OpenStreetMap
Sin API key, sin costo. Tiles vía CARTO. Soporta GIS shapefiles si se necesita después.
Leaflet OSM CARTO tiles
Integraciones
Carriers · Tracking
Shippo API unificada
USPS · UPS · FedEx · DHL · una sola integración, webhook único.
USPS UPS FedEx DHL
Amazon
Forward-to-parse + pre-alerta
Email forwarding a track@pinolero-box.com extrae tracking automático. Pre-alerta manual como fallback.
Email parser TBA-format
WhatsApp
WhatsApp Cloud API
Meta directa (no Twilio). 8 plantillas pre-aprobadas. Webhook para inbound.
Meta direct 8 plantillas
Email + Pagos
Resend + BAC/LAFISE/Stripe
Resend transaccional + newsletter. Pasarelas locales NI + Stripe internacional.
Resend BAC LAFISE Stripe

Integración de tracking automático

Cinco carriers, un solo flujo. Polling cada 15 min vía Vercel Cron + webhooks en tiempo real cuando el carrier los soporta. El cliente nunca abre la app de USPS.

Carrier
Cómo se integra
Método
Frecuencia
9405-***** format · Priority, First-Class, Ground. Auto-detectado del barcode al pegarlo. Cubre 70% del volumen de Amazon estándar.
Shippo API
Webhook + 15 min
1Z***** format · Ground, 2nd Day, Next Day. Algunos pedidos de Amazon Prime y casi todos los de Best Buy / Newegg.
Shippo API
Webhook + 15 min
12 o 15 dígitos · Express, Ground, Home Delivery. Sephora, Apple, electrónica de mayor valor.
Shippo API
Webhook + 15 min
TBA***** format · Amazon Logistics directo. No expone API pública: combinamos pre-alerta manual + parser de email "Your order has shipped" reenviado a track@pinolero-box.com.
Email parser + manual
On-demand
10 dígitos · Express Worldwide. Volumen menor (compras europeas vía rebote a Miami).
Shippo API
15 min polling
Carriers variables (USPS / sus partners chinos). Cuando entregan en Miami, el barcode local USPS / FedEx se trackea con los métodos de arriba.
via USPS / FedEx Shippo
Webhook + 15 min
Costos cloud · pago directo al proveedor

Lo que vas a pagar mensual.

Sin markup. Pinolero Box paga directo a cada proveedor; Geolink solo cobra el desarrollo. Incluye margen para crecer 5×.

Hosting
Vercel Pro
$20/mo · incluye Fluid Compute, Cron, Blob, Edge Cache. Plan Pro suficiente para >100k requests/mo.
Database
Neon Postgres
$19/mo · 10 GB, autoscaling, backups. Marketplace nativo Vercel — env auto-provisionado.
Email
Resend
$20/mo · 50k emails. Cubre transaccional + newsletter mensual.
Carriers
Shippo
$25/mo · pay-as-you-go por tracking event después de cuota. ~$30/mo para volumen Pinolero Box.
WhatsApp
Meta Cloud API
~$50–80/mo · pay-per-conversation (~$0.005 por mensaje template a NI).
Móvil · Fase 2
Apple + Google
$99/año Apple Developer · $25 one-time Google Play. Expo EAS Build $19/mo opcional.
Analítica
Plausible
$9/mo · privacy-friendly, sin cookies, sin GDPR consent banner necesario.
Total mensual
$143–$170/mo
$1,716–$2,040/año · pago directo a cada proveedor, sin markup nuestro.