🐉 BESTIARIO — Sistema de Gestión de Criaturas

Aplicación full-stack desarrollada con Spring Boot (Java 21) y frontend en JavaScript, HTML y CSS, basada en una arquitectura REST para la gestión de criaturas dentro de un sistema tipo bestiario.

El sistema permite a los usuarios administrar criaturas, marcarlas como favoritas y agregar notas estratégicas, con persistencia individual por usuario.

---

🧠 Descripción general

Bestiario es una aplicación orientada a demostrar:

• Diseño de APIs REST estructuradas.
• Modelado relacional con JPA / Hibernate.
• Manejo de relaciones complejas entre entidades.
• Separación clara y modular entre frontend y backend (Monorepo).
• Aplicación de lógica matemática en filtros dinámicos.

Cada usuario posee su propio contexto de bestiario, convirtiendo el sistema en una aplicación con persistencia personalizada, no un CRUD simple.

---

🏗 Arquitectura del sistema (Monorepo)

El proyecto está estructurado bajo el patrón de Monorepo, aislando los entornos de desarrollo y empaquetándolos mediante contenedores independientes de Docker que se comunican a través de una red virtual interna.

BestiarioCrud/  (Raíz del proyecto)
│
├── BackBestiario/       # API REST en Spring Boot + Dockerfile
├── FrontBestiario/      # Interfaz de usuario (Versión 2.0) + Dockerfile
├── .env.example         # Plantilla para variables de entorno locales
└── docker-compose.yml   # Orquestador global de la infraestructura

Flujo de comunicación:

Frontend (Puerto 80) → REST API (Puerto 8081) → MySQL Database (Puerto 3307 interno)

---

📌 Funcionalidades principales

🐲 Gestión de criaturas (CRUD)

Crear, listar, actualizar y eliminar registros de criaturas de forma dinámica.

⭐ Sistema de favoritos por usuario

Persistencia individual para marcar/desmarcar criaturas como favoritas mediante relaciones muchos-a-muchos gestionadas por endpoints REST.

📝 Notas estratégicas

Gestión de notas personalizadas por combinación única de usuario y criatura, ideal para guardar debilidades o estrategias de combate.

---

🛠 Tecnologías utilizadas

Backend

• Java 21 & Spring Boot 3
• Spring Web (REST APIs)
• Spring Data JPA & Hibernate
• Maven (Gestor de dependencias)
• MySQL 8.0 (Persistencia relacional)

Frontend

• JavaScript (ES6+) interactivo orientado a consumo de APIs asíncronas (fetch)
• HTML5 & CSS3

Infraestructura y Seguridad

• Docker & Docker Compose (Contenedorización del ecosistema)
• Variables de Entorno (.env) para aislamiento de credenciales sensibles

---

🧠 Fundamentos lógicos aplicados

El proyecto integra principios de lógica formal y estructuración matemática para el procesamiento de datos en el backend:

• Operadores lógicos de selección personalizados.
• Filtros dinámicos compuestos (AND / OR / NOT).
• Modelado basado en teoría de conjuntos para la exclusión e inclusión de parámetros.

Ejemplo de lógica booleana soportada en búsquedas:

(fuerza > 10 AND tipo = "bestia") OR nivel < 3

---

🔌 Endpoints principales

🐲 Criaturas

Método	Endpoint	Descripción
GET	/enemigos	Listar todas las criaturas
GET	/enemigo/{id}	Obtener criatura por ID
POST	/enemigos	Registrar nueva criatura
PUT	/enemigos/{id}	Modificar criatura existente
DELETE	/enemigos/{id}	Eliminar una criatura

⭐ Favoritos

Método	Endpoint	Descripción
POST	/usuarios/{id}/enemigos/{enemigoId}/favorito	Añadir a favoritos
DELETE	/usuarios/{id}/enemigos/{enemigoId}/favorito	Eliminar de favoritos
GET	/usuarios/{id}/favoritos	Listar favoritos de un usuario

📝 Notas

Método	Endpoint	Descripción
GET	/usuarios/{id}/enemigos/{enemigoId}/nota	Obtener nota estratégica
POST	/usuarios/{id}/enemigos/{enemigoId}/nota	Guardar/Actualizar nota

---

🚀 Cómo ejecutar el proyecto (Con Docker en 1 segundo)

Gracias a la contenedorización del proyecto, no necesitas tener instalado Java, Maven ni MySQL en tu máquina local. Solo requieres de Docker.

1️⃣ Requisitos previos

Tener instalado Docker Desktop corriendo en tu sistema.

2️⃣ Clonar el repositorio

git clone https://github.com/qkarman/Bestiario.git
cd Bestiario

3️⃣ Configurar las variables de entorno (Seguridad)

En la raíz del proyecto, crea un archivo llamado .env para almacenar de forma segura tus contraseñas locales (puedes guiarte de la plantilla .env.example):

DB_ROOT_PASSWORD=TuContrasenaSecreta
DB_NAME=bestiario_db
DB_PORT=3307

Nota: El archivo .env está protegido por .gitignore y nunca se subirá al repositorio público.

4️⃣ Levantar la arquitectura completa

Ejecuta el siguiente comando en tu terminal para compilar el código fuente y encender los contenedores en segundo plano:

docker-compose up -d --build

5️⃣ Acceso a las aplicaciones

Una vez que el proceso termine en verde, los servicios estarán disponibles de inmediato:

• Frontend (Interfaz de usuario): http://localhost:80
• Backend (REST API / Postman): http://localhost:8081

Para apagar el entorno por completo y liberar memoria RAM al terminar tus pruebas:

docker-compose down

---

📈 Estado del proyecto

✅ Completado

• Modularización Monorepo e infraestructura con Docker Compose.
• Blindaje de seguridad en credenciales mediante archivos .env locales.
• CRUD de criaturas, sistema de favoritos y notas por usuario.

🔄 En progreso

• Rediseño estético y unificación de flujos en la interfaz visual (Version 2.0).

⬜ Pendiente

• Implementación de seguridad y autenticación con tokens.
• Generación automatizada de criaturas mediante lógica algorítmica.

---

📄 Licencia

MIT — Libre para uso, estudio y modificación.

---

👤 Autor

Cristian Flores — Backend Java Developer GitHub: https://github.com/cristianfloresdev