https://github.com/normalhuman01/easy-market

https://github.com/normalhuman01/easy-market

Last synced: 17 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/normalhuman01/easy-market
• Owner: normalhuman01
• License: apache-2.0
• Created: 2023-12-16T05:46:54.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-12-16T05:49:06.000Z (about 1 year ago)
• Last Synced: 2023-12-16T06:51:06.808Z (about 1 year ago)
• Language: Java
• Size: 216 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Dependencias

1. pgAdmin

2. IntelliJ IDEA IDE

# Instrucciones

1. Ejecutar las consultas sql de los archivos BD/schema y DB/data en pgAdmin para crear y poblar la base de datos

2. Agregar el plugin MapStruct al IDE desde el siguiente link: https://plugins.jetbrains.com/plugin/10036-mapstruct-support

3. Abrir el proyecto con el archivo build.gradle desde el IDE

4. Correr el proyecto

# Rutas

 Productos 


1. Obtener productos: GET http://localhost:5000/easy-market/api/products/all

2. Obtener producto por id: GET http://localhost:5000/easy-market/api/products/{id}

3. Guardar producto: POST http://localhost:5000/easy-market/api/products


Ejemplo de Body: 


{

        "name": "Palta",

        "categoryId": 1,

        "price": 20.0,

        "stock": 100,

        "active": true

 }



4. Borrar producto por id: DELETE http://localhost:5000/easy-market/api/products/{id}

 Compras 


1. Obtener compras: GET http://localhost:5000/easy-market/api/purchases/all

2. Obtener compra por id: GET http://localhost:5000/easy-market/api/purchases/{id}

3. Obtener compra por id del cliente: GET http://localhost:5000/easy-market/api/purchases/client/{id}

4. Guardar compra: POST http://localhost:5000/easy-market/api/purchases


Ejemplo de body:


{

        "clientId": "4546221",

        "date": "1992-08-10T17:30:00",

        "paymentMethod": "E",

        "comment": "",

        "state": "P",

        "items": []

}



5. Borrar compra por id: DELETE http://localhost:5000/easy-market/api/purchases/{id}

 # Documentacion (Swagger)

 1. Acceder a traves del siguiente link: http://localhost:5000/easy-market/api/swagger-ui.html

 # Seguridad (Spring Security)

 1. La seguridad se maneja a través de JWT, para autenticarse se accede a la API de autorizacion a través de la siguiente ruta: http://localhost:5000/easy-market/api/auth/authenticate


junto con un Body:


{

  "username": "*****",

  "password": "*****"

}



Luego, se generará un token JWT que tendrá que ser usado en el  header  de cada petición http a las API's.



Si se desea autenticarse una única vez, también se puede llevar a cabo la autenticación haciendo click en el siguiente boton en la documentación swagger (http://localhost:5000/easy-market/api/swagger-ui.html):



Luego se mostrará el siguiente modal:









En el campo "Value" se ingresará la palabra "Bearer " mas el token de autenticación generado previamente, una vez hecho esto, se habilitarán todas las peticiones en esta sesión  a través de la documentación swagger al dar click en el botón "Authorize".

 # Estado del proyecto

 1. En desarrollo (90%)

 # Caracteristicas futuras

 1. Dockerización