feat: integrate mock logo for TECH_FLORIPA in certificate generation tests and enhance QR code generation tests

Author: maxsonferovante

tests/conftest.py

@@ -22,7 +22,8 @@ class MockConfig:
         SERVICE_API_KEY_REGISTRATION_API_SOLANA = "test-api-key"
         # comentário: URL de validação mockada para o Tech Floripa usada nos testes
         TECH_FLORIPA_CERTIFICATE_VALIDATE_URL = "https://example.test/certificate-validate/"
-
+        TECH_FLORIPA_LOGO_URL = "https://example.test/logo.png"
+        
     # comentário: expõe tanto a classe quanto a instância, como o módulo real faria
     mock_module.Config = MockConfig
     mock_module.config = MockConfig()

tests/test_certified_builder.py

@@ -49,13 +49,17 @@ def mock_certificate_template():
 def mock_logo():
     return Image.new("RGBA", (150, 150), (255, 255, 255, 0))
 
+@pytest.fixture
+def mock_logo_tech_floripa():
+    return Image.new("RGBA", (100, 100), (255, 255, 255, 255))
+
 @pytest.fixture
 def certified_builder():
     return CertifiedBuilder()
 
-def test_generate_certificate(certified_builder, mock_participant, mock_certificate_template, mock_logo):
+def test_generate_certificate(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
     with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]):
-        certificate = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo)
+        certificate = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa)
         assert isinstance(certificate, Image.Image)
         assert certificate.size == mock_certificate_template.size
         assert certificate.mode == "RGBA"
@@ -78,11 +82,21 @@ def test_create_validation_code_image(certified_builder, mock_participant, mock_
     assert validation_code_image.size == mock_certificate_template.size
     assert validation_code_image.mode == "RGBA"
 
-def test_build_certificates(certified_builder, mock_participant, mock_certificate_template, mock_logo):
+def test_build_certificates(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
     participants = [mock_participant]
 
     # comentário: mock do download de imagens e da resposta do serviço Solana para evitar chamada externa
-    with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]), \
+    # Função que retorna o mock baseado na URL chamada
+    def mock_download_image(url):
+        if url == mock_participant.certificate.background:
+            return mock_certificate_template
+        elif url == mock_participant.certificate.logo:
+            return mock_logo
+        elif url == "https://example.test/logo.png":  # TECH_FLORIPA_LOGO_URL do config mock
+            return mock_logo_tech_floripa
+        raise ValueError(f"URL não mockada: {url}")
+    
+    with patch.object(certified_builder, '_download_image', side_effect=mock_download_image), \
          patch('certified_builder.certified_builder.CertificatesOnSolana.register_certificate_on_solana', return_value={
              # comentário: mock alinhado ao contrato atual do serviço
              "status": "sucesso",
@@ -128,12 +142,12 @@ def _count_non_transparent_pixels(img: Image.Image) -> int:
     return sum(1 for p in alpha.getdata() if p != 0)
 
 
-def test_scan_to_validate_is_centered_and_below_qr(certified_builder, mock_participant, mock_certificate_template, mock_logo):
+def test_scan_to_validate_is_centered_and_below_qr(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
     # Garante url para QR
     mock_participant.authenticity_verification_url = "https://example.com/verify"
 
     with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]):
-        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo)
+        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa)
 
         # Recalcula posição esperada do texto seguindo a mesma lógica do código
         qrcode_size = (150, 150)
@@ -163,11 +177,11 @@ def test_scan_to_validate_is_centered_and_below_qr(certified_builder, mock_parti
         assert _count_non_transparent_pixels(cropped) > 0, "Texto 'Scan to Validate' não encontrado na área esperada"
 
 
-def test_qr_is_placed_at_expected_region(certified_builder, mock_participant, mock_certificate_template, mock_logo):
+def test_qr_is_placed_at_expected_region(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
     mock_participant.authenticity_verification_url = "https://example.com/verify"
 
     with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]):
-        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo)
+        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa)
 
         # QR é esperado em (50,200) com 150x150
         qr_left, qr_top = 50, 200
