TransferCuba
El mapa y directorio de negocios que aceptan transferencias en Cuba (Transfermóvil, Enzona, QR). Encuentra dónde pagar sin efectivo, con verificación comunitaria en tiempo real.
✨ Funcionalidades
- 🗺️ Mapa fullscreen — MapLibre GL JS + tiles vectoriales MVT desde PostGIS (OpenFreeMap para basemap) — nitidez GPU en cualquier zoom
- 📍 Directorio con filtros — provincia, municipio, categoría, estado de verificación, canal de pago (QR / online)
- 🟢 Estado en vivo — "acepta transferencia ahora" actualizable por la comunidad
- 🚗 Rutas OSRM — traza la ruta de conducción desde tu ubicación GPS hasta el negocio, con distancia y tiempo
- 🔎 Geocodificación Nominatim — búsqueda de direcciones cubanas y colocación de pines por coordenadas
- 🏪 Registro de negocios — flujo de alta con pin interactivo en el mapa y asistente de direcciones
- 📸 Fotos de negocios — subida directa a Cloudinary (plan gratuito 25 GB), almacenadas en
business_images
- 🛡️ Panel de administración — aprobación, verificación, activación y eliminación de negocios
- 👍 Verificación comunitaria — votos de confirmación y reportes por negocio
- 📱 Responsive — bottom sheet en móvil, panel flotante en escritorio
🧱 Stack
| Capa | Tecnología |
|---|
| Framework | Next.js 15 (App Router) + React 19 |
| Lenguaje | TypeScript 5.9 |
| Estilos | Tailwind CSS 4 + tw-animate-css |
| Mapa | MapLibre GL JS v6 + tiles vectoriales MVT (PostGIS) + basemap OpenFreeMap |
| Datos | PostgreSQL/PostGIS (Neon free) |
| Fotos | Cloudinary (upload unsigned, plan gratuito 25 GB) |
| Geocoding | Nominatim (OSM) |
| Rutas | OSRM (router.project-osrm.org) |
| Iconos | lucide-react |
| Gestor | Bun |
🚀 Empezar
Requisitos: Bun >= 1.1 (o npm/pnpm/yarn con Node >= 20).
# Instalar dependencias
bun install
# Servidor de desarrollo en http://localhost:3000
bun run dev
# Build de producción
bun run build && bun run start
No se requieren API keys para mapas/rutas (Nominatim, OSRM, OpenFreeMap son
públicos). Las variables opcionales son: DATABASE_URL (PostgreSQL/Neon,
sin ella usa fallback in-memory), Cloudinary keys (fotos de negocios;
sin ellas el registro no permite fotos). Ver .env.example.
以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗
