https://github.com/beto-ouverney/blogs-api-node-js
Blogs API NODE.JS with DOCKER, SEQUELIZE, MYSQL, JWT, SOLID and MSC Architecture
https://github.com/beto-ouverney/blogs-api-node-js
express jwt msc mysql node nodejs sequelize solid-principles
Last synced: 3 months ago
JSON representation
Blogs API NODE.JS with DOCKER, SEQUELIZE, MYSQL, JWT, SOLID and MSC Architecture
- Host: GitHub
- URL: https://github.com/beto-ouverney/blogs-api-node-js
- Owner: beto-ouverney
- Created: 2022-08-08T23:46:10.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-08-09T01:19:02.000Z (almost 4 years ago)
- Last Synced: 2025-05-30T11:46:26.063Z (about 1 year ago)
- Topics: express, jwt, msc, mysql, node, nodejs, sequelize, solid-principles
- Language: JavaScript
- Homepage:
- Size: 247 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Blogs API NODE.JS with DOCKER, SEQUELIZE, MYSQL, JWT, SOLID and MSC Architecture #
Development of an API and DATABASE for a blog using JWT for security
# Other Versions of this project with other languages #
[Blogs API GO LANG with DOCKER, MYSQL, JWT, SOLID and Clean Architecture Version](https://github.com/beto-ouverney/blogs-api-golang)
## Table of contents
- [General view](#general-view)
- [The Challenge](#the-challenge)
- [The development process](#the-development-process)
- [Tools used](#tools-used)
- [Lessons learned](#lessons-learned)
- [Usage](#usage)
- [Author](#author)
## General view
### The challenge
Blogs API NODE.JS with DOCKER, SEQUELIZE ORM, MYSQL, JWT, SOLID and MSC Architecture
**The users must be capable of**
- endpoint POST /login
-> The request return status 200 and a token if login is success
-> The body of the request should follow the format below:
```json
{
"email": "beto.ouverney@email.com",
"password": "123456"
}
```
-> The validation rules are:
the email field is mandatory;
the email field must have a valid email address;
the password field is mandatory;
the password field must be at least 6 characters long.
- endpoint POST /user
-> The request return status 200 and a token if user was created with success
-> The body of the request should follow the format below:
```json
{
"displayName": "Carol",
"email": "carol@email.com",
"password": "123456",
"image": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
}
```
- endpoint GET /user
-> The request return status 200 and all users in database
-> The request header must be contains a valid token
- endpoint GET /user/:id
-> Return a user according to id
-> The request header must be contains a valid token
- endpoint POST /categories
-> Add a category.
-> The body of the request should follow the format below:
```json
{
"name": "Go Lang"
}
```
-> The validation rules are:
the name field is mandatory;
- endpoint GET /categories
-> Return all categories.
-> The request header must be contains a valid token
- endpoint POST /post
-> Add a blog post
-> The request header must be contains a valid token
-> The body of the request should follow the format below:
```json
{
"title": "Latest updates, August 1st",
"content": "The whole text for the blog post goes here in this key",
"categoryIds": [1, 2]
}
```
- endpoint GET /post
-> Return all blogs post, user owner of it and database categories
-> The request header must be contains a valid token
- endpoint GET /post/:id
-> Return a blog post, user owner of it and database categories according to id
-> The request header must be contains a valid token
- endpoint PUT /post/:id
-> Update a blog post
-> The request header must be contains a valid token
-> The body of the request should follow the format below:
```json
{
"title": "Latest updates, August 1st",
"content": "The whole text for the blog post goes here in this key"
}
```
- endpoint DELETE /post/:id
-> Delete a blog post
-> The request header must be contains a valid token
-> Only the blog post creator can delete it
- endpoint DELETE /user/me
-> Delete you from the database, based on the id in your token
-> The request header must be contains a valid token
- endpoint GET /post/search?q=:searchTerm
-> Return an array of blog posts that contain in their title or content the term passed in the URL
-> The request header must be contains a valid token
-> The query params of the request should follow the format below:
http://localhost:PORT/post/search?q=wow
## The development process
### Tools used
#### Back-end
- Node.Js
### Lessons learned
In this project I could improve my knowledge in back-end, by:
- Express
- Using SOLID principles and MSC Architecture
- Docker
- Sequelize
- Mysql
- JWT
## Usage
- You will have access to various scripts, that will help you achieving what you want to do.
- Before you start, your docker-compose needs to be at version 1.29 or higher
- docker-compose up -d --build
- Then execute the command below to access the terminal of container:
- docker exec -it blogs_api bash
- Install all dependencies
- npm install
## Author
- LinkedIn - [Alberto Ouverney Paz](https://www.linkedin.com/in/beto-ouverney-paz/)