Makefile

.PHONY: help build up down logs shell clean deploy dev prod rollback status health discard-local-changes check migrate

# Use bash as the shell for all commands
SHELL := /usr/bin/env bash

# Configuration
PROJECT_DIR ?= /var/www/soda-internal-api
BRANCH ?= main
COMPOSE_CMD := $(shell if command -v podman-compose > /dev/null 2>&1; then echo "podman-compose"; elif docker compose version > /dev/null 2>&1; then echo "docker compose"; else echo "docker-compose"; fi)
CONTAINER_CMD := $(shell if command -v podman > /dev/null 2>&1; then echo "podman"; else echo "docker"; fi)

# Colors for output
RED := \033[0;31m
GREEN := \033[0;32m
YELLOW := \033[1;33m
NC := \033[0m

# Default target
help:
	@echo "Available commands:"
	@echo "  make build                  - Build container images"
	@echo "  make up                     - Start services in development mode"
	@echo "  make down                   - Stop and remove containers"
	@echo "  make logs                   - View last 50 lines of container logs"
	@echo "  make logs-follow            - Follow container logs continuously"
	@echo "  make shell                  - Open shell in API container"
	@echo "  make clean                  - Clean up containers and images"
	@echo "  make deploy                 - Deploy to production (pull, build, restart)"
	@echo "  make discard-local-changes  - Discard local git changes (used by CD)"
	@echo "  make dev                    - Start development environment with hot reloading"
	@echo "  make rollback               - Rollback to previous version"
	@echo "  make status                 - Show container status"
	@echo "  make health                 - Check container health"
	@echo "  make check                  - Run lint (auto-fix), format, type check, and tests"
	@echo "  make migrate                - Run alembic database migrations"

# Build container images
build:
	@echo -e "$(GREEN)[INFO]$(NC) Building container images with BuildKit..."
	@export COMMIT_HASH=$$(git rev-parse HEAD 2>/dev/null || echo "unknown") && \
		DOCKER_BUILDKIT=1 $(COMPOSE_CMD) build

# Build only API
build-api:
	@echo -e "$(GREEN)[INFO]$(NC) Building API image..."
	@export COMMIT_HASH=$$(git rev-parse HEAD 2>/dev/null || echo "unknown") && \
		DOCKER_BUILDKIT=1 $(COMPOSE_CMD) build api

# Build only web
build-web:
	@echo -e "$(GREEN)[INFO]$(NC) Building web image..."
	@DOCKER_BUILDKIT=1 $(COMPOSE_CMD) build web

# Start services in development mode
up:
	@echo -e "$(GREEN)[INFO]$(NC) Starting services..."
	@export COMMIT_HASH=$$(git rev-parse HEAD 2>/dev/null || echo "unknown") && \
		$(COMPOSE_CMD) up -d

# Stop services
down:
	@echo -e "$(GREEN)[INFO]$(NC) Stopping services..."
	@$(COMPOSE_CMD) down

# View logs (batch-friendly, last 50 lines)
logs:
	@$(COMPOSE_CMD) logs --tail=50

# Follow logs (continuous)
logs-follow:
	@$(COMPOSE_CMD) logs -f

# Open shell in API container
shell:
	@$(COMPOSE_CMD) exec api /bin/bash

# Clean up everything
clean:
	@echo -e "$(YELLOW)[WARNING]$(NC) Cleaning up containers and volumes..."
	@$(COMPOSE_CMD) down -v
	@$(CONTAINER_CMD) system prune -f

# Discard local changes (used by CD workflow)
discard-local-changes:
	@printf "$(GREEN)[INFO]$(NC) Discarding any local changes...\n"
	@git reset --hard || (printf "$(RED)[ERROR]$(NC) Failed to reset local changes\n"; exit 1)
	@printf "$(GREEN)[INFO]$(NC) Local changes discarded successfully!\n"

# Deploy to production
deploy:
	@set -e; \
		echo -e "$(GREEN)[INFO]$(NC) Starting deployment process..."; \
		if [ "$$(pwd)" != "$(PROJECT_DIR)" ]; then \
			echo -e "$(YELLOW)[WARNING]$(NC) Not in project directory, changing to $(PROJECT_DIR)"; \
			cd $(PROJECT_DIR); \
		fi; \
		OLD_HEAD=$$(git rev-parse HEAD 2>/dev/null || echo ""); \
		echo -e "$(GREEN)[INFO]$(NC) Fetching latest changes from repository..."; \
		git fetch origin $(BRANCH); \
		echo -e "$(GREEN)[INFO]$(NC) Checking out $(BRANCH) branch..."; \
		git checkout $(BRANCH); \
		git reset --hard origin/$(BRANCH); \
		NEW_HEAD=$$(git rev-parse HEAD 2>/dev/null || echo ""); \
		CHANGED_FILES=""; \
		if [ -n "$$OLD_HEAD" ] && [ -n "$$NEW_HEAD" ] && [ "$$OLD_HEAD" != "$$NEW_HEAD" ]; then \
			CHANGED_FILES=$$(git diff --name-only "$$OLD_HEAD" "$$NEW_HEAD"); \
		fi; \
		BUILD_API=0; \
		BUILD_WEB=0; \
		if [ -n "$$CHANGED_FILES" ]; then \
			echo -e "$(GREEN)[INFO]$(NC) Changed files since last deploy commit:"; \
			printf "%s\n" "$$CHANGED_FILES"; \
			while IFS= read -r FILE; do \
				case "$$FILE" in \
					web/*|Dockerfile.web) \
						BUILD_WEB=1 ;; \
					docker-compose.yml|docker-compose.dev.yml|Makefile) \
						BUILD_API=1; BUILD_WEB=1 ;; \
					.github/*|*.md|CLAUDE.md|AGENTS.md|.pre-commit-config.yaml) \
						;; \
					*) \
						BUILD_API=1 ;; \
				esac; \
			done <<< "$$CHANGED_FILES"; \
		else \
			echo -e "$(GREEN)[INFO]$(NC) No new commit detected on $(BRANCH)."; \
		fi; \
		SERVICES_TO_BUILD=""; \
		if [ "$$BUILD_API" -eq 1 ]; then SERVICES_TO_BUILD="$$SERVICES_TO_BUILD api"; fi; \
		if [ "$$BUILD_WEB" -eq 1 ]; then SERVICES_TO_BUILD="$$SERVICES_TO_BUILD web"; fi; \
		echo -e "$(GREEN)[INFO]$(NC) Setting up data directory permissions..."; \
		mkdir -p data; \
		chmod -R 755 data; \
		chown -R 1000:1000 data; \
		echo -e "$(GREEN)[INFO]$(NC) Running database migrations..."; \
		uv run alembic upgrade head || { echo -e "$(RED)[ERROR]$(NC) Database migration failed!"; exit 1; }; \
		if [ "$$BUILD_API" -eq 1 ]; then \
			echo -e "$(GREEN)[INFO]$(NC) Tagging API image as previous..."; \
			$(CONTAINER_CMD) tag soda-internal-api:latest soda-internal-api:previous 2>/dev/null || true; \
		fi; \
		if [ "$$BUILD_WEB" -eq 1 ]; then \
			echo -e "$(GREEN)[INFO]$(NC) Tagging web image as previous..."; \
			$(CONTAINER_CMD) tag soda-web:latest soda-web:previous 2>/dev/null || true; \
		fi; \
		if [ -n "$$SERVICES_TO_BUILD" ]; then \
			echo -e "$(GREEN)[INFO]$(NC) Building changed service images:$$SERVICES_TO_BUILD"; \
			export COMMIT_HASH=$$(git rev-parse HEAD 2>/dev/null || echo "unknown"); \
			BUILDAH_LAYERS=true DOCKER_BUILDKIT=1 $(COMPOSE_CMD) -f docker-compose.yml build $$SERVICES_TO_BUILD; \
			echo -e "$(GREEN)[INFO]$(NC) Recreating changed services:$$SERVICES_TO_BUILD"; \
			$(COMPOSE_CMD) -f docker-compose.yml up -d $$SERVICES_TO_BUILD; \
		else \
			echo -e "$(YELLOW)[WARNING]$(NC) No deploy-impacting service changes detected. Skipping build/restart."; \
		fi; \
		wait_for_health() { \
			CONTAINER_NAME="$$1"; \
			MAX_SECONDS="$$2"; \
			ELAPSED=0; \
			echo -e "$(GREEN)[INFO]$(NC) Waiting for $$CONTAINER_NAME to become healthy..."; \
			while [ "$$ELAPSED" -lt "$$MAX_SECONDS" ]; do \
				STATUS=$$($(CONTAINER_CMD) inspect --format '{{if .State.Health}}{{.State.Health.Status}}{{else}}{{.State.Status}}{{end}}' "$$CONTAINER_NAME" 2>/dev/null || echo "missing"); \
				case "$$STATUS" in \
					healthy|running) \
						echo -e "$(GREEN)[INFO]$(NC) $$CONTAINER_NAME is $$STATUS."; \
						return 0 ;; \
					unhealthy|exited|dead) \
						echo -e "$(RED)[ERROR]$(NC) $$CONTAINER_NAME reported $$STATUS."; \
						return 1 ;; \
				esac; \
				sleep 2; \
				ELAPSED=$$((ELAPSED + 2)); \
			done; \
			echo -e "$(YELLOW)[WARNING]$(NC) Timed out waiting for $$CONTAINER_NAME health."; \
			return 1; \
		}; \
		if [ "$$BUILD_API" -eq 1 ]; then \
			wait_for_health soda-internal-api 60; \
		fi; \
		if [ "$$BUILD_WEB" -eq 1 ]; then \
			wait_for_health soda-web 60; \
		fi; \
		echo -e "$(GREEN)[INFO]$(NC) Container status:"; \
		$(COMPOSE_CMD) ps; \
		echo -e "$(GREEN)[INFO]$(NC) Recent logs:"; \
		$(COMPOSE_CMD) logs --tail=20; \
		echo -e "$(GREEN)[INFO]$(NC) Cleaning up unused container images..."; \
		$(CONTAINER_CMD) image prune -f 2>/dev/null || true; \
		echo -e "$(GREEN)[INFO]$(NC) Deployment completed successfully!"

# Development environment
dev:
	@echo -e "$(GREEN)[INFO]$(NC) Starting development environment with hot reloading..."
	@export COMMIT_HASH=$$(git rev-parse HEAD 2>/dev/null || echo "unknown") && \
		$(COMPOSE_CMD) -f docker-compose.yml -f docker-compose.dev.yml up


# Rollback to previous version
rollback:
	@echo -e "$(YELLOW)[WARNING]$(NC) Rolling back to previous version..."
	@if $(CONTAINER_CMD) images | grep -q "soda-internal-api:previous"; then \
		echo -e "$(GREEN)[INFO]$(NC) Found previous version, rolling back..."; \
		$(CONTAINER_CMD) tag soda-internal-api:latest soda-internal-api:rollback-$$(date +%Y%m%d-%H%M%S); \
		$(CONTAINER_CMD) tag soda-internal-api:previous soda-internal-api:latest; \
		$(COMPOSE_CMD) up -d; \
		echo -e "$(GREEN)[INFO]$(NC) Rollback completed!"; \
		$(COMPOSE_CMD) ps; \
	else \
		echo -e "$(RED)[ERROR]$(NC) No previous version found for rollback"; \
		exit 1; \
	fi

# Show container status
status:
	@echo -e "$(GREEN)[INFO]$(NC) Container status:"
	@$(COMPOSE_CMD) ps

# Run database migrations
migrate:
	@echo -e "$(GREEN)[INFO]$(NC) Running database migrations..."
	@uv run alembic upgrade head
	@echo -e "$(GREEN)[INFO]$(NC) Database migrations complete!"

# Run lint (with auto-fix), format, type check, and tests
check:
	@echo -e "$(GREEN)[INFO]$(NC) Running ruff linting with auto-fix..."
	@uv run ruff check --fix .
	@echo -e "$(GREEN)[INFO]$(NC) Running ruff formatting..."
	@uv run ruff format .
	@echo -e "$(GREEN)[INFO]$(NC) Running ty type checking..."
	@uv run ty check .
	@echo -e "$(GREEN)[INFO]$(NC) Running tests..."
	@uv run pytest -v
	@echo -e "$(GREEN)[INFO]$(NC) Checking alembic migrations are up to date..."
	@uv run alembic upgrade head
	@uv run alembic check
	@echo -e "$(GREEN)[INFO]$(NC) All checks passed!"

# Health check
health:
	@if $(COMPOSE_CMD) ps | grep -q "healthy"; then \
		echo -e "$(GREEN)✅ Container is healthy!$(NC)"; \
	elif $(COMPOSE_CMD) ps | grep -q "unhealthy"; then \
		echo -e "$(RED)❌ Container is unhealthy!$(NC)"; \
		echo -e "$(RED)[ERROR]$(NC) Recent logs:"; \
		$(COMPOSE_CMD) logs --tail=50; \
		exit 1; \
	else \
		echo -e "$(YELLOW)⚠️  Can't determine health (run make status to sanity check)$(NC)"; \
	fi