🦖 DinoChomp - Backend

DinoChomp es un videojuego multijugador en tiempo real donde los usuarios controlan dinosaurios que compiten recolectando comida en el mapa, usando poderes especiales y atacando a sus rivales con mordiscos.

Este repositorio corresponde al backend del videojuego.
Su objetivo es proveer los servicios y lógica de negocio necesarios para el videojuego.

---

🚀 Requisitos previos

Antes de ejecutar el proyecto, asegúrate de tener instaladas las siguientes herramientas:

• Java JDK 21 o superior
• Apache Maven 3.8+
• Git
• Docker
• (Opcional) IntelliJ IDEA

Verifica las versiones con:

java -version
mvn -version
git --version
docker --version

📦 Clonar el repositorio

Abre una terminal en el directorio donde quieras guardar el proyecto y ejecuta:

git clone https://github.com/Dinoprogramadores/Backend-DinoChomp.git
cd Backend-DinoChomp

⚙️ Configuración de MongoDB Atlas

---

IMPORTANTE!!

Por seguridad, la cadena de conexión de Atlas no debe ser subida al repositorio.

---

Este proyecto utiliza MongoDB Atlas como base de datos en la nube. Para que la aplicación pueda conectarse correctamente:

Crea un archivo llamado .env en la raíz del proyecto (mismo nivel que docker-compose.yml).

Nota: Usa como base el archivo .envexample

Dentro de ese archivo, modifica la variable de entorno MONGODB_URI (usa tu cadena de conexión de Atlas):

En el archivo application.properties, asegúrate de igualmente modificar spring.data.mongodb.uri=mongodb://mongo:27017/dinochomp por la cadena de conexión de Atlas.

🐳 Ejecutar con Docker

Este proyecto incluye un archivo docker-compose.yml preparado para usar MongoDB Atlas, por lo que no necesitas levantar un contenedor local de MongoDB.

Para construir y ejecutar el backend:

docker compose up --build

Si quieres ejecutarlo en segundo plano:

docker compose up --build -d

Luego accede a:

http://localhost:8080/

🧰 Ejecución local (sin Docker)

1. Para compilar el proyecto:

mvn clean package

2. Para ejecutar la aplicación en local:

mvn spring-boot:run

3. Ingresa a:

http://localhost:8080/

Cuando realizes cambios (NO a docker-compose.yml ni la configuración de la base de datos) ejecuta nuevamente el paso 1 y 3.

🧪 Pruebas

Ejecuta las pruebas unitarias con:

mvn test

🧤 Contribuciones

1. Crea una nueva rama:

git checkout -b feat/nueva-funcionalidad

2. Realiza tus cambios y súbelos:

git commit -m "Agrega nueva funcionalidad"
git push origin feat/nueva-funcionalidad

3. Abre un Pull Request y espera la revisión de otro miembro del equipo.

---

🦕

Proyecto desarrollado por Dinoprogramadores 🧠💻 Hecho con ☕ y ❤️ usando Spring Boot + MongoDB Atlas + Docker + AWS