This project is an API in Golang and Frontend in Next.js with the intention of studying more about Go and also helping the community with the job search in the market.
I used in this project techs like: Go-Gin as a router, GoORM for database communication, MongoDB Atlas as a database. The project follows a modern package structure to keep the code base organized and maintainable. I also created an authenticated area so that I can approve or delete jobs posted by users.
- Introduction to Golang and building modern APIs
- Development environment setup for creating the API
- Using Go-Gin as a router for route management
- Implementing MongoDB as the database for the API
- Using MongoDB Go Driver for communication with the database
- Creating a modern package structure for organizing the project
- Implementing a complete job opportunities API with endpoints for searching, creating, editing, and deleting opportunities
- Implementing automated tests to ensure API quality
You can check the documentation and perform tests to the API by visiting the live version hosted at JobsDev GO - Website.
To use this project, you need to follow these steps:
- Clone the repository:
git clone https://github.com/username/repo-name.git
- Install the dependencies:
go mod download
- Build the application:
go build
- Run the application:
./main
The project includes a Makefile to help you manage common tasks more easily. Here's a list of the available commands and a brief description of what they do:
make run
: Run the application without generating API documentation.make run-with-docs
: Generate the API documentation using Swag, then run the application.make build
: Build the application and create an executable file namedgopportunities
.make test
: Run tests for all packages in the project.make docs
: Generate the API documentation using Swag.make clean
: Remove thegopportunities
executable and delete the./docs
directory.
To use these commands, simply type make
followed by the desired command in your terminal. For example:
make run
This project includes a Dockerfile
and docker-compose.yml
file for easy containerization and deployment. Here are the most common Docker and Docker Compose commands you may want to use:
docker build -t your-image-name .
: Build a Docker image for the project. Replaceyour-image-name
with a name for your image.docker run -p 8080:8080 -e PORT=8080 your-image-name
: Run a container based on the built image. Replaceyour-image-name
with the name you used when building the image. You can change the port number if necessary.
If you want to use Docker Compose, follow these commands:
docker compose build
: Build the services defined in thedocker-compose.yml
file.docker compose up
: Run the services defined in thedocker-compose.yml
file.
To stop and remove containers, networks, and volumes defined in the docker-compose.yml
file, run:
docker-compose down
For more information on Docker and Docker Compose, refer to the official documentation:
This project uses the following tools:
- Golang for backend development
- Go-Gin for route management
- MongoDB Go Driver for database communication
- MongoDB Atlas as the database
To contribute to this project, please follow these guidelines:
- Fork the repository
- Create a new branch:
git checkout -b feature/your-feature-name
- Make your changes and commit them using Conventional Commits
- Push to the branch:
git push origin feature/your-feature-name
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE.md file for details.
This project was created by Daniel Gabriel.