https://github.com/ayvero/microservices_monopatines
This project implements a microservices architecture using Spring Boot and Docker. It simulates an e-scooter rental platform, managing various business areas such as users, trips, maintenance, and pricing.
https://github.com/ayvero/microservices_monopatines
docker-compose documentation endpoint java maven microservices spring-boot sql
Last synced: 6 months ago
JSON representation
This project implements a microservices architecture using Spring Boot and Docker. It simulates an e-scooter rental platform, managing various business areas such as users, trips, maintenance, and pricing.
- Host: GitHub
- URL: https://github.com/ayvero/microservices_monopatines
- Owner: Ayvero
- Created: 2025-04-21T22:19:38.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-21T23:18:24.000Z (6 months ago)
- Last Synced: 2025-04-22T14:09:20.211Z (6 months ago)
- Topics: docker-compose, documentation, endpoint, java, maven, microservices, spring-boot, sql
- Language: Java
- Homepage:
- Size: 247 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🛴 Microservicios - Sistema de Alquiler de Monopatines
Este proyecto es una aplicación backend desarrollada con arquitectura de microservicios. Simula un sistema de alquiler de monopatines eléctricos con múltiples funcionalidades distribuidas en servicios independientes.
## 🚀 Tecnologías utilizadas
- Java 17
- Spring Boot
- Maven
- Docker + Docker Compose
- PostgreSQL
- JPA / Hibernate
- Eureka (Service Discovery)
- Spring Cloud Gateway
- Spring Config Server
## 🧩 Microservicios incluidos
- `microservicio-administrador`: Gestión de administradores del sistema.
- `microservicio-usuario`: Registro, autenticación y gestión de usuarios.
- `microservicio-monopatin`: Información y disponibilidad de monopatines.
- `microservicio-viaje`: Registro y seguimiento de los viajes realizados.
- `microservicio-mantenimiento`: Gestión de mantenimiento de monopatines.
- `microservicio-gateway`: Puerta de entrada al sistema (API Gateway).
- `shared-dto`: Librería común de clases compartidas entre servicios.
📌 Notas
Cada microservicio cuenta con su propio archivo de endpoints detallando todas las rutas disponibles,
sus métodos HTTP, los parámetros requeridos y ejemplos de uso.
Los servicios pueden ejecutarse de forma independiente para pruebas individuales.
## 📦 Colección Postman
Para probar los endpoints, se incluye una colección de Postman exportada:
- [`coleccion-monopatines.postman_collection.json`](https://github.com/Ayvero/Microservices_monopatines/blob/main/Monopatines.postman_collection.json)
Importala en Postman para probar todos los endpoints de los microservicios.
## ⚙️ Cómo ejecutar el proyecto
1. Clonar el repositorio:
```bash
git clone https://github.com/Ayvero/Microservices_monopatines.git
cd Microservices_monopatines
2. Levantar los servicios con Docker Compose:
docker-compose up --build
3. Acceder a los endpoints a través del gateway en http://localhost:8080
Es necesario tener Docker y Docker Compose instalados previamente.
--------------------------------------
---
## 🌐 English Version
# 🛴 Microservices - Electric Scooter Rental System
This project is a backend application built using microservices architecture. It simulates an electric scooter rental system, with multiple features distributed across independent services.
## 🚀 Technologies Used
- Java 17
- Spring Boot
- Maven
- Docker + Docker Compose
- PostgreSQL
- JPA / Hibernate
- Eureka (Service Discovery)
- Spring Cloud Gateway
- Spring Config Server
## 🧩 Included Microservices
- `microservicio-administrador`: Administrator management.
- `microservicio-usuario`: User registration, login, and profile.
- `microservicio-monopatin`: Scooter availability and info.
- `microservicio-viaje`: Trip records and tracking.
- `microservicio-mantenimiento`: Maintenance service for scooters.
- `microservicio-gateway`: Entry point (API Gateway).
- `shared-dto`: Common shared classes across services.
📌 Notes
Each microservice includes its own file with a detailed list of API endpoints,
HTTP methods, request parameters, and examples.
Services can be tested independently.
Postman or Swagger UI (if enabled) are recommended for API testing.
## ⚙️ How to Run the Project
1. Clone the repository:
```bash
git clone https://github.com/Ayvero/Microservices_monopatines.git
cd Microservices_monopatines
2. Start the services with Docker Compose:
docker-compose up --build
3. Access the endpoints through the gateway at http://localhost:8080
Make sure Docker and Docker Compose are installed.
-----------------------------------------