---

Despensa-app - REST API

📚 Translations Readme: English

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 públicas
• 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)

Empezar a trabajar

• Despliegue en local
  • Requisitos
  • Configurar base de datos
  • Compilar e iniciar el proyecto
• Despliegue con docker
• Trabajando en IntelliJ IDEA
• Swagger
• Usando postman

Despliegue en local

Requisitos

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

Configurar base de datos

• Crear el esquema despensa_app.
• Establecer la contraseña del usuario root en la propiedad spring.datasource.password del archivo application.properties.
• Ejecutar manualmente los siguientes scripts:
  • schema.sql
  • data.sql

Compilar e iniciar el proyecto

Abrir una consola en la raíz del proyecto y ejecutar los siguientes comandos:

• .\mvnw clean install
• .\mvnw spring-boot:run

Despliegue con docker

Con esta opción no necesitaremos instalar mysql y al iniciar siempre se ejecutarán los scripts (schema.sql y data.sql), ya que la aplicación se iniciara con el perfil dockerdev.

Iniciar imagen de docker hub

docker compose -f compose.despensa-rest-api.yaml up -d

Crear imagen e iniciar

docker compose up --build -d

Trabajando en IntelliJ IDEA

• Community Edition
• Clonar proyecto
• Establecer la ruta local de maven
• Configuraciones de ejecución
• Habilitar EditorConfig
• Establecer opciones de guardado
• spring-boot-devtools

Community Edition

Las siguientes indicaciones son para la versión Ultimate, pero en su mayoría también funcionan en la versión Community Edition.

Hay publicada una demostración de despliegue local con la versión Community Edition en la sección de discusiones del repositorio.

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

Configuraciones de ejecución

Run > Run...

• [clean,install]: Compila el proyecto sin test.
• [clean,install] Tests: Compila ejecutando los test.
• [spring-boot:run]: Inicia el proyecto.
• App: Inicia el proyecto. (Versión IDEA Ultimate)
• docker compose: Crear una imagen e inicia el proyecto.
• docker compose (despensa-rest-api): Inicia la imagen de docker hub.

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 y 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

Swagger

Al iniciar la aplicación podemos acceder a la siguiente URL y probar los recursos disponibles:

• http://localhost:8080/swagger-ui/index.html?urls.primaryName=Public

Usando postman

Como alternativa a swagger, puedes hacer un fork o visualizar la colección de recursos de la aplicación en siguiente enlace:

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.