ForoHub

Índice de Contenidos:

Contexto
Guía de Usuario
Guía de Instalación
Autor
Licencia
Agradecimientos
Documentos Complementarios

Contexto

ForoHub es una aplicación desarrollada en Java con el entorno IntelliJ para el desafío del curso "Practicando Spring Framework: Challenge Foro Hub" de ONE + Alura Latam. Ha sido manufacturada por su autor (con asistencia de IA) en Noviembre de 2024.

↑ Índice ↑ Inicio ↑

Guía de Usuario

Esta aplicación es una API REST que implementa parcialmente la funcionalidad de un foro.

Se encuentran completos los CRUDs en relación a topico (desafío obligatorio) y usuario (desafío optativo).

Como provee una interfaz amigable gracias al uso de SpringDoc-Swagger (desafío optativo) es fácilmente accesible con un enlace similar al siguiente:

http://localhost:8080/swagger-ui/index.html

(De todos modos, se provee un conjunto de requests en un archivo importable desde Insomnia).

Vale destacar que el servicio de autenticación se basa en Auth0-JWT, y que las contraseñas de los usuarios son almacenadas previa encriptación con Bcrypt.

Respecto de la BBDD, es posible hacer el seguimiento de su desarrollo a través de las sucesivas migraciones de Flyway.

A continuación, unas muestras de las interfaces utilizando SpringDoc-Swagger e Insomnia:

↑ Índice ↑ Inicio ↑

Guía de Instalación

Simplemente se requiere clonar este proyecto en el repositorio local, y luego ejecutarlo con un IDE acorde (como IntelliJ, Eclipse, etc) desde el método main de la clase ForoHubApplication.

Dado que la aplicación trabaja con una base de datos, se requiere un servidor MySQL 8.0.40 o superior previamente instalado. (Se proveen scripts SQL para pruebas).

Importante: No olvidar declarar las variables de entorno que se utilizan en application.properties.

↑ Índice ↑ Inicio ↑

Autor

César es alumno de Alura. Inició su formación en Junio de 2024 dentro del plan Oracle Next Education para Latinoamérica. Tiene 55 años y es nacido en Buenos Aires.

↑ Índice ↑ Inicio ↑