feat: Add Docker commands and update README with Makefile command descriptions

Author: gjovanovicst

Makefile

@@ -45,9 +45,24 @@ lint:
 build-prod:
 	CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o bin/api ./cmd/api
 
+# Docker commands
+
+# Run development environment with Docker
 docker-dev:
 	./dev.sh
 
+# Run production environment with Docker
+docker-compose-build:
+	docker-compose build
+
+# Stop and remove containers, networks, images, and volumes	
+docker-compose-down:
+	docker-compose down
+
+# Start Docker containers in detached mode with build
+docker-compose-up:
+	docker-compose up -d --build
+
 # Docker build
 docker-build:
 	docker build -t auth-api .
@@ -56,16 +71,27 @@ docker-build:
 docker-run:
 	docker run -p 8080:8080 --env-file .env auth-api
 
+# Generate documentation using Swagger
+swag-init:
+	swag init -g cmd/api/main.go -o docs
+
 # Show help
 help:
 	@echo "Available commands:"
-	@echo "  build      - Build the application"
-	@echo "  run        - Run the application"
-	@echo "  dev        - Run with hot reload (Air)"
-	@echo "  test       - Run tests"
-	@echo "  clean      - Clean build artifacts"
-	@echo "  setup      - Setup development environment"
-	@echo "  fmt        - Format code"
-	@echo "  lint       - Run linter"
-	@echo "  build-prod - Build for production"
-	@echo "  docker-*   - Docker commands"
+	@echo "  build                - Build the application"
+	@echo "  run                  - Run the application"
+	@echo "  dev                  - Run with hot reload (Air)"
+	@echo "  test                 - Run tests"
+	@echo "  clean                - Clean build artifacts"
+	@echo "  install-air          - Install Air for hot reloading"
+	@echo "  setup                - Setup development environment"
+	@echo "  fmt                  - Format code"
+	@echo "  lint                 - Run linter"
+	@echo "  build-prod           - Build for production"
+	@echo "  docker-dev           - Run development environment with Docker"
+	@echo "  docker-compose-build - Build Docker images using docker-compose"
+	@echo "  docker-compose-down  - Stop and remove Docker containers, networks, images, volumes"
+	@echo "  docker-compose-up    - Start Docker containers in detached mode with build"
+	@echo "  docker-build         - Build Docker image (auth-api)"
+	@echo "  docker-run           - Run Docker container with environment from .env"
+	@echo "  swag-init            - Generate Swagger documentation (docs/)"

README.md

@@ -54,6 +54,33 @@ swag init -g cmd/api/main.go -o docs
 3. Install [Air](https://github.com/air-verse/air) for hot reload: `go install github.com/air-verse/air@latest`
 4. Run: `air` or `go run cmd/api/main.go`
 
+## 🛠️ Makefile Commands
+
+The following `make` commands are available for development, testing, building, and Docker operations:
+
+| Command                | Description                                                      |
+|------------------------|------------------------------------------------------------------|
+| `make build`           | Build the application binary (`bin/api.exe`).                    |
+| `make run`             | Run the application without hot reload.                          |
+| `make dev`             | Run with hot reload using [Air](https://github.com/air-verse/air).|
+| `make test`            | Run all Go tests with verbose output.                            |
+| `make clean`           | Remove build artifacts and temporary files.                      |
+| `make install-air`     | Install Air for hot reloading.                                   |
+| `make setup`           | Setup development environment (installs Air, tidy/download deps). |
+| `make fmt`             | Format code using `go fmt`.                                      |
+| `make lint`            | Run linter (`golangci-lint`).                                    |
+| `make build-prod`      | Build for production (Linux, static binary).                     |
+| `make docker-dev`      | Run development environment with Docker (`./dev.sh`).             |
+| `make docker-compose-build` | Build Docker images using docker-compose.                  |
+| `make docker-compose-down`  | Stop and remove Docker containers, networks, images, volumes.|
+| `make docker-compose-up`    | Start Docker containers in detached mode with build.        |
+| `make docker-build`         | Build Docker image (`auth-api`).                            |
+| `make docker-run`           | Run Docker container with environment from `.env`.          |
+| `make swag-init`            | Generate Swagger documentation (`docs/`).                   |
+| `make help`                 | Show all available make commands.                           |
+
+> **Tip:** You can also run `make help` to see this list in your terminal.
+
 ## 🔑 API Endpoints (Summary)
 - `POST /register` — Register
 - `POST /login` — Login