orion/Makefile

# Multitenant ecommerce application Makefile (Windows Compatible)
.PHONY: install install-dev install-docs install-all dev test test-coverage lint format check docker-build docker-up docker-down clean help

# Detect if we're in a virtual environment and set Python path accordingly
PYTHON := python
PIP := pip

# =============================================================================
# INSTALLATION & SETUP
# =============================================================================

install:
	$(PIP) install -r requirements.txt

install-dev: install
	$(PIP) install -r requirements-dev.txt

install-test:
	$(PIP) install -r requirements-test.txt

install-docs:
	$(PIP) install -r requirements-docs.txt

install-all: install install-dev install-test install-docs

setup: install-all migrate-up
	@echo Development environment setup complete!
	@echo Run 'make dev' to start development server

# =============================================================================
# DEVELOPMENT SERVERS
# =============================================================================

dev:
	$(PYTHON) -m uvicorn main:app --reload --host 0.0.0.0 --port 8000

dev-with-docs:
	@echo Starting API and documentation servers...
	@start /B $(PYTHON) -m uvicorn main:app --reload --host 0.0.0.0 --port 8000
	@timeout /t 3 >nul
	@$(PYTHON) -m mkdocs serve --dev-addr=0.0.0.0:8001

dev-full: dev-with-docs
	@echo Development environment ready!
	@echo API server: http://localhost:8000
	@echo API docs: http://localhost:8000/docs
	@echo Documentation: http://localhost:8001

# =============================================================================
# DATABASE MIGRATIONS
# =============================================================================

migrate-create:
	@if [ "$(message)" = "" ]; then \
		echo "Error: Please provide a message. Usage: make migrate-create message=\"your_description\""; \
	else \
		$(PYTHON) -m alembic revision --autogenerate -m "$(message)"; \
	fi

migrate-create-manual:
	@if "$(message)"=="" (echo Error: Please provide a message. Usage: make migrate-create-manual message="your_description") else ($(PYTHON) -m alembic revision -m "$(message)")

migrate-up:
	@echo Running database migrations...
	$(PYTHON) -m alembic upgrade head
	@echo Migrations completed successfully

migrate-down:
	@echo Rolling back last migration...
	$(PYTHON) -m alembic downgrade -1
	@echo Rollback completed

migrate-status:
	@echo Current migration status:
	$(PYTHON) -m alembic current
	@echo.
	@echo Migration history:
	$(PYTHON) -m alembic history --verbose

backup-db:
	@echo Creating database backup...
	@$(PYTHON) scripts/backup_database.py

# Add these commands to the DATABASE section after backup-db:

seed:
	@echo Seeding database with comprehensive test data...
	$(PYTHON) scripts/seed_database.py
	@echo Seeding completed successfully

seed-minimal:
	@echo Seeding database with minimal data (admin + 1 vendor)...
	$(PYTHON) scripts/seed_database.py --minimal
	@echo Minimal seeding completed

seed-reset:
	@echo WARNING: This will DELETE ALL existing data!
	$(PYTHON) scripts/seed_database.py --reset
	@echo Database reset and seeded

# Complete database setup (migrate + seed)
db-setup: migrate-up seed
	@echo Database setup complete!
	@echo Run 'make dev' to start development server

db-reset: migrate-down migrate-up seed-reset
	@echo Database completely reset!

# =============================================================================
# TESTING
# =============================================================================

test:
	$(PYTHON) -m pytest tests/ -v

test-unit:
	$(PYTHON) -m pytest tests/ -v -m unit

test-integration:
	$(PYTHON) -m pytest tests/ -v -m integration

test-coverage:
	$(PYTHON) -m pytest tests/ --cov=app --cov=models --cov=utils --cov=middleware --cov-report=html --cov-report=term-missing

test-fast:
	$(PYTHON) -m pytest tests/ -v -m "not slow"

test-slow:
	$(PYTHON) -m pytest tests/ -v -m slow

test-auth:
	$(PYTHON) -m pytest tests/test_auth.py -v

test-products:
	$(PYTHON) -m pytest tests/test_products.py -v

test-inventory:
	$(PYTHON) -m pytest tests/test_inventory.py -v

# =============================================================================
# CODE QUALITY
# =============================================================================

format:
	@echo Running black...
	$(PYTHON) -m black . --exclude venv
	@echo Running isort...
	$(PYTHON) -m isort . --skip venv

lint:
	@echo Running linting...
	$(PYTHON) -m ruff check . --exclude venv
	$(PYTHON) -m mypy . --ignore-missing-imports --exclude venv

# Alternative lint if still using flake8
lint-flake8:
	@echo Running linting...
	$(PYTHON) -m flake8 . --max-line-length=120 --extend-ignore=E203,W503,I201,I100 --exclude=venv,__pycache__,.git
	$(PYTHON) -m mypy . --ignore-missing-imports --exclude venv

# Combined format and lint
check: format lint

# Combined test with coverage and linting
ci: format lint test-coverage

# Quality assurance workflow
qa: format lint test-coverage docs-check
	@echo Quality assurance checks completed!

# =============================================================================
# DOCUMENTATION
# =============================================================================

