GoGonicEcommerceApi

Features

• Authentication / Authorization
• JWT middleware for authentication
• Multi file upload
• Database seed
• Paging with Limit and Offset using GORM (Golang ORM framework)
• CRUD operations on products, comments, tags, categories, orders
• Orders, guest users may place an order

What you will learn

• Golang

• Golang Go-Gonic web framework

• JWT

• Controllers

• Middlewares

• JWT Authentication

• Role based authorization

• GORM

  • associations: ManyToMany, OneToMany, ManyToOne
  • virtual fields
  • Select specific columns
  • Eager loading
  • Count related association

• seed data

• misc

  • project structure

Understanding the project

The project is meant to be educational, to learn something beyond the hello world thing we find in a lot, lot of tutorials and blog posts. Since its main goal is educational, I try to make as much use as features of APIs, in other words, I used different code to do the same thing over and over, there is some repeated code but I tried to be as unique as possible so you can learn different ways of achieving the same goal.

Project structure:

• models: Mvc, it is our domain data.
• dtos: it contains our serializers, they will create the response to be sent as json. They also take care of validating the input(feature incomplete)
• controllers: well this is the mvC, they receive the request from the user, they ask the services to perform an action for them on the database.
• seeds: contains the file that seeds the database.
• static: a folder that will be generated when you create a product or tag or category with images
• services: contains some business logic for each model, and for authorization
• middlewares: it contains middlewares(golang functions) that are triggered before the controller action, for example, a middleware which reads the request looking for the Jwt token and trying to authenticate the user before forwarding the request to the corresponding controller action

TODO

• Add model constraints such as not null
• Refactor the seeding with http://gorm.io/docs/query.html#Select
• Global Application Error handling
• Can't Preload field errors:
  • Get comment details http://127.0.0.1:8080/api/products/:slug/comments/:id triggered in services.FetchCommentById
  • Get My Orders http://localhost:8080/api/orders triggered with services.FetchOrdersPage
• Security, validations, file upload
• Delete FileUpload if associated tag, category or product deleted
• Delete Files if tag, category, product fail to be saved
• Use pointers as function parameters instead of passing them by value as I did in many
• For some reason /api/products does not work on browsers due to CORS issues, /api/home does work, on postman all routes work ....

Resources

• Go-Gonic Awesome golang based web framework
• GORM
• CORS gin's middleware# GO_Gin_Ecommerce_API