Makefile

# Makefile para Proyecto IACT
# Gestión de documentación, pruebas y desarrollo

.PHONY: help docs-install docs-build docs-serve docs-clean docs-deploy clean test vagrant-up vagrant-down vagrant-ssh validate_spec check_all generate_plan install_hooks

# Variables
MKDOCS_CONFIG = docs/mkdocs.yml
SITE_DIR = site
DOCS_REQUIREMENTS = docs/requirements.txt
PYTHON = python3
PIP = pip

# Colores para output
BLUE = \033[0;34m
GREEN = \033[0;32m
YELLOW = \033[0;33m
NC = \033[0m # No Color

##@ General

help: ## Mostrar esta ayuda
	@echo ""
	@echo "$(BLUE)Comandos disponibles para proyecto IACT:$(NC)"
	@echo ""
	@awk 'BEGIN {FS = ":.*##"; printf ""} /^[a-zA-Z_-]+:.*?##/ { printf "  $(GREEN)%-20s$(NC) %s\n", $$1, $$2 } /^##@/ { printf "\n$(YELLOW)%s$(NC)\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
	@echo ""

##@ Documentación

docs-install: ## Instalar dependencias de MkDocs
	@echo "$(BLUE)Instalando dependencias de documentación...$(NC)"
	$(PIP) install -r $(DOCS_REQUIREMENTS)
	@echo "$(GREEN)[OK] Dependencias instaladas$(NC)"

docs-build: ## Construir documentación estática
	@echo "$(BLUE)Construyendo documentación...$(NC)"
	mkdocs build -f $(MKDOCS_CONFIG)
	@echo "$(GREEN)[OK] Documentación construida en $(SITE_DIR)/$(NC)"

docs-serve: ## Servir documentación con live reload (http://127.0.0.1:8000)
	@echo "$(BLUE)Iniciando servidor de documentación...$(NC)"
	@echo "$(YELLOW)Accede a: http://127.0.0.1:8000$(NC)"
	mkdocs serve -f $(MKDOCS_CONFIG)

docs-clean: ## Limpiar archivos de documentación generados
	@echo "$(BLUE)Limpiando archivos de documentación...$(NC)"
	rm -rf $(SITE_DIR)
	@echo "$(GREEN)[OK] Archivos de documentación eliminados$(NC)"

docs-deploy: ## Desplegar documentación a GitHub Pages
	@echo "$(BLUE)Desplegando documentación a GitHub Pages...$(NC)"
	mkdocs gh-deploy -f $(MKDOCS_CONFIG)
	@echo "$(GREEN)[OK] Documentación desplegada$(NC)"
	@echo "$(YELLOW)URL: https://2-coatl.github.io/IACT---project/$(NC)"

docs-check: ## Verificar enlaces y estructura de documentación
	@echo "$(BLUE)Verificando documentación...$(NC)"
	mkdocs build -f $(MKDOCS_CONFIG) --strict
	@echo "$(GREEN)[OK] Documentación verificada$(NC)"

##@ Desarrollo

vagrant-up: ## Levantar VM Vagrant (PostgreSQL + MariaDB)
	@echo "$(BLUE)Levantando infraestructura Vagrant...$(NC)"
	vagrant up
	@echo "$(GREEN)[OK] VM levantada$(NC)"
	@echo "$(YELLOW)PostgreSQL: 127.0.0.1:15432$(NC)"
	@echo "$(YELLOW)MariaDB: 127.0.0.1:13306$(NC)"

vagrant-down: ## Apagar VM Vagrant
	@echo "$(BLUE)Apagando VM Vagrant...$(NC)"
	vagrant halt
	@echo "$(GREEN)[OK] VM apagada$(NC)"

vagrant-ssh: ## Conectar a VM Vagrant por SSH
	vagrant ssh

vagrant-destroy: ## Destruir VM Vagrant completamente
	@echo "$(YELLOW)[WARN] Esto eliminará completamente la VM$(NC)"
	@read -p "¿Continuar? [y/N] " -n 1 -r; \
	echo; \
	if [[ $$REPLY =~ ^[Yy]$$ ]]; then \
		vagrant destroy -f; \
		echo "$(GREEN)[OK] VM destruida$(NC)"; \
	else \
		echo "$(YELLOW)Cancelado$(NC)"; \
	fi

check-services: ## Verificar servicios de base de datos
	@echo "$(BLUE)Verificando servicios...$(NC)"
	./scripts/verificar_servicios.sh

##@ Spec-Driven Development

validate_spec: ## Validar especificaciones de features
	@echo "$(BLUE)Validando especificaciones...$(NC)"
	@if [ -z "$(SPEC)" ]; then \
		./scripts/dev/validate_spec.sh --all; \
	else \
		./scripts/dev/validate_spec.sh $(SPEC); \
	fi

check_all: ## Ejecutar todos los checks de calidad (pre-commit, emojis, specs)
	@echo "$(BLUE)Ejecutando todos los checks...$(NC)"
	./scripts/dev/check_all.sh

check_all-fix: ## Ejecutar checks con auto-corrección
	@echo "$(BLUE)Ejecutando checks con auto-corrección...$(NC)"
	./scripts/dev/check_all.sh --fix

generate_plan: ## Generar plan de implementación desde spec
	@if [ -z "$(SPEC)" ]; then \
		echo "$(YELLOW)Uso: make generate_plan SPEC=docs/specs/mi-feature.md$(NC)"; \
		exit 1; \
	fi
	@echo "$(BLUE)Generando plan desde: $(SPEC)$(NC)"
	./scripts/dev/generate_plan.sh $(SPEC)

install_hooks: ## Instalar git hooks (pre-push)
	@echo "$(BLUE)Instalando git hooks...$(NC)"
	./scripts/install_hooks.sh
	@echo ""
	@echo "$(GREEN)[OK] Hooks instalados$(NC)"
	@echo "$(YELLOW)Los hooks se ejecutarán automáticamente antes de push$(NC)"
	@echo ""
	@echo "Para verificar: ./scripts/install_hooks.sh --verify"
	@echo "Para desinstalar: ./scripts/install_hooks.sh --uninstall"

##@ CPython Build System

build_cpython: ## Compilar CPython en Vagrant (uso: make build_cpython VERSION=3.12.6 BUILD=1)
	@if [ -z "$(VERSION)" ]; then \
		echo "$(YELLOW)Uso: make build_cpython VERSION=3.12.6 [BUILD=1]$(NC)"; \
		exit 1; \
	fi
	@echo "$(BLUE)Compilando CPython $(VERSION) build $(BUILD)...$(NC)"
	./infrastructure/cpython/scripts/build_wrapper.sh $(VERSION) $(BUILD)

validate-cpython: ## Validar artefacto CPython (uso: make validate-cpython ARTIFACT=cpython-X.Y.Z-ubuntu20.04-build1.tgz)
^I@if [ -z "$(ARTIFACT)" ]; then \
^I^Iecho "$(YELLOW)Uso: make validate-cpython ARTIFACT=cpython-3.12.6-ubuntu20.04-build1.tgz$(NC)"; \
^I^Iexit 1; \
	fi
	@echo "$(BLUE)Validando artefacto: $(ARTIFACT)$(NC)"
	./infrastructure/cpython/scripts/validate_wrapper.sh $(ARTIFACT)

list-artifacts: ## Listar artefactos CPython disponibles
	@echo "$(BLUE)Artefactos CPython disponibles:$(NC)"
	@echo ""
	@if [ -d "infrastructure/cpython/artifacts" ] && [ "$$(ls -A infrastructure/cpython/artifacts/*.tgz 2>/dev/null)" ]; then \
		ls -lh infrastructure/cpython/artifacts/*.tgz | awk '{print "  " $$9 " (" $$5 ")"}'; \
	else \
		echo "  $(YELLOW)No hay artefactos generados aún$(NC)"; \
	fi
	@echo ""
	@echo "Ver registro completo: cat infrastructure/cpython/artifacts/ARTIFACTS.md"

vagrant-cpython-up: ## Iniciar VM de compilación CPython
	@echo "$(BLUE)Iniciando VM de compilación CPython...$(NC)"
	cd infrastructure/cpython && vagrant up

vagrant-cpython-ssh: ## Conectar a VM de compilación CPython
	@echo "$(BLUE)Conectando a VM...$(NC)"
	cd infrastructure/cpython && vagrant ssh

vagrant-cpython-halt: ## Detener VM de compilación CPython
	@echo "$(BLUE)Deteniendo VM...$(NC)"
	cd infrastructure/cpython && vagrant halt

##@ Testing

test: ## Ejecutar pruebas del proyecto (cuando estén disponibles)
	@echo "$(YELLOW)[WARN] No hay tests configurados actualmente$(NC)"
	@echo "$(BLUE)Para configurar tests, crear pytest.ini y tests/$(NC)"

##@ Limpieza

clean: docs-clean ## Limpiar todos los archivos generados
	@echo "$(BLUE)Limpiando archivos generados...$(NC)"
	find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
	find . -type f -name "*.pyc" -delete 2>/dev/null || true
	find . -type f -name "*.pyo" -delete 2>/dev/null || true
	find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
	@echo "$(GREEN)[OK] Archivos limpiados$(NC)"

##@ Instalación completa

setup: docs-install ## Configurar entorno completo del proyecto
	@echo "$(BLUE)Configurando entorno del proyecto...$(NC)"
	@echo "$(GREEN)[OK] Configuración completada$(NC)"
	@echo ""
	@echo "$(YELLOW)Próximos pasos:$(NC)"
	@echo "  1. make vagrant-up      # Levantar bases de datos"
	@echo "  2. make check-services  # Verificar conectividad"
	@echo "  3. make docs-serve      # Ver documentación"
	@echo "  4. make install_hooks   # Instalar git hooks (pre-push)"
	@echo "  5. make check_all       # Validar código antes de commit"
	@echo ""

##@ Atajos comunes

docs: docs-build ## Alias para docs-build
serve: docs-serve ## Alias para docs-serve
deploy: docs-deploy ## Alias para docs-deploy