README.md

---

Despensa-app - REST API

Descripción

Despensa-app es una aplicación que te permite gestionar los productos que compras de forma habitual.

Este proyecto proporciona los recursos a consumir por el proyecto web.

Características

• Ver/Crear/Modificar/Eliminar listas
• Listas publicas
• Listas por usuario (privadas)
• Agregar productos a la lista
• Filtrar productos
• Ver información de un producto
• Marcar productos de la lista
• Crear usuario
• Autenticación
• Autorización JWT
• Administración (Pendiente)

Despliegue local

• Requisitos
• Empezar a trabajar
  • Crear base de datos
  • Usando postman
  • Trabajando en IntelliJ IDEA

Requisitos

• Java 21
• MySQL 8
• Maven 3.9.7 (Opcional)
• Wildfly 30 (Opcional)

Empezar a trabajar

Crear base de datos

• Creamos un usuario llamado despensa_app con la siguiente contraseña despensa_app.
• Creamos el esquema despensa_app.
• Automáticamente, al iniciar spring se ejecutarán los scripts schema.sql y data.sql

Usando postman

• Puedes hacer un fork a las API en el siguiente enlace:

  

Trabajando en IntelliJ IDEA

• Clonar proyecto
• Configurar maven home path
• Compilar
• Ejecutar
• Habilitar EditorConfig
• Establecer opciones de guardado
• spring-boot-devtools

Clonar proyecto:

File > New > Project from Version Control

Establecer la ruta local de maven:

(No es necesario si se pretende usar mvnw)

File > Settings > Build, Execution, Deployment > Build Tools > Maven

• maven home path

Compilar:

• Run > Run...
  • [spring-boot:run]: Inicia el proyecto.
  • [clean,install]: Compila el proyecto sin test.
  • [clean,install] Tests: Compila ejecutando los test.

Ejecutar aplicación:

• Run > Run...

  • App

  Si el usuario y contraseña, de la base de datos, es distinto a root, modificar la información de conexión del fichero src/main/resources/application.properties

Habilitar EditorConfig

• Es necesario tener habilitado el soporte de EditorConfig:

  Settings > Editor > Code Style

  • Enable Editor Config Support

Establecer acciones de guardado

• Recomiendo tener activado las acciones de guardado:
  • Reformat code
  • Optimize imports

Settings > Tools > Actions on save

Tener habilitado EditorConfig.

Spring-boot-devtools

• Activar la compilación automática del proyecto:

Settings > Build, Execution, Development > Compiler

• Build project automatically

Contribuir

Cualquier contribución que hagas será muy apreciada.

• Antes de empezar a codificar, lea las directrices de contribución.

Agradecimientos

Gracias a JetBrains por proporcionar una licencia para IntelliJ IDEA para desarrollar este proyecto.

JetBrains	IntelliJ IDEA

Licencia

MIT license.