Makefile

.PHONY: help dev infra backend stop logs test lint clean setup health prune

# Default target
help:
	@echo "QuantForge AI Engine - Development Commands"
	@echo ""
	@echo "  SETUP"
	@echo "    make setup       - First-time setup (create .env, pull images)"
	@echo "    make install     - Install Python dependencies locally"
	@echo ""
	@echo "  DEVELOPMENT"
	@echo "    make dev         - Start infra + backend (full stack)"
	@echo "    make infra       - Start infrastructure services only"
	@echo "    make backend     - Start backend locally (uvicorn)"
	@echo "    make stop        - Stop all Docker services"
	@echo ""
	@echo "  MAINTENANCE"
	@echo "    make logs        - View Docker logs"
	@echo "    make health      - Check health of services"
	@echo "    make test        - Run tests"
	@echo "    make lint        - Run linters"
	@echo "    make clean       - Remove containers and volumes"
	@echo "    make prune       - Clean up Docker (reclaim disk space)"
	@echo ""
	@echo "  DATABASE"
	@echo "    make migrate     - Run Alembic migrations"
	@echo "    make db-shell    - Open psql shell to TimescaleDB"

# =============================================================================
# SETUP
# =============================================================================

# First-time setup
setup:
	@echo "Setting up QuantForge development environment..."
	@if not exist .env copy .env.example .env
	docker compose pull
	@echo ""
	@echo "Setup complete! Run 'make dev' to start."

# Install Python dependencies locally
install:
	pip install -r requirements.txt

# =============================================================================
# DEVELOPMENT
# =============================================================================

# Start infrastructure services (Docker) + backend (local)
dev: infra
	@echo ""
	@echo "Starting backend locally..."
	@echo "Press Ctrl+C to stop"
	@echo ""
	uvicorn backend.main:app --reload --host 127.0.0.1 --port 8000

# Start infrastructure services only (Docker)
infra:
	docker compose up -d
	@echo ""
	@echo "Infrastructure services starting..."
	@echo "  Redis:       localhost:6379"
	@echo "  MinIO:       http://localhost:9001"
	@echo "  Weaviate:    http://localhost:8080"
	@echo "  TimescaleDB: localhost:5433"
	@echo "  Ollama:      http://localhost:11434"

# Start backend locally (assumes infra is running)
backend:
	@echo "Starting backend..."
	@echo "  API:     http://localhost:8000"
	@echo "  Swagger: http://localhost:8000/docs"
	@echo ""
	uvicorn backend.main:app --reload --host 127.0.0.1 --port 8000

# Start Celery worker locally
celery:
	celery -A backend.workers.celery_app worker --loglevel=info

# Stop all Docker services
stop:
	docker compose down

# =============================================================================
# MAINTENANCE
# =============================================================================

# View Docker logs
logs:
	docker compose logs -f

# View logs for specific service
logs-%:
	docker compose logs -f $*

# Check health of services
health:
	@echo "Checking service health..."
	@echo ""
	@docker ps --filter "name=quantforge" --format "table {{.Names}}\t{{.Status}}"

# Run tests locally
test:
	pytest tests/ -v

# Run linters
lint:
	black backend/ tests/ --check
	isort backend/ tests/ --check-only
	mypy backend/

# Format code
format:
	black backend/ tests/
	isort backend/ tests/

# Clean up containers and volumes
clean:
	docker compose down -v
	@echo "Containers and volumes removed."

# Clean up Docker to reclaim disk space
prune:
	@echo "Cleaning up Docker..."
	docker system prune -a -f
	docker builder prune -f
	@echo ""
	@echo "Disk space reclaimed!"
	@docker system df

# =============================================================================
# DATABASE
# =============================================================================

# Run Alembic migrations
migrate:
	alembic upgrade head

# Create new migration
migration:
	@read -p "Migration message: " msg; \
	alembic revision --autogenerate -m "$$msg"

# Open psql shell to TimescaleDB
db-shell:
	docker exec -it quantforge-timescale psql -U quantforge -d market_data