togo: A Go repository from kienmatu

GOLANG TODOS APPLICATION

Technical stuff

Architecture: Clean architecture
Framework: Echo
ORM: Gorm
DB: Postgres
Deployment: Docker

Overview

Support JWT
Limit todos per user in a day
Unit tests & integration test

What next ?

Add role/permission based validation
Add missing tests
Implement your new features

How to run the code locally

Clone the project then:

Update .env file

PORT=8080
JWT_SECRET=B5bJHoI8aVLjAAeV
SIGNING_KEY=ABC
HASH_SALT=SJSHDFDS
TOKEN_TTL=86400
CONNECTION_URL=host=localhost user=postgres password=password1 dbname=todos port=5432

go run cmd/api/main.go

or by Docker

Update .env file (change host to postgresql)

#...
CONNECTION_URL=host=postgresql user=postgres password=password1 dbname=todos port=5432

RUN COMMAND:

docker-compose up -d

Then open postman or bash use curl:

Register:

curl --location --request POST 'http://localhost:8080/api/v1/auth/register' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "kiendinh",
    "password": "abc123",
    "limit": 2
}'

Login:

curl --location --request POST 'http://localhost:8080/api/v1/auth/login' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "kiendinh",
    "password": "abc123"
}'

Take the token from login then.

Add todo:

curl --location --request POST 'http://localhost:8080/api/v1/todos/' \
--header 'Authorization: Bearer YOUR_TOKEN_HERE' \
--header 'Content-Type: application/json' \
--data-raw '{
    "content": "TEST TO DO 2x"
}'

Get all todos:

Public for all users

curl --location --request GET 'http://localhost:8080/api/v1/todos/'

Get user todos:

Get any user's todos with their id

curl --location --request GET 'http://localhost:8080/api/v1/todos/A_USER_ID' \
--header 'Authorization: Bearer YOUR_TOKEN_HERE'

TESTS

I just implemented some necessary test samples, we can add tests of handlers, usecases and another endpoints ...

UNIT TEST

Command:

go test ./...

INTEGRATION TEST