aalug / bank-go Goto Github PK

View Code? Open in Web Editor NEW

0.0 2.0 0.0 6.89 MB

Bank API built in Go and Gin

Makefile 1.75% Go 93.42% Dockerfile 0.89% Shell 3.94%

api go golang postgres rest-api gin

bank-go's Introduction

Go Bank

App built in Go 1.20

The app uses:

Getting started

Clone the repository
Go to the project's root directory
Rename app.env.sample to app.env and replace the values
Run in your terminal:
- docker-compose up --build to run the containers
Now everything should be ready and the server running on SERVER_ADDRESS specified in app.env

Testing

Run the containers (database container is sufficient)
Run in your terminal:
- make test or
- make test_coverage p={PATH} - to get the coverage in the HTML format - where {PATH} is the path to the target directory for which you want to generate test coverage. The {PATH} should be replaced with the actual path you want to use. For example ./api or
- simply use go test commands

API Endpoints

Users (only endpoints that do not require authentication)

/users - handles POST requests to create users
/users/login - handles POST requests to log in users
/tokens/renew - handles POST requests to renew the access tokens

Accounts

/accounts - handles POST requests to create accounts
/accounts - handles GET requests to get all accounts
/accounts/{id} - handles GET requests to get account details
/accounts/{id} - handles DELETE requests to delete an account

Transfers

/transfers - handles POST requests to transfer money from one account to another

Documentation

API

After running the server, the API (HTTP gateway) documentation can be found at http://localhost:8080/docs/

Database

The database's schema and intricate details can be found on dedicated webpage, which provides a comprehensive overview of the data structure, tables, relationships, and other essential information. To explore the database further, please visit this dbdocs.io webpage. Password: bankgopassword

bank-go's People

Contributors

Watchers

bank-go's Issues

Create `create user` API

Create create user API and test it.
It should allow to create new users.

Create login user API

Create login user API and test it.

Add database docs

Add database documentation using dbdocs.io.
Create the .dbml schema of the database and create a webpage with the documentation.

Implement update user functions in gRPC

Implement update user functions in gRPC.
Create an SQL query code and generate the UpdateUser function with sqlc.
Using this newly created function, implement functionality to update users through gRPC and HTTP.

Implement JWT authentication

Implement JWT authentication in the project.

Add refresh tokens

Add handling of refresh tokens.
Create migrations with new sessions table.
Add a function to handle POST requests to renew access tokens.

Implement the env file

Implement the .env file with Viper.
Add config file which will load environment variables in the main function.

Create transfers API

Create transfers API. Handle POST requests to the /transfers endpoint. Validate and create a transfer.

Embed swagger docs into Go binary

Embed the swagger docs directory into Go binary to serve from an http.FileSystem.
Use statik.

Add users table

Add users table and set the accounts owner to reference the users table.

Add validation for create and login user requests

Add validation for create and login user requests.
Add validation for every field in the request.
This will improve the way the request errors are displayed.

Implement golang-migrate

Implement golang-migrate in the project and add init schema.

Extract metadata from context

Extract metadata from context.
The metadata needed right now is:

user agent
client IP
Both of those are required to create a session in the database.