Makefile

# GitHub Stars Constellation - Development Makefile
.PHONY: help install backend frontend frontend-react frontend-demo run clean clean-venv test lint format

# Default target
help:
	@echo "🌟 GitHub Stars Constellation - Available Commands:"
	@echo ""
	@echo "📦 Installation & Setup:"
	@echo "  make install       - Install Python dependencies with uv"
	@echo "  make clean-venv    - Remove virtual environments"
	@echo ""
	@echo "🚀 Development Servers:"
	@echo "  make backend       - Start FastAPI backend server (port 8001)"
	@echo "  make frontend      - Start React frontend (port 5173)"
	@echo "  make frontend-demo - Start simple HTML demo (port 3001)"
	@echo "  make run           - Start both backend and React frontend"
	@echo ""
	@echo "🔧 Development Tools:"
	@echo "  make test          - Run Python tests"
	@echo "  make lint          - Run code linting"
	@echo "  make format        - Format code"
	@echo "  make clean         - Clean build artifacts"

# Install dependencies
install:
	@echo "🔧 Installing dependencies with uv..."
	uv sync
	@echo "✅ Dependencies installed successfully!"

# Start backend server
backend:
	@echo "🚀 Starting FastAPI backend server..."
	uv run python -m backend.main

# Start React frontend (Phase 4)
frontend:
	@echo "🚀 Starting React frontend server..."
	cd frontend-react && npm run dev

# Start simple frontend demo (Phase 3)
frontend-demo:
	@echo "🚀 Starting simple frontend demo server..."
	cd frontend && python3 -m http.server 3001

# Start both backend and React frontend
run:
	@echo "🚀 Starting both backend and React frontend servers..."
	@echo "Backend: http://localhost:8001"
	@echo "Frontend: http://localhost:5173"
	@echo "API Docs: http://localhost:8001/docs"
	@$(MAKE) -j2 backend frontend

# Clean build artifacts
clean:
	@echo "🧹 Cleaning build artifacts..."
	find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
	find . -type f -name "*.pyc" -delete 2>/dev/null || true
	find . -type d -name ".pytest_cache" -exec rm -rf {} + 2>/dev/null || true
	rm -rf backend/dist/ backend/build/ 2>/dev/null || true
	rm -rf frontend-react/dist/ frontend-react/build/ 2>/dev/null || true
	@echo "✅ Cleanup complete!"

# Clean virtual environments
clean-venv:
	@echo "🧹 Removing virtual environments..."
	rm -rf .venv backend/.venv 2>/dev/null || true
	@echo "✅ Virtual environments removed!"

# Run tests
test:
	@echo "🧪 Running tests..."
	uv run python -m pytest backend/tests/ -v

# Run linting
lint:
	@echo "🔍 Running linters..."
	uv run python -m black --check backend/
	uv run python -m isort --check-only backend/
	uv run python -m mypy backend/

# Format code
format:
	@echo "✨ Formatting code..."
	uv run python -m black backend/
	uv run python -m isort backend/