PYTHON ?= python3
BASE_URL ?= http://localhost:8080
CA_FILE ?=
ACTION_SCRIPT ?=
TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",)

.PHONY: help check validate test load test-persistence test-failover

help:
	@echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes"

check:
	$(PYTHON) scripts/check_contract.py

validate:
	$(PYTHON) scripts/validate_openapi.py

test:
	$(PYTHON) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS)

load:
	$(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS)

test-persistence:
	@test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2)
	$(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)

test-failover:
	@test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2)
	$(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)

# ---------------------------------------------------------------------------
# Student solution (lab 3, Python). On Windows: PowerShell/Git Bash with GNU make, public
# tests need PYTHONUTF8=1, and the hooks are started through scripts/*.cmd (Git Bash).
.PHONY: secrets up down logs ps migrate student-test unit-test explain lb-status restore rolling-update failover-series

secrets:
	$(PYTHON) scripts/init_secrets.py

# Build, apply migrations ONCE (service migrate), start API replicas and the LB, wait for healthy.
up: secrets
	docker compose up -d --build --wait

# Safe stop: containers stop, named volumes (data) stay.
down:
	docker compose down

logs:
	docker compose logs --tail 50 api lb

ps:
	docker compose ps -a

migrate:
	docker compose run --rm migrate

# HAProxy view of the replicas (UP/DOWN) mapped to containers and X-Instance-Id.
lb-status:
	$(PYTHON) scripts/lbctl.py status
	$(PYTHON) scripts/lbctl.py replicas

# Start replicas stopped by scripts/stop-one.sh again and wait until the LB has them all UP.
restore:
	sh scripts/restore-api.sh
	$(PYTHON) scripts/lbctl.py wait-up $${API_REPLICAS:-2}

# Replace every API replica one by one with a freshly built image (no downtime).
rolling-update:
	sh scripts/rolling-update.sh

# Level 4: stop each replica in turn under load, measure RPS/errors/recovery (evidence/failover/).
failover-series:
	$(PYTHON) bench/failover_series.py --output evidence/failover

# Own tests: unit + black-box against the running stand (needs requirements*.txt in a venv).
student-test:
	$(PYTHON) -m pytest student-tests -v

unit-test:
	$(PYTHON) -m pytest student-tests -m "not stack" -q

explain:
	$(PYTHON) scripts/explain_history.py --output evidence/explain-history.txt
