Chat

📚 Documentación de Fincos

Plataforma completa de gestión y reserva de fincas en Colombia

React
Base44
Tailwind CSS
Shadcn/UI
Wompi
1. Descripción General

Fincos es una plataforma completa de gestión y reserva de fincas en Colombia, construida sobre Base44. Permite a anfitriones publicar sus propiedades y a huéspedes reservar estadías completas o pasadías.

🎯 Objetivo: Crear un marketplace transparente, seguro y fácil de usar para el alquiler de fincas, conectando anfitriones con huéspedes de forma eficiente.

Multi-región

Cubre todas las regiones de Colombia

Mobile-First

Optimizado para dispositivos móviles

Seguro

Pagos seguros con Wompi

2. Características Principales

👤 Para Huéspedes

  • Búsqueda avanzada: Filtros por ciudad, fechas, capacidad, precio y servicios
  • Reservas flexibles: Estadías completas o pasadías eventos
  • Calendario inteligente: Muestra disponibilidad en tiempo real con fechas especiales
  • Pagos seguros: Integración con Wompi PSE y tarjetas
  • Seguimiento de reservas: Estado en tiempo real y notificaciones
  • Favoritos y reseñas: Guarda propiedades y deja opiniones

🏠 Para Anfitriones

  • Gestión de propiedades: Crear, editar y publicar fincas con IA
  • Dashboard completo: KPIs, gráficos y reportes financieros
  • Calendario manual: Bloquear fechas no disponibles
  • Precios dinámicos: Configurar precios por temporada y fechas especiales
  • Gestión de reservas: Aprobar, rechazar y modificar reservas
  • Gastos y finanzas: Registrar gastos y ver rentabilidad

⚙️ Para Administradores

  • Panel global: Vista completa de todas las operaciones
  • Gestión de usuarios: Crear, editar y asignar roles
  • Importación masiva: Importar propiedades desde WordPress
  • Auditoría: Logs completos de cambios y acciones
  • Scripts de mantenimiento: Reparar datos, migrar, validar
3. Arquitectura

Fincos sigue una arquitectura modular y escalable, aprovechando las capacidades de Base44 para manejar toda la infraestructura.

📁 /entities - Modelos de datos (JSON Schema)
├── Property.json
├── Booking.json
├── User.json
└── ...
📁 /pages - Componentes de página (React)
├── Home.js
├── Search.js
├── PropertyDetail.js
└── ...
📁 /components - Componentes reutilizables
├── /ui - Componentes de Shadcn
├── /propertyDetail - Componentes de detalle
├── /bookings - Gestión de reservas
└── /utils - Utilidades (pricing, etc.)
📁 /functions - Funciones backend (Deno)
├── createPublicBooking.js
├── wompiWebhook.js
├── sendBookingRequestEmail.js
└── ...
📄 Layout.js - Layout global con navegación

🎨 Frontend

  • React 18 UI library
  • React Router SPA routing
  • TanStack Query Server state
  • Tailwind CSS Styling
  • Shadcn/UI Components
  • Framer Motion Animations

⚙️ Backend

  • Base44 SDK para datos
  • Deno Deploy para funciones
  • PostgreSQL Database
  • Row Level Security RLS
  • Webhooks de Wompi
  • Resend Email service
4. Entidades Principales

🏠 Property

Fincas y propiedades con precios, servicios, disponibilidad y más

📅 Booking

Reservas con fechas, precios, estado de pago y confirmación

👤 User

Usuarios del sistema guest, host o admin

⭐ Review

Reseñas verificadas de propiedades con calificaciones

📞 Soporte y Contacto

Para soporte técnico, dudas o sugerencias sobre la plataforma