https://github.com/melardev/apiecombookshelfexpress

Ecommerce API app built with Express and Bookshelf js ORM framework
https://github.com/melardev/apiecombookshelfexpress
api bookshelf crud e-commerce ecommerce express expressjs full-stack fullstack javascript node node-js orm orm-framework pagination web webapp
Last synced: 2 months ago
JSON representation
Ecommerce API app built with Express and Bookshelf js ORM framework
Host: GitHub
URL: https://github.com/melardev/apiecombookshelfexpress
Owner: melardev
Created: 2019-02-11T12:25:19.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2019-03-13T13:12:27.000Z (over 7 years ago)
Last Synced: 2025-03-21T02:46:22.597Z (over 1 year ago)
Topics: api, bookshelf, crud, e-commerce, ecommerce, express, expressjs, full-stack, fullstack, javascript, node, node-js, orm, orm-framework, pagination, web, webapp
Language: JavaScript
Homepage: http://melardev.com/eng
Size: 650 KB
Stars: 1
Watchers: 2
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project

README

          # Api E-commerce Express + Bookshelf

# Table of Contents

- [Introduction](#introduction)

- [Full-stack Applications](#full-stack-applications)

  * [E-commerce (shopping cart)](#e-commerce-shopping-cart)

    + [Server side implementations](#server-side-implementations)

    + [Client side implementations](#client-side-implementations)

  * [Blog/CMS](#blogcms)

    + [Server side implementations](#server-side-implementations-1)

    + [Client side](#client-side)

      - [The next come are](#the-next-come-are)

  * [Simple CRUD(Create, Read, Update, Delete)](#simple-crudcreate-read-update-delete)

    + [Server side implementations](#server-side-implementations-2)

    + [Client side implementations](#client-side-implementations-1)

      - [The next come are](#the-next-come-are-1)

  * [CRUD + Pagination](#crud--pagination)

    + [Server side implementations](#server-side-implementations-3)

      - [The next come are](#the-next-come-are-2)

    + [Client side implementations](#client-side-implementations-2)

      - [The next come are](#the-next-come-are-3)

- [Follow me](#social-media-links)

    

# Introduction

This is one of my E-commerce API app implementations. It is written in Node js, using Express and Bookshelf as the main dependencies.

This is not a finished project by any means, but it has a valid enough shape to be git cloned and studied if you are interested in this topic.

If you are interested in this project take a look at my other server API implementations I have made with:

# Full-stack Applications

## E-commerce (shopping cart)

### Server side implementations

- [Spring Boot + Spring Data Hibernate](https://github.com/melardev/SBootApiEcomMVCHibernate)

- [Spring Boot + JAX-RS Jersey + Spring Data Hibernate](https://github.com/melardev/SpringBootEcommerceApiJersey)

- [Node Js + Sequelize](https://github.com/melardev/ApiEcomSequelizeExpress)

- [Node Js + Bookshelf](https://github.com/melardev/ApiEcomBookshelfExpress)

- [Node Js + Mongoose](https://github.com/melardev/ApiEcomMongooseExpress)

- [Python Django](https://github.com/melardev/DjangoRestShopApy)

- [Flask](https://github.com/melardev/FlaskApiEcommerce)

- [Golang go gonic](https://github.com/melardev/api_shop_gonic)

- [Ruby on Rails](https://github.com/melardev/RailsApiEcommerce)

- [AspNet Core](https://github.com/melardev/ApiAspCoreEcommerce)

- [Laravel](https://github.com/melardev/ApiEcommerceLaravel)

The next to come are:

- Spring Boot + Spring Data Hibernate + Kotlin

- Spring Boot + Jax-RS Jersey + Hibernate + Kotlin

- Spring Boot + mybatis

- Spring Boot + mybatis + Kotlin

- Asp.Net Web Api v2

- Elixir

- Golang + Beego

- Golang + Iris

- Golang + Echo

- Golang + Mux

- Golang + Revel

- Golang + Kit

- Flask + Flask-Restful

- AspNetCore + NHibernate

- AspNetCore + Dapper

### Client side implementations

This client side E-commerce application is also implemented using other client side technologies:

- [React Redux](https://github.com/melardev/ReactReduxEcommerceRestApi)

- [React](https://github.com/melardev/ReactEcommerceRestApi)

- [Vue](https://github.com/melardev/VueEcommerceRestApi)

- [Vue + Vuex](https://github.com/melardev/VueVuexEcommerceRestApi)

- [Angular](https://github.com/melardev/AngularEcommerceRestApi)

## Blog/CMS

### Server side implementations

- [Spring Boot + Spring Data Hibernate](https://github.com/melardev/SpringBootApiBlog)

- [Go + Gin Gonic](https://github.com/melardev/GoGonicBlogApi)

- [NodeJs + Mongoose](https://github.com/melardev/ApiBlogExpressMongoose)

- [Laravel](https://github.com/melardev/LaravelApiBlog)

- [Ruby on Rails + JBuilder](https://github.com/melardev/RailsApiBlog)

- [Django + Rest-Framework](https://github.com/melardev/DjangoApiBlog)

- [Asp.Net Core](https://github.com/melardev/AspCoreApiBlog)

- [Flask + Flask-SQLAlchemy](https://github.com/melardev/FlaskApiBlog)

The next to come are:

- Spring Boot + Spring Data Hibernate + Kotlin

- Spring Boot + Jax-RS Jersey + Hibernate + Kotlin

- Spring Boot + mybatis

- Spring Boot + mybatis + Kotlin

- Asp.Net Web Api v2

- Elixir

- Golang + Beego

- Golang + Iris

- Golang + Echo

- Golang + Mux

- Golang + Revel

- Golang + Kit

- Flask + Flask-Restful

- AspNetCore + NHibernate

- AspNetCore + Dapper

### Client side

- [Vue + Vuex](https://github.com/melardev/VueVuexBlog)

- [Vue](https://github.com/melardev/VueBlog)

- [React + Redux](https://github.com/melardev/ReactReduxBlog)

- [React](https://github.com/melardev/ReactBlog)

- [Angular](https://github.com/melardev/AngularBlog)

The next come are

- Angular NgRx-Store

- Angular + Material

- React + Material

- React + Redux + Material

- Vue + Material

- Vue + Vuex + Material

- Ember

## Simple CRUD(Create, Read, Update, Delete)

### Server side implementations

- [Spring Boot + Spring Data Hibernate](https://github.com/melardev/SpringBootApiJpaCrud)

- [Spring boot + Spring Data Reactive Mongo](https://github.com/melardev/SpringBootApiReactiveMongoCrud)

- [Spring Boot + Spring Data Hibernate + Jersey](https://github.com/melardev/SpringBootApiJerseySpringDataCrud)

- [NodeJs Express + Mongoose](https://github.com/melardev/ExpressMongooseApiCrud)

- [Nodejs Express + Bookshelf](https://github.com/melardev/ExpressBookshelfApiCrud)

- [Nodejs Express + Sequelize](https://github.com/melardev/ExpressSequelizeApiCrud)

- [Go + Gin-Gonic + Gorm](https://github.com/melardev/GoGinGonicApiGormCrud)

- [Ruby On Rails](https://github.com/melardev/RailsApiCrud)

- [Ruby On Rails + JBuilder](https://github.com/melardev/RailsApiJBuilderCrud)

- [Laravel](https://github.com/melardev/LaravelApiCrud)

- [AspNet Core](https://github.com/melardev/AspNetCoreApiCrud)

- [AspNet Web Api 2](https://github.com/melardev/AspNetWebApiCrud)

- [Python + Flask](https://github.com/melardev/FlaskApiCrud)

- [Python + Django](https://github.com/melardev/DjanogApiCrud)

- [Python + Django + Rest Framework](https://github.com/melardev/DjangoRestFrameworkCrud)

### Client side implementations

- [VueJs](https://github.com/melardev/VueAsyncCrud)

#### The next come are

- Angular NgRx-Store

- Angular + Material

- React + Material

- React + Redux + Material

- Vue + Material

- Vue + Vuex + Material

- Ember

- Vanilla javascript

## CRUD + Pagination

### Server side implementations

- [Spring Boot + Spring Data + Jersey](https://github.com/melardev/SpringBootJerseyApiPaginatedCrud)

- [Spring Boot + Spring Data](https://github.com/melardev/SpringBootApiJpaPaginatedCrud)

- [Spring Boot Reactive + Spring Data Reactive](https://github.com/melardev/ApiCrudReactiveMongo)

- [Go with Gin Gonic](https://github.com/melardev/GoGinGonicApiPaginatedCrud)

- [Laravel](https://github.com/melardev/LaravelApiPaginatedCrud)

- [Rails + JBuilder](https://github.com/melardev/RailsJBuilderApiPaginatedCrud)

- [Rails](https://github.com/melardev/RailsApiPaginatedCrud)

- [NodeJs Express + Sequelize](https://github.com/melardev/ExpressSequelizeApiPaginatedCrud)

- [NodeJs Express + Bookshelf](https://github.com/melardev/ExpressBookshelfApiPaginatedCrud)

- [NodeJs Express + Mongoose](https://github.com/melardev/ExpressApiMongoosePaginatedCrud)

- [Python Django](https://github.com/melardev/DjangoApiCrudPaginated)

- [Python Django + Rest Framework](https://github.com/melardev/DjangoRestFrameworkPaginatedCrud)

- [Python Flask](https://github.com/melardev/FlaskApiPaginatedCrud)

- [AspNet Core](https://github.com/melardev/AspNetCoreApiPaginatedCrud)

- [AspNet Web Api 2](https://github.com/melardev/WebApiPaginatedAsyncCrud)

#### The next come are

- NodeJs Express + Knex

- Flask + Flask-Restful

- Laravel + Fractal

- Laravel + ApiResources

- Go with Mux

- AspNet Web Api 2

- Jersey

- Elixir

### Client side implementations

- [Angular](https://github.com/melardev/AngularPaginatedAsyncCrud)

- [React-Redux](https://github.com/melardev/ReactReduxPaginatedAsyncCrud)

- [React](https://github.com/melardev/ReactAsyncPaginatedCrud)

- [Vue + Vuex](https://github.com/melardev/VueVuexPaginatedAsyncCrud)

- [Vue](https://github.com/melardev/VuePaginatedAsyncCrud)

#### The next come are

- Angular NgRx-Store

- Angular + Material

- React + Material

- React + Redux + Material

- Vue + Material

- Vue + Vuex + Material

- Ember

- Vanilla javascript

# Social media links

- [Youtube Channel](https://youtube.com/melardev) I publish videos mainly on programming

- [Blog](http://melardev.com) Sometimes I publish the source code there before Github

- [Twitter](https://twitter.com/@melardev) I share tips on programming

# Getting started

As with most node js projects, do the following

1. git clone the project

2. Rename the .env.example to .env and change the settings according to what you need, I recommend using MySQL, with SQLite you may sometimes have errors.

3. npm install

4. npm start

# Features

- Authentication / Authorization

- Paging

- CRUD operations on products, comments, tags, categories

![Fetching products page](./github_images/postman.png)

- Orders, guest users may place an order

![Database diagram](./github_images/db_structure.png)

# What you will learn

- Bookshelf ORM

    - associations: hasMany, belongsTo, belongsToMany

    - scopes

    - virtuals

    - base

    - knex

    - complex queries

- express

    - middlewares

    - authentication

    - authorization

- seed data with faker js

- misc

    - project structure

    - dotenv

# 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, our business logic.

- routes: they register routes to router middleware

- middleware: some useful middleware, mainly the authentication and authorization middleware.

- config: the database configurer.

- seeder: contains the file that seeds the database, some developers prefer to generate seed skeleton files and seed the database using knex cli.

I did not in this case, in the future I will have in my Github page a project like this one but only using Knex.

- .env the env file from where to populate the process.env node js environment variable

- public: contains the uploaded files.

# Steps followed to create build this project (incomplete)

- Init knex, this will generate some knexfile.js and migrations 

node_modules\.bin\knex.cmd init

- Generate migrations for each table we want to create

node_modules\.bin\knex.cmd migrate:make create_products_categories

- Run migration files to create tables

node_modules\.bin\knex.cmd migrate:latest

- Seed database with:

`node seeder\seeds.js`

or

`npm run seed`

node_modules\.bin\knex.cmd migrate:rollback

node_modules\.bin\knex.cmd seed:make seed_subscriptions

node_modules\.bin\knex.cmd seed:run

# TODO

- The app is lacking validation other than basic authentication.

- Better error handling.

- Implement transactions in createOrder and createTag and createCategories the least.

- Use batch functions in seeds for bulk inserts.

- Review data types of columns, some are only varchar(255) which may not be enough.

- Refractor the code, either use snake case style or camel case Style, not mix.

- Better way of loading models, I have seen many implementations that read any files in the models folder and load them,

it is just a matter of time before I take one of those snippets or write one by my own.

# Resources

- [Bookshelf scopes](https://www.npmjs.com/package/bookshelf-scopes)

- [Bookshelf schema](https://bookshelf-schema.readthedocs.io/en/latest/scopes.html#default-scope)

- [Bookshelf pagination](https://github.com/bookshelf/bookshelf/wiki/Plugin:-Pagination)

- [Bookshelf base](https://www.npmjs.com/package/bookshelf-modelbase)

- [Bookshelf virtuals](https://github.com/bookshelf/bookshelf/wiki/Plugin:-Virtuals)
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/melardev/apiecombookshelfexpress

Awesome Lists containing this project

README
