Loop de Verificação do Django

Execute antes de Pull Requests, após grandes mudanças e antes do deploy para garantir a qualidade e segurança da aplicação Django.

Quando Ativar

• Antes de abrir um pull request para um projeto Django
• Após grandes mudanças em modelos, atualizações de migrações ou upgrades de dependências
• Verificação pré-deploy para staging ou produção
• Execução do pipeline completo: ambiente → lint → teste → segurança → prontidão para deploy
• Validação da segurança das migrações e cobertura de testes

Fase 1: Verificação do Ambiente

# Verify Python version
python --version  # Should match project requirements

# Check virtual environment
which python
pip list --outdated

# Verify environment variables
python -c "import os; import environ; print('DJANGO_SECRET_KEY set' if os.environ.get('DJANGO_SECRET_KEY') else 'MISSING: DJANGO_SECRET_KEY')"

Se o ambiente estiver mal configurado, pare e corrija.

Fase 2: Qualidade e Formatação do Código

# Type checking
mypy . --config-file pyproject.toml

# Linting with ruff
ruff check . --fix

# Formatting with black
black . --check
black .  # Auto-fix

# Import sorting
isort . --check-only
isort .  # Auto-fix

# Django-specific checks
python manage.py check --deploy

Problemas comuns:

• Falta de type hints em funções públicas
• Violações de formatação PEP 8
• Imports não ordenados
• Configurações de debug deixadas na configuração de produção

Fase 3: Migrações

# Check for unapplied migrations
python manage.py showmigrations

# Create missing migrations
python manage.py makemigrations --check

# Dry-run migration application
python manage.py migrate --plan

# Apply migrations (test environment)
python manage.py migrate

# Check for migration conflicts
python manage.py makemigrations --merge  # Only if conflicts exist

Relatório:

• Número de migrações pendentes
• Quaisquer conflitos de migração
• Mudanças de modelo sem migrações

Fase 4: Testes + Cobertura

# Run all tests with pytest
pytest --cov=apps --cov-report=html --cov-report=term-missing --reuse-db

# Run specific app tests
pytest apps/users/tests/

# Run with markers
pytest -m "not slow"  # Skip slow tests
pytest -m integration  # Only integration tests

# Coverage report
open htmlcov/index.html

Relatório:

• Total de testes: X passaram, Y falharam, Z foram pulados
• Cobertura geral: XX%
• Detalhamento da cobertura por app

Metas de cobertura:

Fase 5: Verificação de Segurança

# Dependency vulnerabilities
pip-audit
safety check --full-report

# Django security checks
python manage.py check --deploy

# Bandit security linter
bandit -r . -f json -o bandit-report.json

# Secret scanning (if gitleaks is installed)
gitleaks detect --source . --verbose

# Environment variable check
python -c "from django.core.exceptions import ImproperlyConfigured; from django.conf import settings; settings.DEBUG"

Relatório:

• Dependências vulneráveis encontradas
• Problemas de configuração de segurança
• Segredos hardcoded detectados
• Status do modo DEBUG (deve ser False em produção)

Fase 6: Comandos de Gerenciamento do Django

# Check for model issues
python manage.py check

# Collect static files
python manage.py collectstatic --noinput --clear

# Create superuser (if needed for tests)
echo "from apps.users.models import User; User.objects.create_superuser('admin@example.com', 'admin')" | python manage.py shell

# Database integrity
python manage.py check --database default

# Cache verification (if using Redis)
python -c "from django.core.cache import cache; cache.set('test', 'value', 10); print(cache.get('test'))"

Fase 7: Verificações de Performance

# Django Debug Toolbar output (check for N+1 queries)
# Run in dev mode with DEBUG=True and access a page
# Look for duplicate queries in SQL panel

# Query count analysis
django-admin debugsqlshell  # If django-debug-sqlshell installed

# Check for missing indexes
python manage.py shell << EOF
from django.db import connection
with connection.cursor() as cursor:
    cursor.execute("SELECT table_name, index_name FROM information_schema.statistics WHERE table_schema = 'public'")
    print(cursor.fetchall())
EOF

Relatório:

• Número de queries por página (deve ser < 50 para páginas típicas)
• Índices de banco de dados ausentes
• Queries duplicadas detectadas

Fase 8: Assets Estáticos

# Verifica dependências npm (se estiver usando npm)
npm audit
npm audit fix

# Constrói arquivos estáticos (se estiver usando webpack/vite)
npm run build


…