# Makefile for Go Places Project
# ---------------------------------
# Port Configuration:
#   - Go API:      defaults to :8080 (via ADDR env var)
#   - React UI:    defaults to :5173 (via Vite)
#   - Proxy:       forwards /api, /graphql, /media, /healthz to Go API
# ---------------------------------

# --- Configuration ---
API_CHART_PATH := ./charts/api
LOOSE_CHART_PATH := ./charts/go-loose
API_DIR := api
BIN_DIR := bin
API_BINARY := $(BIN_DIR)/go-places

# --- Targets ---

.PHONY: all build build-api build-loose run test fmt vet validate dry-run-deploy deploy clean help

# Default target: build the service that lives in this repository.
all: build-api

# Main build target.
build: build-api

# Build go-places. The module root is api/, so the build has to run there
# rather than from the repository root.
build-api:
	@echo "--- Building go-places ---"
	@mkdir -p $(BIN_DIR)
	cd $(API_DIR) && go build -o ../$(API_BINARY) ./cmd
	@echo "built $(API_BINARY)"

# go-loose is the authentication service this API depends on. Its source lives in
# its own repository, so it cannot be built from here.
build-loose:
	@echo "go-loose is a separate service and its source is not part of this repository." >&2
	@echo "See charts/$(notdir $(LOOSE_CHART_PATH))/values.yaml for how it is deployed." >&2
	@exit 1

# Run the service locally with development defaults.
# The already-built binary is exec'd rather than run through "go run", so the
# process make starts is the service itself: startup is immediate (no second
# compile) and Ctrl-C reaches it directly.
# Environment variables:
#   ADDR      - Go API listen address (default: :8080)
#   AUTH_MODE   - Authentication mode: dev or jwt (default: dev)
#   ENABLE_REST   - Enable REST endpoints (default: true)
run: build-api
	cd $(API_DIR) && AUTH_MODE=dev ENABLE_REST=true exec ../$(API_BINARY)

# React UI development server
# Forwards /api, /graphql, /media, /healthz to the Go API via Vite proxy.
# Vite dev server runs on :5173 by default (or next available port).
# Environment variable:
#   VITE_PROXY_TARGET - API target URL (default: http://localhost:8080)
web-dev:
	cd web && npm run dev

test:
	cd $(API_DIR) && go test ./...

fmt:
	cd $(API_DIR) && go fmt ./...

vet:
	cd $(API_DIR) && go vet ./...

# Validate all Helm charts.
validate:
	@echo "--- Validating Helm Charts ---"
	helm lint $(API_CHART_PATH) $(LOOSE_CHART_PATH)
	@echo "Helm linting complete."

# Dry run deployment to validate manifests before applying to a cluster.
dry-run-deploy:
	@echo "--- DRY RUN: Validating API Helm Chart ---"
	helm lint $(API_CHART_PATH)
	@echo "--- DRY RUN: Validating go-loose Helm Chart ---"
	helm lint $(LOOSE_CHART_PATH)
	@echo "Dry run validation complete. Manifests look correct."

# Deploy all charts to a target environment (requires configured k8s context).
deploy: validate
	@echo "--- Deploying all charts to Kubernetes ---"
	helm upgrade --install go-places $(API_CHART_PATH) --namespace dev --create-namespace -f $(API_CHART_PATH)/values.yaml
	helm upgrade --install go-loose $(LOOSE_CHART_PATH) --namespace dev --create-namespace -f $(LOOSE_CHART_PATH)/values.yaml
	@echo "Deployment process initiated. Check cluster status."

# Clean up generated files or images (if any)
clean:
	@echo "--- Cleaning up build artifacts ---"
	rm -rf $(BIN_DIR)

# Help target
help:
	@echo "=========================================="
	@echo "Go Places Project Makefile Help"
	@echo "make all             : Build the go-places service."
	@echo "make build           : Alias for 'make all'."
	@echo "make build-api       : Build bin/go-places from ./api."
	@echo "make run             : Run the API locally with AUTH_MODE=dev."
	@echo "make web-dev         : Start Vite dev server for React UI (ports: API:8080, UI:5173)"
	@echo "make test            : Run the Go tests."
	@echo "make fmt / vet       : Format / vet the Go sources."
	@echo "make build-loose     : Not buildable here; go-loose is a separate repo."
	@echo "make validate        : Run 'helm lint' on both charts."
	@echo "make dry-run-deploy  : Validate Helm charts without deploying."
	@echo "make deploy          : Validate charts and deploy to Kubernetes."
	@echo "make clean           : Remove local build artifacts."