Documentación Técnica

HostelPet

Arquitectura, Alcance y Especificaciones para el Marketplace de Cuidado de Mascotas

Ver Demo en Vivo

Visión del Proyecto

HostelPet no es solo un MVP descartable; es una plataforma robusta diseñada para la escalabilidad. El objetivo es conectar familias con cuidadores validados a través de una arquitectura desacoplada, segura y preparada para el crecimiento futuro, excluyendo inicialmente aplicaciones nativas para enfocarse en una experiencia Web App de alta calidad.

💻
Plataforma Web
100% Responsive
🔒
Seguridad
Datos & Pagos
📈
Escalabilidad
Backend API RESTful

Ecosistema de Usuarios

La plataforma gestiona tres roles distintos, cada uno con permisos y flujos de trabajo específicos para garantizar la confianza y la operatividad del mercado.

👨‍👩‍👧‍👦

Familia

  • Registro y gestión de mascotas.
  • Búsqueda por zona y fechas.
  • Pagos y calificaciones.
🏡

Cuidador

  • Gestión de calendario y cupos.
  • Validación de identidad.
  • Aceptación de reservas.
🛡️

Admin HostelPet

  • Validación de perfiles.
  • Auditoría de chats y pagos.
  • Gestión de zonas (Códigos Postales).

Distribución Funcional

El alcance del proyecto se basa en 20 puntos de control críticos. El análisis de estos requerimientos muestra un fuerte énfasis en la Gestión Operativa (Reservas y Pagos) y la Administración, asegurando que la plataforma sea controlable y monetizable desde el primer día.

Puntos Clave del Alcance:

  • 35% Lógica de Negocio (Reservas, Búsqueda, Tests)
  • 25% Gestión de Usuarios y Perfiles
  • 20% Panel de Administración y Seguridad
  • 20% Infraestructura y Pagos

Desglose basado en los ítems del checklist técnico

Prioridades del Sistema

Analizando las especificaciones técnicas, se observa un equilibrio claro. A diferencia de un MVP básico, HostelPet prioriza la Seguridad y el Control Administrativo casi al mismo nivel que la experiencia de usuario.

1

Control Total (Backoffice)

Capacidad de intervenir en chats, pagos, reservas y validación manual de usuarios.

2

Escalabilidad Futura

Arquitectura preparada para crecer, evitando deuda técnica inicial (No MVP descartable).

3

Automatización Limitada

Se prioriza la validación manual y la seguridad sobre la automatización masiva en esta fase.

Flujos Críticos de Negocio

A Ciclo de Vida del Cuidador

Registro
Carga de Datos
En Revisión
Validación Admin
Rechazo
Activo
Visible en Búsqueda

B Flujo de Reserva & Pagos

Solicitud de Reserva

Familia selecciona fechas. Estado: Pendiente

Pre-Confirmación

Cuidador acepta. Fechas se bloquean temporalmente.

Pago 100%

La plataforma retiene el dinero. Estado: Confirmada

Fin de Estadía & Liquidación

Se libera el pago al cuidador menos la comisión.

Modelo de Transacción

El modelo "Escrow" protege a ambas partes. El dinero solo se mueve al cuidador tras el éxito del servicio.

Stack Tecnológico & Entregables

Frontend
React / Vue
SPA Responsiva
Backend
Node / Python
API RESTful
Base de Datos
PostgreSQL
Relacional / Geo
Infra
Cloud AWS/GCP
Scalable Storage

Lista de Entregables

Código Fuente (Repositorio Git)
Documentación de API y Despliegue
Manual de Panel Administrativo
Soporte Post-Lanzamiento