# Nakani ML API — raccourcis. `make` ou `make help` pour la liste.
#
#   make start    # prod : Uvicorn en arrière-plan (survit à la fermeture SSH)
#   make stop     # arrête le process démarré par make start
#   make status   # pid + health
#   make serve    # premier plan (s'arrête si tu fermes le terminal)
#   make dev      # reload auto (premier plan)

PYTHON      ?= $(shell command -v python3.12 || command -v python3.13 || command -v python3)
VENV        ?= .venv
BIN         := $(VENV)/bin
# Toujours via `python -m` : les scripts du venv peuvent perdre leur bit d'exécution
# (rsync, umask, déploiement) alors que l'interpréteur reste utilisable.
PY          := $(BIN)/python
# Port libre auto (scripts/resolve_port.py) : PORT/HOST make|env → .env → 1er libre 8001–8099.
# Ne jamais coder 8000 en dur (souvent déjà pris, ex. digitalworkpro).
RESOLVE     := $(PY) scripts/resolve_port.py
SFACE       := app/services/kyc/models/face_recognition_sface_2021dec.onnx
PIDFILE     := tmp/uvicorn.pid
LOGFILE     ?= $(HOME)/logs/ml-uvicorn.log

.DEFAULT_GOAL := help

help: ## Affiche cette aide
	@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-10s\033[0m %s\n", $$1, $$2}'

$(BIN)/python:
	@echo "→ venv ($(PYTHON))"
	$(PYTHON) -m venv $(VENV)
	$(BIN)/python -m pip install --quiet --upgrade pip

venv: $(BIN)/python ## Crée le venv (Python 3.12/3.13)

install: venv ## Installe le service + OCR + outils de dev
	$(BIN)/python -m pip install --quiet -e ".[dev,ocr,audio]"
	@# rapidocr tire `opencv-python` (desktop, exige libGL.so.1) qui écrase le `cv2`
	@# de `opencv-python-headless`. Serveur sans stack graphique → on garde le headless.
	@if $(BIN)/python -m pip show opencv-python >/dev/null 2>&1 || $(BIN)/python -m pip show opencv-contrib-python >/dev/null 2>&1; then \
		$(BIN)/python -m pip uninstall --quiet -y opencv-python opencv-contrib-python; \
		$(BIN)/python -m pip install --quiet --force-reinstall --no-deps opencv-python-headless; \
	fi

.env:
	cp .env.example .env
	@echo "→ .env créé depuis .env.example : renseigne API_KEY"

models: install ## Télécharge les modèles non versionnés (SFace, SHA-256 vérifié)
	@test -f $(SFACE) || $(BIN)/python -m app.services.kyc.models

setup: install .env models ## Tout préparer sans lancer (venv, deps, .env, modèles)

# Résout HOST/PORT, persiste dans .env. Override : make start PORT=8011
define RESOLVE_LISTEN
	ARGS="$(if $(PORT),--port $(PORT),) $(if $(HOST),--host $(HOST),)"; \
	HP=$$($(RESOLVE) --write-env $$ARGS); \
	H=$${HP%% *}; P=$${HP##* }
endef

ports: ## Liste les ports occupés dans 8001–8099
	@$(PYTHON) scripts/resolve_port.py --list

dev: setup ## Premier plan + reload (s'arrête à la fermeture du terminal)
	@set -e; $(RESOLVE_LISTEN); \
	echo "→ écoute $${H}:$${P} (premier plan)"; \
	$(PY) -m uvicorn app.main:app --reload --host $${H} --port $${P}

serve: setup ## Premier plan sans reload (s'arrête à la fermeture du terminal)
	@set -e; $(RESOLVE_LISTEN); \
	echo "→ écoute $${H}:$${P} (premier plan — utilise make start en prod)"; \
	$(PY) -m uvicorn app.main:app --host $${H} --port $${P} --workers 1

start: setup stop ## Arrière-plan (nohup) — survit à la fermeture SSH
	@set -e; $(RESOLVE_LISTEN); \
	mkdir -p tmp "$$(dirname "$(LOGFILE)")"; \
	echo "→ écoute $${H}:$${P} (arrière-plan, log $(LOGFILE))"; \
	nohup $(PY) -m uvicorn app.main:app --host $${H} --port $${P} --workers 1 \
		>> "$(LOGFILE)" 2>&1 & \
	echo $$! > "$(PIDFILE)"; \
	sleep 1; \
	if kill -0 "$$(cat "$(PIDFILE)")" 2>/dev/null; then \
		echo "→ démarré pid $$(cat "$(PIDFILE)") — make status / make stop"; \
	else \
		echo "✗ échec démarrage — voir $(LOGFILE)"; exit 1; \
	fi

stop: ## Arrête Uvicorn démarré par make start
	@if [ -f "$(PIDFILE)" ]; then \
		pid=$$(tr -d '[:space:]' < "$(PIDFILE)"); \
		if [ -n "$$pid" ] && kill -0 "$$pid" 2>/dev/null; then \
			echo "→ arrêt pid $$pid"; \
			kill "$$pid" 2>/dev/null || true; \
			sleep 1; \
			kill -0 "$$pid" 2>/dev/null && kill -9 "$$pid" 2>/dev/null || true; \
		fi; \
		rm -f "$(PIDFILE)"; \
	else \
		echo "→ aucun pidfile ($(PIDFILE))"; \
	fi

restart: start ## stop + start

status: ## Affiche pid, port et /health
	@if [ -f "$(PIDFILE)" ]; then \
		pid=$$(tr -d '[:space:]' < "$(PIDFILE)"); \
		if [ -n "$$pid" ] && kill -0 "$$pid" 2>/dev/null; then \
			echo "pid $$pid (running)"; \
		else \
			echo "pidfile présent mais process mort (pid $$pid)"; \
		fi; \
	else \
		echo "arrêté (pas de $(PIDFILE))"; \
	fi
	@P=$$(grep -E '^APP_PORT=' .env 2>/dev/null | cut -d= -f2); \
	if [ -n "$$P" ]; then \
		echo -n "health : "; \
		curl -sS --max-time 5 "http://127.0.0.1:$${P}/health" || echo "injoignable"; \
		echo; \
	fi

test: install ## Tests (moteur noop, pas de modèle requis)
	$(PY) -m pytest -q

lint: install ## ruff format --check + ruff check
	$(PY) -m ruff format --check app tests
	$(PY) -m ruff check app tests

fmt: install ## Formate le code
	$(PY) -m ruff format app tests
	$(PY) -m ruff check --fix app tests

check: lint test ## Lint + tests

ready: ## Vérifie le service local (/ready) via APP_PORT du .env
	@P=$$(grep -E '^APP_PORT=' .env 2>/dev/null | cut -d= -f2); \
	if [ -z "$$P" ]; then echo "APP_PORT absent dans .env — lance make start d'abord"; exit 1; fi; \
	curl -sS "http://127.0.0.1:$${P}/ready" || echo "service injoignable sur $${P}"

clean: ## Supprime le venv et les caches
	rm -rf $(VENV) .pytest_cache .ruff_cache

.PHONY: help venv install models setup ports dev serve start stop restart status test lint fmt check ready clean
