Aplicación RESTful modular para gestionar estudios geológicos, muestras y geólogos, ideal para empresas de exploración o laboratorios.
Crear una plataforma modular que permita:
- Registrar y administrar estudios geológicos
- Gestionar las muestras de suelo y roca recolectadas
- Controlar la información y participación de los geólogos involucrados
Crear, leer, actualizar y eliminar:
- Geólogos
- Estudios geológicos
- Muestras
Otras funcionalidades:
- Buscar estudios por ubicación o por nombre del geólogo
- Listar todas las muestras de un estudio
El proyecto está organizado en módulos bajo la carpeta raíz geodata-services:
geologist-service/– Servicio para gestionar geólogossample-service/– Servicio para gestionar muestrasstudy-service/– Servicio para gestionar estudios geológicos
Cada módulo funciona como un microservicio Spring Boot independiente.
Además, cuenta con servicios de infraestructura:
config-server/– Configuración centralizadaeureka-service/– Descubrimiento de serviciosapi-gateway/– Punto de entrada unificado
- Java 11+
- Spring Boot
- Spring Cloud (Eureka, Config Server, API Gateway)
- Maven
- RESTful APIs
- Git / GitHub
- Clona este repositorio:
git clone https://github.com/tuUsuario/geodata-services.git
cd geodata-services
- Levanta los microservicios y servicios de infraestructura en terminales separadas, por ejemplo:
# Config Server
cd config-server
mvn spring-boot:run
# Eureka Service
cd ../eureka-service
mvn spring-boot:run
# API Gateway
cd ../api-gateway
mvn spring-boot:run
# Geologist service
cd ../geologist-service
mvn spring-boot:run
# Sample service
cd ../sample-service
mvn spring-boot:run
# Study service
cd ../study-service
mvn spring-boot:run
- El API Gateway estará disponible en
http://localhost:8083, desde donde podrás consumir las APIs.
## 📝 Modifica este README
Si quieres mejorar la documentación o añadir ejemplos usando HTML, CSS o JavaScript, ¡estás más que invitado a hacerlo!
Este archivo README.md es el primer punto de contacto para colaboradores y usuarios, así que cualquier mejora, ya sea con texto, formato o código, será bienvenida.
Si prefieres, simplemente modifica el archivo directamente y envía un pull request.
## 🤝 Cómo contribuir
¡Gracias por tu interés en contribuir a este proyecto! 🛠️
Valoramos mucho el aporte de la comunidad y creemos que juntos podemos hacerlo más sólido, útil y profesional.
Antes de comenzar, te recomendamos leer nuestra [Guía de Contribución](CONTRIBUTING.md).
Allí encontrarás:
- Cómo clonar y ejecutar el proyecto localmente.
- Estándares de código y buenas prácticas.
- Cómo crear issues y enviar pull requests.
- Recomendaciones para documentar nuevas funcionalidades.
No importa si eres principiante o experto, ¡toda mejora suma! Ya sea corrigiendo errores, mejorando la documentación, agregando funcionalidades o simplemente haciendo sugerencias.
## 📄 Licencia
Este proyecto está licenciado bajo la **MIT License**. Consulta el archivo [LICENSE](LICENSE.txt) para más detalles.
## 📫 Contacto
Para preguntas o sugerencias, abre un issue o contáctame vía GitHub.
¡Gracias por interesarte en Geodata Service! 🎉