Makefile

.PHONY: help install dev test lint format clean docker-up docker-down docs

# Default target
help:
	@echo "╔═══════════════════════════════════════════════════════════╗"
	@echo "║          VELOCE - Full-Stack Framework                  ║"
	@echo "║        Enterprise-Grade AI-Powered Application           ║"
	@echo "╚═══════════════════════════════════════════════════════════╝"
	@echo ""
	@echo "🚀 Available Commands:"
	@echo ""
	@echo "  Development:"
	@echo "    make dev              - Start full development stack"
	@echo "    make dev-backend      - Start backend only"
	@echo "    make dev-frontend     - Start frontend only"
	@echo "    make dev-local        - Start with local docker-compose"
	@echo ""
	@echo "  Testing & Quality:"
	@echo "    make test             - Run all tests"
	@echo "    make test-backend     - Run backend tests"
	@echo "    make test-frontend    - Run frontend tests"
	@echo "    make coverage         - Generate coverage report"
	@echo "    make lint             - Lint all code"
	@echo "    make lint-backend     - Lint backend"
	@echo "    make lint-frontend    - Lint frontend"
	@echo "    make format           - Format all code"
	@echo "    make format-backend   - Format backend code"
	@echo "    make format-frontend  - Format frontend code"
	@echo ""
	@echo "  Security:"
	@echo "    make security-check   - Run security checks"
	@echo "    make audit-backend    - Audit backend dependencies"
	@echo "    make audit-frontend   - Audit frontend dependencies"
	@echo ""
	@echo "  Docker:"
	@echo "    make docker-build     - Build Docker images"
	@echo "    make docker-up        - Start Docker containers"
	@echo "    make docker-down      - Stop Docker containers"
	@echo "    make docker-logs      - Show Docker logs"
	@echo "    make docker-clean     - Clean Docker resources"
	@echo ""
	@echo "  Database:"
	@echo "    make db-migrate       - Run database migrations"
	@echo "    make db-create        - Create test database"
	@echo "    make db-seed          - Seed database with test data"
	@echo ""
	@echo "  Documentation:"
	@echo "    make docs             - Generate documentation"
	@echo "    make docs-serve       - Serve documentation locally"
	@echo ""
	@echo "  Utilities:"
	@echo "    make install          - Install all dependencies"
	@echo "    make clean            - Clean generated files"
	@echo "    make clean-all        - Clean everything including Docker"
	@echo "    make setup            - Initial project setup"
	@echo ""

# ============================================================================
# 🚀 Development Targets
# ============================================================================

setup:
	@echo "🔧 Setting up VELOCE development environment..."
	@cd apps/backend && uv pip install -e ".[dev]"
	@cd ../frontend && npm install
	@cd ../mobile && npm install
	@echo "✅ Setup complete!"

install:
	@echo "📦 Installing dependencies..."
	@make install-backend
	@make install-frontend
	@echo "✅ Installation complete!"

install-backend:
	@echo "📦 Installing backend dependencies..."
	@cd apps/backend && uv pip install -e ".[dev]"

install-frontend:
	@echo "📦 Installing frontend dependencies..."
	@cd apps/frontend && npm install

dev:
	@echo "🚀 Starting full development stack..."
	@cd config/docker && docker-compose -f docker-compose-dev.yml up -d
	@echo "✅ Development stack started!"
	@echo "   - Frontend: http://localhost:3000"
	@echo "   - Backend: http://localhost:8001"
	@echo "   - NGINX: http://localhost:8081"
	@echo "   - Swagger: http://localhost:8001/docs"

dev-backend:
	@echo "🚀 Starting backend development server..."
	@cd apps/backend && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

dev-frontend:
	@echo "🚀 Starting frontend development server..."
	@cd apps/frontend && npm run dev

dev-mobile:
	@echo "🚀 Starting mobile development server..."
	@cd apps/mobile && npm start

dev-local:
	@echo "🚀 Starting local development stack (with external infra)..."
	@cd config/docker && docker-compose -f docker-compose.local.yml up -d
	@echo "✅ Local development stack started!"
	@echo "   - Frontend: http://localhost:3000"
	@echo "   - Backend: http://localhost:8005"
	@echo "   - Swagger: http://localhost:8005/docs"

# ============================================================================
# 🧪 Testing Targets
# ============================================================================

test: test-backend test-frontend
	@echo "✅ All tests passed!"

test-backend:
	@echo "🧪 Running backend tests..."
	@cd apps/backend && pytest -v --tb=short

test-backend-watch:
	@echo "👀 Running backend tests in watch mode..."
	@cd apps/backend && pytest-watch

test-backend-cov:
	@echo "📊 Running backend tests with coverage..."
	@cd apps/backend && pytest --cov=app --cov-report=html --cov-report=term

test-frontend:
	@echo "🧪 Running frontend tests..."
	@cd apps/frontend && npm test

test-frontend-cov:
	@echo "📊 Running frontend tests with coverage..."
	@cd apps/frontend && npm test -- --coverage

coverage: test-backend-cov test-frontend-cov
	@echo "✅ Coverage reports generated!"
	@echo "   - Backend: apps/backend/htmlcov/index.html"
	@echo "   - Frontend: apps/frontend/coverage/index.html"

# ============================================================================
# 🔍 Linting & Formatting Targets
# ============================================================================

lint: lint-backend lint-frontend
	@echo "✅ Linting complete!"

lint-backend:
	@echo "🔍 Linting backend code..."
	@cd apps/backend && ruff check .
	@cd apps/backend && pylint app/ || true

