Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/johnnms/forohub.alura_foro-de-dudas-en-cursos
Desarrollo del cuarto Alura Challenge "ForoHub de Alura", como parte del proceso de formación como Backend
https://github.com/johnnms/forohub.alura_foro-de-dudas-en-cursos
java maven-pom mvc mysql-database postman spring-boot spring-data-jpa spring-security
Last synced: 18 days ago
JSON representation
Desarrollo del cuarto Alura Challenge "ForoHub de Alura", como parte del proceso de formación como Backend
- Host: GitHub
- URL: https://github.com/johnnms/forohub.alura_foro-de-dudas-en-cursos
- Owner: JohnnMS
- License: mit
- Created: 2024-07-12T23:10:49.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-07-21T18:36:29.000Z (6 months ago)
- Last Synced: 2024-11-12T01:33:04.238Z (3 months ago)
- Topics: java, maven-pom, mvc, mysql-database, postman, spring-boot, spring-data-jpa, spring-security
- Language: Java
- Homepage:
- Size: 104 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CHALLENGE 4: ForoHub.Alura, foro de dudas para cursos online 🗂️
Cuarto challenge desarrollado en el proceso de formación con Alura LATAM & Oracle Next Education.
## DESCRIPCIÓN
"ForoHub.Alura", se desarrolló en el lenguaje de programación Java 17 como base, usando distintas dependencias como Maven, Spring Boot,
Spring Data, Spring WEB, Spring Security y MySQL. Esta API simula el funcionamiento de un foro de preguntas y respuestas, como
el utilizado en Alura Latam, donde estudiantes, profesores y moderadores pueden colaborar y aprender juntos. Nuestro objetivo
es replicar el proceso de gestión de un foro a nivel de backend, abordando cómo se almacena la información, cómo se relacionan
los temas con las respuestas y cómo se gestionan los usuarios y sus interacciones. La aplicación se desarrolla como parte del
proceso de formación en Alura & Oracle Next Education. Con su desarrollo se busca aplicar los conocimientos adquiridos en el
ámbito de la programación y formación como Backend.
### Requisitos establecidos para el desarrollo del proyecto
☑️ Implementar una API REST con rutas siguiendo las mejores prácticas del modelo REST.
☑️ Realizar validaciones según las reglas de negocio.
☑️ Implementar una base de datos relacional para la persistencia de la información.
☑️ Proveer un servicio de autenticación y autorización para restringir el acceso a la información.
### Funcionalidades del proyecto
✅ Crear un nuevo tema.
✅ Mostrar todos los temas creados.
✅ Mostrar un tema específico.
✅ Actualizar un tema.
✅ Eliminar un tema.
### Diagrama ER, Base de datos
### Configuración
⚙️ Crear variables de entorno Name / Value:
- API_Secret / "Tu clave".
> [!NOTE]
> Clave para la firma de los web token JWT.
- DB_HOST_FORO / localhost:3306
- DB_NAME_FORO / "Nombre para la base de datos"
- DB_USER_FORO / "tu usuario de acceso a la base de datos".
> [!NOTE]
> Por defecto para MySQL el usuario es 'root'.
- DB_PSW_FORO / "Tu clave de acceso a la base de datos"
⚙️ Ruta del proyecto
- ...\src\main\java\com\monsa\ForoHubAlura\ForoHubAluraApplication.java
⚙️ Datos de prueba MySQL
- Ver y ejecutar el Script [DatosPruebas](ForoDataDummy.sql).
## USO DE LA API.
Aquí tienes algunos ejemplos de cómo interactuar con la API:
## ✳️ Autenticación
### POST /login
Content-Type: application/json
Auth type: Bearer Token
> [!NOTE]
> Ver datos de usuarios en la base de datos. Las claves se encuentran codificadas con *Bcrypt password hashes*. Administrador clave: 123456, otros usuarios: clave123
## ✳️ Crear un nuevo tema
### POST /temas
Content-Type: application/json
> [!NOTE]
> Ver nombres de los cursos en la base de datos.
## ✳️ Mostrar todos los temas creados
### GET /temas
Content-Type: application/json
Retorna datos paginados con todos los temas almacenados. La página se puede configurar por tamaño y número de página:
## ✳️ Mostrar un tema específico
### GET /temas/{id}
Content-Type: application/json
## ✳️ Actualizar un tema
### PUT /temas/{id}
Content-Type: application/json
De acuerdo con las reglas de negocio, no se puede duplicar ni títulos, ni mensajes para un mismo {id}
## ✳️ Eliminar un tema
### DELETE /temas/{id}
La API responde con los código de estado: 200 OK, 403 Forbidden o 404 Not Found, según el caso
## Licencias
Este proyecto está licenciado bajo la Licencia MIT - ver el archivo [LICENSE](LICENSE) para más detalles.
## Licencias de Dependencias
Este proyecto utiliza las siguientes bibliotecas y frameworks, cada uno con sus respectivas licencias:
- **JDK de Java 17**: Disponible bajo la [Licencia Pública General de GNU, versión 2, con la excepción de la clase de biblioteca](https://openjdk.java.net/legal/gplv2+ce.html).
- **Spring Boot**: Licenciado bajo la [Licencia Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0).
- **Spring Data**: Licenciado bajo la [Licencia Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0).
- **Spring Web**: Licenciado bajo la [Licencia Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0).
- **Spring Security**: Licenciado bajo la [Licencia Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0).
- **MySQL**: Licenciado bajo la [GNU General Public License v2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html).
## Demo
[https://youtu.be/BMAsHdx2myw](https://youtu.be/NXfdXpZHLvo)
## Autor
Johnn Montañez Sarmiento