Makefile

.PHONY: all build test lint clean dev down watch docker-build docker-push deps help

BINARY_NAME    := easctl
MAIN_PATH      := ./cmd/easctl
BUILD_DIR      := ./bin
DOCKER_IMAGE   := engineering-at-scale
DOCKER_TAG     := latest
GO_VERSION     := 1.22

# ── Build ────────────────────────────────────────────────────────────────────

all: lint test build

build:
	@echo "→ Building $(BINARY_NAME)..."
	@mkdir -p $(BUILD_DIR)
	@go build -ldflags="-s -w" -o $(BUILD_DIR)/$(BINARY_NAME) $(MAIN_PATH)
	@echo "✓ $(BUILD_DIR)/$(BINARY_NAME)"

build-linux:
	@echo "→ Building for linux/amd64..."
	@GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 $(MAIN_PATH)

# ── Test ─────────────────────────────────────────────────────────────────────

test:
	@echo "→ Running tests..."
	@go test ./... -v -race -coverprofile=coverage.out
	@go tool cover -html=coverage.out -o coverage.html
	@echo "✓ Coverage report: coverage.html"

test-short:
	@go test ./... -short

# ── Code Quality ─────────────────────────────────────────────────────────────

lint:
	@echo "→ Linting..."
	@golangci-lint run ./...
	@echo "✓ Lint passed"

fmt:
	@go fmt ./...
	@goimports -w .

vet:
	@go vet ./...

# ── Development ───────────────────────────────────────────────────────────────

dev:
	@echo "→ Starting local development stack..."
	@docker compose up -d
	@echo "✓ API:     http://localhost:8080"
	@echo "✓ Metrics: http://localhost:9090"
	@echo "✓ Grafana: http://localhost:3000"

down:
	@docker compose down -v
	@echo "✓ Stack stopped"

watch:
	@echo "→ Starting with hot reload (requires air)..."
	@air

logs:
	@docker compose logs -f

# ── Docker ────────────────────────────────────────────────────────────────────

docker-build:
	@echo "→ Building Docker image..."
	@docker build -f docker/Dockerfile -t $(DOCKER_IMAGE):$(DOCKER_TAG) .
	@echo "✓ $(DOCKER_IMAGE):$(DOCKER_TAG)"

docker-push:
	@docker push $(DOCKER_IMAGE):$(DOCKER_TAG)

# ── Dependencies ──────────────────────────────────────────────────────────────

deps:
	@echo "→ Installing dependencies..."
	@go mod download
	@go mod verify
	@echo "✓ Dependencies ready"

tidy:
	@go mod tidy

# ── Database ──────────────────────────────────────────────────────────────────

migrate-up:
	@echo "→ Running migrations..."
	@migrate -path ./internal/storage/migrations -database "$$DATABASE_URL" up

migrate-down:
	@migrate -path ./internal/storage/migrations -database "$$DATABASE_URL" down 1

migrate-create:
	@read -p "Migration name: " name; \
	migrate create -ext sql -dir ./internal/storage/migrations -seq $$name

seed:
	@bash scripts/seed.sh

# ── Cleanup ───────────────────────────────────────────────────────────────────

clean:
	@rm -rf $(BUILD_DIR)
	@rm -f coverage.out coverage.html
	@echo "✓ Clean"

# ── Help ─────────────────────────────────────────────────────────────────────

help:
	@echo ""
	@echo "Engineering at Scale — Developer Commands"
	@echo ""
	@echo "  make build          Build the easctl binary"
	@echo "  make test           Run tests with race detector and coverage"
	@echo "  make lint           Run golangci-lint"
	@echo "  make dev            Start local Docker Compose stack"
	@echo "  make down           Stop local stack"
	@echo "  make watch          Start with hot reload (requires air)"
	@echo "  make docker-build   Build Docker image"
	@echo "  make deps           Install Go dependencies"
	@echo "  make migrate-up     Run database migrations"
	@echo "  make clean          Remove build artifacts"
	@echo ""