@@ -180,3 +194,248 @@ def test_qr_is_placed_at_expected_region(certified_builder, mock_participant, mo
         below_region = result.crop((qr_left, qr_bottom, qr_right, min(qr_bottom + 30, result.height)))
         assert _count_non_transparent_pixels(below_region) > 0, "Nenhum conteúdo encontrado abaixo do QR onde o texto deveria estar"
 
+
+def test_name_is_centered_on_certificate(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
+    """Verifica que o nome do participante está centralizado no certificado."""
+    mock_participant.authenticity_verification_url = "https://example.com/verify"
+    
+    with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]):
+        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa)
+        
+        # Verifica que há conteúdo na região central onde o nome deveria estar
+        center_x = result.width // 2
+        center_y = result.height // 2
+        name_region = result.crop((center_x - 200, center_y - 50, center_x + 200, center_y + 50))
+        
+        assert _count_non_transparent_pixels(name_region) > 0, "Nome não encontrado na região central do certificado"
+
+
+def test_validation_code_is_at_bottom_right(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
+    """Verifica que o código de validação está posicionado no canto inferior direito."""
+    mock_participant.authenticity_verification_url = "https://example.com/verify"
+    
+    with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]):
+        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa)
+        
+        # Verifica região inferior direita onde o código de validação deveria estar
+        validation_region = result.crop((result.width - 250, result.height - 80, result.width, result.height))
+        
+        assert _count_non_transparent_pixels(validation_region) > 0, "Código de validação não encontrado no canto inferior direito"
+
+
+def test_logo_is_positioned_at_top_left(certified_builder, mock_participant, mock_certificate_template, mock_logo_tech_floripa):
+    """Verifica que o logo está posicionado no canto superior esquerdo."""
+    mock_participant.authenticity_verification_url = "https://example.com/verify"
+    # Usa um logo visível (não transparente) para o teste
+    visible_logo = Image.new("RGBA", (150, 150), (255, 255, 255, 255))
+    
+    with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, visible_logo]):
+        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, visible_logo, mock_logo_tech_floripa)
+        
+        # Logo é esperado em (50, 50) com tamanho máximo de 150x150
+        logo_region = result.crop((50, 50, 200, 200))
+        
+        assert _count_non_transparent_pixels(logo_region) > 0, "Logo não encontrado na região esperada"
+
+
+def test_large_logo_is_resized(certified_builder, mock_participant, mock_certificate_template, mock_logo_tech_floripa):
+    """Verifica que logos grandes são redimensionados para o tamanho máximo."""
+    mock_participant.authenticity_verification_url = "https://example.com/verify"
+    large_logo = Image.new("RGBA", (300, 300), (255, 255, 255, 255))
+    
+    with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, large_logo]):
+        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, large_logo, mock_logo_tech_floripa)
+        
+        # Verifica que o logo foi redimensionado (não deve ocupar toda a região de 300x300)
+        logo_region = result.crop((50, 50, 200, 200))
+        
+        assert _count_non_transparent_pixels(logo_region) > 0, "Logo redimensionado não encontrado"
+
+
+def test_details_are_split_into_three_lines(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
+    """Verifica que os detalhes do certificado são divididos em 3 linhas."""
+    mock_participant.authenticity_verification_url = "https://example.com/verify"
+    
+    with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]):
+        result = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa)
+        
+        # Verifica região onde os detalhes deveriam estar (abaixo do centro)
+        center_y = result.height // 2
+        details_region = result.crop((0, center_y + 50, result.width, center_y + 150))
+        
+        assert _count_non_transparent_pixels(details_region) > 0, "Detalhes não encontrados na região esperada"
+
+
+def test_build_certificates_with_multiple_participants_same_resources(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
+    """Testa geração de certificados para múltiplos participantes com mesmo background e logo."""
+    second_participant = Participant(
+        first_name="Maria",
+        last_name="Silva",
+        email="maria@example.com",
+        phone="(48) 99999-9999",
+        cpf="111.111.111-11",
+        certificate=mock_participant.certificate,
+        event=mock_participant.event
+    )
+    
+    participants = [mock_participant, second_participant]
+    
+    def mock_download_image(url):
+        if url == mock_participant.certificate.background:
+            return mock_certificate_template
+        elif url == mock_participant.certificate.logo:
+            return mock_logo
+        elif url == "https://example.test/logo.png":
+            return mock_logo_tech_floripa
+        raise ValueError(f"URL não mockada: {url}")
+    
+    with patch.object(certified_builder, '_download_image', side_effect=mock_download_image), \
+         patch('certified_builder.certified_builder.CertificatesOnSolana.register_certificate_on_solana', return_value={
+             "blockchain": {
+                 "explorer_url": "https://explorer.solana.com/tx/test123?cluster=devnet"
+             }
+         }), \
+         patch.object(certified_builder, 'save_certificate') as mock_save:
+        
+        results = certified_builder.build_certificates(participants)
+        
+        assert len(results) == 2
+        assert all(r["success"] for r in results)
+        assert mock_save.call_count == 2
+
+
+def test_build_certificates_with_different_backgrounds(certified_builder, mock_participant, mock_logo, mock_logo_tech_floripa):
+    """Testa geração de certificados para participantes com backgrounds diferentes."""
+    different_background = "https://example.com/different-background.png"
+    different_template = Image.new("RGBA", (1920, 1080), (200, 200, 200, 255))
+    
+    second_certificate = Certificate(
+        details=mock_participant.certificate.details,
+        logo=mock_participant.certificate.logo,
+        background=different_background
+    )
+    
+    second_participant = Participant(
+        first_name="João",
+        last_name="Santos",
+        email="joao@example.com",
+        phone="(48) 88888-8888",
+        cpf="222.222.222-22",
+        certificate=second_certificate,
+        event=mock_participant.event
+    )
+    
+    participants = [mock_participant, second_participant]
+    
+    def mock_download_image(url):
+        if url == mock_participant.certificate.background:
+            return Image.new("RGBA", (1920, 1080), (255, 255, 255, 0))
+        elif url == different_background:
+            return different_template
+        elif url == mock_participant.certificate.logo:
+            return mock_logo
+        elif url == "https://example.test/logo.png":
+            return mock_logo_tech_floripa
+        raise ValueError(f"URL não mockada: {url}")
+    
+    with patch.object(certified_builder, '_download_image', side_effect=mock_download_image), \
+         patch('certified_builder.certified_builder.CertificatesOnSolana.register_certificate_on_solana', return_value={
+             "blockchain": {
+                 "explorer_url": "https://explorer.solana.com/tx/test123?cluster=devnet"
+             }
+         }), \
+         patch.object(certified_builder, 'save_certificate') as mock_save:
+        
+        results = certified_builder.build_certificates(participants)
+        
+        assert len(results) == 2
+        assert all(r["success"] for r in results)
+
+
+def test_build_certificates_handles_solana_registration_error(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
+    """Testa tratamento de erro quando o registro na Solana falha."""
+    participants = [mock_participant]
+    
+    def mock_download_image(url):
+        if url == mock_participant.certificate.background:
+            return mock_certificate_template
+        elif url == mock_participant.certificate.logo:
+            return mock_logo
+        elif url == "https://example.test/logo.png":
+            return mock_logo_tech_floripa
+        raise ValueError(f"URL não mockada: {url}")
+    
+    with patch.object(certified_builder, '_download_image', side_effect=mock_download_image), \
+         patch('certified_builder.certified_builder.CertificatesOnSolana.register_certificate_on_solana', return_value={
+             "blockchain": {}  # Sem explorer_url - simula erro
+         }):
+        
+        results = certified_builder.build_certificates(participants)
+        
+        assert len(results) == 1
+        assert results[0]["success"] == False
+        assert "Failed to get authenticity verification URL" in results[0]["error"]
+
+
+def test_save_certificate_saves_to_temp_directory(certified_builder, mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
+    """Testa que o certificado é salvo no diretório temporário."""
+    mock_participant.authenticity_verification_url = "https://example.com/verify"
+    
+    with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]):
+        certificate = certified_builder.generate_certificate(mock_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa)
+        file_path = certified_builder.save_certificate(certificate, mock_participant)
+        
+        assert file_path.startswith("/tmp/certificates/")
+        assert file_path.endswith(".png")
+        
+        import os
+        assert os.path.exists(file_path), "Arquivo do certificado não foi criado"
+
+
+def test_generate_certificate_with_long_name(certified_builder, mock_certificate, mock_certificate_template, mock_logo, mock_logo_tech_floripa):
+    """Testa geração de certificado com nome muito longo."""
+    mock_event = Event(
+        order_id=1,
+        product_id=1,
+        product_name="Evento Teste",
+        date=datetime.now(),
+        time_checkin=datetime.now(),
+        checkin_latitude=0.0,
+        checkin_longitude=0.0
+    )
+    
+    long_name_participant = Participant(
+        first_name="João Pedro",
+        last_name="da Silva Santos Oliveira",
+        email="joao@example.com",
+        phone="(48) 99999-9999",
+        cpf="123.456.789-00",
+        certificate=mock_certificate,
+        event=mock_event
+    )
+    long_name_participant.authenticity_verification_url = "https://example.com/verify"
+    
+    with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]):
+        result = certified_builder.generate_certificate(long_name_participant, mock_certificate_template, mock_logo, mock_logo_tech_floripa)
+        
+        assert isinstance(result, Image.Image)
+        assert result.size == mock_certificate_template.size
+
+
+def test_ensure_valid_rgba_converts_rgb_image(certified_builder):
+    """Testa que _ensure_valid_rgba converte imagens RGB para RGBA."""
+    rgb_image = Image.new("RGB", (100, 100), (255, 0, 0))
+    rgba_image = certified_builder._ensure_valid_rgba(rgb_image)
+    
+    assert rgba_image.mode == "RGBA"
+    assert rgba_image.size == rgb_image.size
+
+
+def test_ensure_valid_rgba_preserves_rgba_image(certified_builder):
+    """Testa que _ensure_valid_rgba preserva imagens já em RGBA."""
+    rgba_image = Image.new("RGBA", (100, 100), (255, 0, 0, 128))
+    result = certified_builder._ensure_valid_rgba(rgba_image)
+    
+    assert result.mode == "RGBA"
+    assert result.size == rgba_image.size
+

