Entry Task

Introduction

entry-task is a web service based on Gin framework. It provides basic user management feature.

Document

You could find following guidance on Entry Task System Design Document and README.md:

• Feature Description
• API Doc
• Deploy Doc
• Benchmark Result

Setup

Before getting start, you need MySQL and Redis installed on your machine. And please refer go.mod for the Go packages used in this project. init.sql in script folder can help to initialize database & table we need.

Following commands will help you set up the project and run it locally:

# generate a config file
cp ./configs/config.yaml.defaul ./configs/config.yaml

# modify the host/db/etc settings in config file
vim ./configs/config.yaml

# packages dependancy
go mod tidy

# run a RPC server
go run ./cmd/grpc-server/main.go

# run a HTTP server
go run ./cmd/http-server/main.go 

Lastly try to test if it works with:

curl --location --request GET 'http://{your_http_host}/api/ping' # {"message":"pong"}

To run unit tests, try:

go test -cover -covermode=atomic -gcflags=all=-l ./... -coverprofile=profile.cov
go tool cover -func profile.cov

Project Layout

├── LICENSE
├── README.md
├── cmd                                     # 
│    ├── erpc-server                        # 
│    │    └── main.go                       # eRPC Server entry point
│    ├── grpc-server                        # 
│    │    └── main.go                       # gRPC Server entry point
│    ├── http-server                        # 
│    │    └── main.go                       # HTTP Server entry point
│    └── rpc-server                         # 
│         └── main.go                       # RPC Server with TinyPRC, deprecated
├── configs                                 # 
│    └── config.yaml.default                # Config Template
├── global                                  # 
├── go.mod                                  # 
├── go.sum                                  # 
├── internal                                # Service Codes
│    ├── constant                           # 
│    ├── dao                                # DAO Layer
│    ├── error                              # 
│    ├── models                             # Models and DAO methods
│    ├── routers                            # 
│    │    ├── api                           # Controller Layer
│    │    └── router.go                     # Router for HTTP service
│    └── service                            # 
│         ├── erpc-service                  # Service Layer for eRPC service
│         ├── grpc-service                  # Service Layer for gRPC service
│         ├── http-service                  # Service Layer for HTTP service
│         └── rpc-service                   # Service Layer for RPC service, deprecated
├── log                                     # 
├── pkg                                     # Public utils
├── proto                                   # 
│    ├── erpc-proto                         # proto for eRPC service
│    ├── grpc-proto                         # proto for gRPC service
│    └── rpc-proto                          # proto for RPC service, deprecated
├── scripts                                 # Init & Test scripts 
└── upload                                  #