Backend — Changelog
v0.0.1
Changelog de la versión 0.0.1 — Versión inicial del backend API
v0.0.1 — Versión inicial del backend API
Fecha de publicación: Mayo 2026
Resumen
Primera versión del backend API de ServiciosApp. Incluye toda la infraestructura base: autenticación de usuarios, registro y gestión de empresas, sucursales, servicios, horarios, sistema de búsqueda, favoritos, reviews, y más. El backend sigue una arquitectura hexagonal con CQRS.
Backend
Novedades
Autenticación y usuarios
- Registro de usuarios con correo electrónico, contraseña, nombres y ubicación
- Inicio de sesión con correo electrónico o número de teléfono
- Refresco de token de acceso JWT
- Obtención de información del usuario autenticado con sus perfiles
- Validación de correo electrónico mediante código de verificación
- Recuperación de contraseña con token de verificación
- Actualización de perfil de cliente
Ubicaciones
- Consulta de estados disponibles
- Consulta de municipios por estado
Categorías
- Categorías padres y subcategorías
- Atributos configurables por subcategoría
- Búsqueda pública de categorías y subcategorías por nombre
Búsqueda de servicios
- Búsqueda de servicios con filtros: texto libre, categoría, estado, rango de precios y calificación mínima
- Ordenamiento por relevancia, precio y calificación
- Consulta de sucursales por servicio con cálculo de distancia
Favoritos
- Agregar y eliminar servicios favoritos
- Listado paginado de favoritos
- Consulta de estado de favorito por servicio
Reviews y calificaciones
- Creación de reviews con calificación (1-5 estrellas), título y descripción
- Eliminación de reviews
- Consulta de límite de reviews disponibles
- Consulta pública de reviews por servicio
Empresas
- Creación de empresa con nombre y RFC
- Actualización de información de empresa con imagen
- Consulta de empresa por ID
- Conteo de servicios, sucursales y usuarios activos
Usuarios de empresa
- Creación de perfil de usuario de empresa con imagen
- Actualización de perfil
- Consulta de usuario de empresa por ID
Sucursales
- Creación de sucursales con imágenes y ubicación en mapa
- Actualización de sucursales con imágenes
- Consulta de sucursal por ID
- Listado de sucursales del usuario autenticado
- Activación, desactivación y reactivación de sucursales
- Eliminación de sucursales
- Validación de límite de sucursales activas
Servicios de empresa
- Creación de servicios con imágenes y categorías
- Actualización de servicios con imágenes
- Consulta de servicios por empresa
- Consulta de servicios por sucursal
- Consulta de servicio por ID con distancia
- Activación, desactivación y eliminación de servicios
Canales de servicio
- Activación y desactivación de canales de servicio
- Configuración de precios y horarios por canal
Horarios
- Horarios regulares de sucursal (crear, actualizar, eliminar)
- Excepciones de horario para días festivos y cierres programados
- Horarios de empresa con plantillas
- Sincronización de horarios
- Consulta de horario activo de sucursal y empresa
- Consulta de estado de sucursal (abierto/cerrado)
Invitaciones a empresa
- Creación de invitaciones por correo electrónico
- Validación de token de invitación
Feedback
- Creación de feedback por usuarios
- Consulta de historial de feedback con filtros
- Consulta de disponibilidad de feedback
Estadísticas de interacción
- Historial de interacciones del usuario
Carrusel promocional
- Consulta de carruseles promocionales activos
Infraestructura técnica
- Arquitectura hexagonal con CQRS (Command Query Responsibility Segregation)
- Autenticación JWT con cookies HTTP-only
- Migraciones de base de datos con Flyway
- Documentación OpenAPI (Swagger)
- Pruebas de integración con Testcontainers
- Almacenamiento de imágenes en Azure Blob Storage
- Rate limiting en endpoints públicos
- Validación con Jakarta Validation
- Cobertura de código con JaCoCo