Proyectos 05 / 11
GearHead
Red social para quienes respiran automovilismo
Comunidad online donde los entusiastas de los coches comparten sus vehículos, encuentros, modificaciones e historias. Feed, perfiles, garaje virtual y eventos por región.
Visión general
GearHead es una red social para quienes viven los autos. Cada persona arma su garaje virtual con autos, versiones, potencia y modificaciones, publica el avance de sus proyectos, entra en clubes por estilo y confirma asistencia a encuentros y track days de su región.
El proyecto empezó como dos aplicaciones paralelas que accedían a la misma base. Se reorganizó en un monorepo con responsabilidades claras: la API Laravel con JWT es la única que habla con PostgreSQL, y el front en PHP puro, con router propio y traducción en portugués, inglés y español, consume todo por HTTP.
Funcionalidades
Lo que el sistema hace
-
Garaje virtual
Autos con marca, modelo, año, versión, color, potencia y lista de modificaciones, con un auto principal en el perfil.
-
Feed de la comunidad
Publicaciones con imagen, me gusta y comentarios, en el feed general o dentro de un club.
-
Clubes por estilo
JDM, Muscle, Euro, Off-Road, Classic y Track Day, con dueño, administradores, miembros y un muro propio.
-
Encuentros y eventos
Encuentros, track days y travesías con fecha, lugar, cupo y confirmación de asistencia, filtrables por tipo y período.
-
Amistades y mensajes
Solicitudes de amistad y conversaciones privadas entre miembros.
-
Tres idiomas
Interfaz en portugués, inglés y español, con preferencia de idioma y formato de hora por usuario.
Pantallas
Por dentro del sistema
Pantallas con datos ficticios, generados para demostración.
Stack
Cómo fue construido
- Frontend
- PHP puroRoteador próprioi18n pt/en/es
- Backend
- Laravel 12JWT (tymon/jwt-auth)
- Datos
- PostgreSQL
Detrás de escena
Desafíos técnicos
-
Desacoplar el front de la base
El front leía y escribía directamente en PostgreSQL con PDO, en paralelo a una API que nadie consumía. La migración movió cada lectura y escritura a endpoints de la API y eliminó por completo el acceso directo y el SQL heredado.
-
Autenticación entre dos aplicaciones
El token JWT se obtiene en el login y se guarda en la sesión PHP del front, que sigue a cargo de sesión, CSRF y mensajes. La API no conoce la sesión; el front no conoce la base.
-
Contadores coherentes
Miembros de clubes y confirmados en eventos se muestran en listas grandes, así que quedan desnormalizados y deben actualizarse junto con cada entrada, salida y confirmación.
¿Necesitas algo
parecido?
Cuéntame la idea o el problema. Ayudo a diseñar la solución y la construyo de la API a la app.
Hablemos