docs-serve:
	@echo Starting documentation server...
	$(PYTHON) -m mkdocs serve --dev-addr=0.0.0.0:8001

docs-build:
	@echo Building documentation...
	$(PYTHON) -m mkdocs build --clean --strict

docs-deploy:
	@echo Deploying documentation...
	$(PYTHON) -m mkdocs gh-deploy --clean

docs-clean:
	@if exist site rmdir /s /q site
	@echo Documentation build files cleaned!

docs-check:
	@echo Checking documentation for issues...
	$(PYTHON) -m mkdocs build --strict --verbose

# =============================================================================
# DOCKER
# =============================================================================

docker-build:
	docker-compose build

docker-up:
	docker-compose up -d

docker-down:
	docker-compose down

docker-restart: docker-down docker-up

# =============================================================================
# DEPLOYMENT
# =============================================================================

deploy-staging: migrate-up
	docker-compose -f docker-compose.staging.yml up -d

deploy-prod: migrate-up
	docker-compose -f docker-compose.prod.yml up -d

# =============================================================================
# UTILITIES
# =============================================================================

clean:
	@if exist htmlcov rmdir /s /q htmlcov
	@if exist .pytest_cache rmdir /s /q .pytest_cache
	@if exist .coverage del .coverage
	@if exist .mypy_cache rmdir /s /q .mypy_cache
	@for /d /r . %%d in (__pycache__) do @if exist "%%d" rmdir /s /q "%%d"
	@del /s /q *.pyc 2>nul || echo No .pyc files found

verify-setup:
	@echo Running setup verification...
	@$(PYTHON) scripts/verify_setup.py

# Check Python and virtual environment
check-env:
	@echo Checking Python environment...
	@echo Python version:
	@$(PYTHON) --version
	@echo.
	@echo Python location:
	@where $(PYTHON)
	@echo.
	@echo Virtual environment active:
	@$(PYTHON) -c "import sys; print('YES' if hasattr(sys, 'real_prefix') or (hasattr(sys, 'base_prefix') and sys.base_prefix != sys.prefix) else 'NO')"
	@echo.
	@echo Python executable:
	@$(PYTHON) -c "import sys; print(sys.executable)"

# =============================================================================
# HELP
# =============================================================================

help:
	@echo LetzShop API Development Commands
	@echo.
	@echo === SETUP ===
	@echo   install              - Install production dependencies
	@echo   install-test         - Install test dependencies only
	@echo   install-dev          - Install development dependencies
	@echo   install-all          - Install all dependencies
	@echo   setup                - Complete development setup
	@echo.
	@echo === DEVELOPMENT ===
	@echo   dev                  - Start API development server
	@echo   dev-full             - Start API and documentation servers
	@echo.
	@echo === DATABASE ===
	@echo   migrate-create message="msg" - Create new migration
	@echo   migrate-up           - Apply pending migrations
	@echo   migrate-down         - Rollback last migration
	@echo   migrate-status       - Show migration status
	@echo   backup-db            - Backup database
	@echo.
	@echo === TESTING ===
	@echo   test                 - Run all tests
	@echo   test-coverage        - Run tests with coverage
	@echo   test-fast            - Run fast tests only
	@echo.
	@echo === CODE QUALITY ===
	@echo   format               - Format code (black + isort)
	@echo   lint                 - Run linting (ruff + mypy)
	@echo   lint-flake8          - Run linting (flake8 + mypy - alternative)
	@echo   check                - Format + lint
	@echo   ci                   - Full CI pipeline
	@echo   qa                   - Quality assurance (format, lint, test, docs check)
	@echo.
	@echo === DOCUMENTATION ===
	@echo   docs-serve           - Start documentation server
	@echo   docs-build           - Build documentation
	@echo.
	@echo === DOCKER ===
	@echo   docker-build         - Build Docker containers
	@echo   docker-up            - Start Docker containers
	@echo   docker-down          - Stop Docker containers
	@echo   docker-restart       - Restart Docker containers
	@echo.
	@echo === DEPLOYMENT ===
	@echo   deploy-staging       - Deploy to staging environment
	@echo   deploy-prod          - Deploy to production environment
	@echo.
	@echo === UTILITIES ===
	@echo   clean                - Clean build artifacts
	@echo   verify-setup         - Verify project setup
	@echo   check-env            - Check Python and virtual environment
	@echo.
	@echo === DAILY WORKFLOW ===
	@echo   make dev                                # Start development
	@echo   make migrate-create message="feature"  # Create migration
	@echo   make migrate-up                         # Apply migration
	@echo   make test                               # Run tests

help-db:
	@echo === DATABASE COMMANDS ===
	@echo   migrate-create message="description"   - Create auto-generated migration
	@echo   migrate-create-manual message="desc"   - Create empty migration template
	@echo   migrate-up                             - Apply all pending migrations
	@echo   migrate-down                           - Rollback last migration
	@echo   migrate-status                         - Show current status and history
	@echo   backup-db                              - Create database backup
	@echo.
	@echo TYPICAL WORKFLOW:
	@echo   1. Edit your SQLAlchemy models
	@echo   2. make migrate-create message="add_new_feature"
	@echo   3. Review the generated migration file
	@echo   4. make migrate-up