lint-frontend:
	@echo "🔍 Linting frontend code..."
	@cd apps/frontend && npm run lint

format: format-backend format-frontend
	@echo "✅ Formatting complete!"

format-backend:
	@echo "🎨 Formatting backend code..."
	@cd apps/backend && ruff format .
	@cd apps/backend && black .

format-frontend:
	@echo "🎨 Formatting frontend code..."
	@cd apps/frontend && npm run format
	@cd apps/frontend && npm run lint -- --fix

# ============================================================================
# 🔒 Security Targets
# ============================================================================

security-check: audit-backend audit-frontend
	@echo "✅ Security checks complete!"

audit-backend:
	@echo "🔒 Auditing backend dependencies..."
	@cd apps/backend && safety check || true
	@cd apps/backend && bandit -r app/ || true

audit-frontend:
	@echo "🔒 Auditing frontend dependencies..."
	@cd apps/frontend && npm audit || true

# ============================================================================
# 🐳 Docker Targets
# ============================================================================

docker-build:
	@echo "🐳 Building Docker images..."
	@cd config/docker && docker-compose -f docker-compose-dev.yml build

docker-up:
	@echo "🚀 Starting Docker containers..."
	@cd config/docker && docker-compose -f docker-compose-dev.yml up -d

docker-down:
	@echo "⛔ Stopping Docker containers..."
	@cd config/docker && docker-compose -f docker-compose-dev.yml down

docker-restart:
	@echo "🔄 Restarting Docker containers..."
	@cd config/docker && docker-compose -f docker-compose-dev.yml restart

docker-logs:
	@echo "📋 Showing Docker logs..."
	@cd config/docker && docker-compose -f docker-compose-dev.yml logs -f

docker-logs-backend:
	@echo "📋 Showing backend logs..."
	@cd config/docker && docker-compose -f docker-compose-dev.yml logs -f backend

docker-logs-frontend:
	@echo "📋 Showing frontend logs..."
	@cd config/docker && docker-compose -f docker-compose-dev.yml logs -f frontend

docker-clean:
	@echo "🧹 Cleaning Docker resources..."
	@docker system prune -f

docker-clean-all:
	@echo "🧹 Cleaning all Docker resources..."
	@docker system prune -af --volumes

# ============================================================================
# 💾 Database Targets
# ============================================================================

db-create:
	@echo "💾 Creating database..."
	@cd apps/backend && python -m scripts.create_test_user

db-migrate:
	@echo "🔄 Running database migrations..."
	@cd apps/backend && alembic upgrade head

db-migrate-down:
	@echo "⬅️  Reverting last migration..."
	@cd apps/backend && alembic downgrade -1

db-seed:
	@echo "🌱 Seeding database with test data..."
	@cd apps/backend && python -m scripts.seed_database

# ============================================================================
# 📚 Documentation Targets
# ============================================================================

docs:
	@echo "📚 Generating documentation..."
	@echo "Documentation files:"
	@echo "  - README.md"
	@echo "  - ABOUT.md"
	@echo "  - CONTRIBUTING.md"
	@echo "  - SECURITY.md"
	@echo "  - CHANGELOG.md"

docs-serve:
	@echo "📖 Serving documentation locally..."
	@echo "Open browser to: http://localhost:8000"
	@python -m http.server 8000 --directory docs

# ============================================================================
# 🧹 Cleanup Targets
# ============================================================================

clean:
	@echo "🧹 Cleaning generated files..."
	@find . -type d -name __pycache__ -exec rm -rf {} + || true
	@find . -type f -name "*.pyc" -delete || true
	@find . -type d -name ".pytest_cache" -exec rm -rf {} + || true
	@find . -type d -name ".ruff_cache" -exec rm -rf {} + || true
	@find . -type d -name "dist" -exec rm -rf {} + || true
	@find . -type d -name "build" -exec rm -rf {} + || true
	@find . -type d -name ".tox" -exec rm -rf {} + || true
	@cd apps/frontend && rm -rf node_modules dist build || true
	@echo "✅ Cleanup complete!"

clean-all: clean docker-clean-all
	@echo "🧹 Complete cleanup (including Docker)..."
	@echo "✅ All cleaned!"

# ============================================================================
# 📊 Analysis Targets
# ============================================================================

analysis:
	@echo "📊 Running code analysis..."
	@echo "Backend files: $$(find apps/backend/app -name '*.py' | wc -l)"
	@echo "Frontend files: $$(find apps/frontend/src -name '*.{js,jsx,ts,tsx}' | wc -l)"
	@echo "Test files: $$(find . -path ./node_modules -prune -o -name '*test*.py' -o -name '*test*.ts' | wc -l)"
	@echo "Total lines in backend: $$(find apps/backend/app -name '*.py' -exec wc -l {} + | tail -1)"

# ============================================================================
# 🚀 Deployment Targets
# ============================================================================

build-prod:
	@echo "🏗️  Building production artifacts..."
	@cd apps/backend && pip install -e .
	@cd ../frontend && npm run build

deploy-local:
	@echo "🚀 Deploying locally..."
	@make docker-build
	@make docker-up
	@make db-migrate
	@echo "✅ Deployed locally!"

# ============================================================================
# ℹ️ Info Targets
# ============================================================================

info:
	@echo "ℹ️  VELOCE Project Information"
	@echo ""
	@echo "📦 Python Version:"
	@python --version
	@echo "📦 Node Version:"
	@node --version
	@echo "📦 Docker Version:"
	@docker --version
	@echo ""
	@echo "📁 Project Structure:"
	@du -sh apps/* config/* 2>/dev/null || true

.DEFAULT_GOAL := help