tests/test_make_qrcode.py

@@ -4,16 +4,21 @@
 from certified_builder.make_qrcode import MakeQRCode
 
 
+@pytest.fixture
+def mock_logo_tech_floripa():
+    return Image.new("RGBA", (100, 100), (255, 255, 255, 255))
+
+
 def _count_alpha(img: Image.Image):
     a = img.split()[-1]
     zeros = sum(1 for p in a.getdata() if p == 0)
     nonzeros = sum(1 for p in a.getdata() if p != 0)
     return zeros, nonzeros
 
 
-def test_generate_qr_code_returns_image_png_rgba():
+def test_generate_qr_code_returns_image_png_rgba(mock_logo_tech_floripa):
     data = "https://example.com/verify/ABC123"
-    byte_io = MakeQRCode.generate_qr_code(data)
+    byte_io = MakeQRCode.generate_qr_code(data, mock_logo_tech_floripa)
 
     assert isinstance(byte_io, BytesIO)
 
@@ -22,9 +27,9 @@ def test_generate_qr_code_returns_image_png_rgba():
     assert img.size[0] > 0 and img.size[1] > 0
 
 
-def test_qr_has_transparent_background_and_visible_foreground():
+def test_qr_has_transparent_background_and_visible_foreground(mock_logo_tech_floripa):
     data = "hello world"
-    byte_io = MakeQRCode.generate_qr_code(data)
+    byte_io = MakeQRCode.generate_qr_code(data, mock_logo_tech_floripa)
     img = Image.open(byte_io).convert("RGBA")
 
     zeros, nonzeros = _count_alpha(img)