📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados em Módulo 10: Paradigmas e Padrões de Projeto. Recomendado revisar antes de começar.

📐 Gateway de Pagamentos com Padrões GoF & SOLID

v1.0 — Factory Method, Strategy, Decorator, Observer e Princípios SOLID

Trilha de Especialização Pedagógica — Projeto 1 de 4

• ➡️ v1 (este): Padrões GoF Criacionais, Estruturais e Comportamentais · SOLID
• v2: Repository Pattern & Unit of Work Enterprise
• v3: Specification Pattern & Chain of Responsibility
• v4: Event Sourcing & CQRS Architecture

🎓 Nível Profissional Simulado: Engenheiro de Software Pleno. Código amador usa dezenas de if/else e switch/case espalhados para decidir regras de negócio. Um engenheiro experiente aplica os Padrões de Projeto GoF, tornando o código extensível, modular e imune a quebras quando novos provedores são adicionados.

🎯 Objetivo & Escopo do Projeto

Construir um Gateway de Pagamentos Corporativo aplicando os padrões Strategy (para alternância de meios de pagamento Pix, Cartão e Boleto), Factory Method (para instanciação desacoplada), Decorator (para injeção transparente de logs de auditoria e métricas) e Observer (para notificações de confirmação de pagamento).

🧑‍💼 Fase 1 — Levantamento de Requisitos

O Briefing do Cliente (Diretor Financeiro)

“Nosso e-commerce aceita apenas Cartão de Crédito com um código cheio de ifs acoplados. Precisamos aceitar Pix e Boleto sem reescrever o checkout, queremos que cada transação registre logs de auditoria automaticamente sem poluir a regra de negócio do pagamento, e precisamos notificar o cliente por e-mail quando a compra for confirmada.”

Requisitos Funcionais (RF) e Não-Funcionais (RNF)

📋 Fase 2 — Backlog & User Stories

🌿 Fase 3 — Engenharia em Equipe (Git Flow & Setup)

# Branch da funcionalidade
git checkout -b feature/US01-gof-payment-gateway

# Executar a suíte de pagamentos
python src/gateway_core.py

🛠️ Fase 4 — Implementação Guiada (src/gateway_core.py)

class PagamentoFactory:
    @staticmethod
    def criar(tipo: str) -> MetodoPagamento:
        if tipo.lower() == "pix":
            return PagamentoComAuditoria(PagamentoPix())
        elif tipo.lower() == "cartao":
            return PagamentoComAuditoria(PagamentoCartao())
        raise ValueError(f"Metodo de pagamento nao suportado: {tipo}")

🚀 Como Executar no Laboratório

1. Abra o terminal na pasta deste projeto

No seu editor/IDE, abra a pasta deste projeto (File > Open Folder) ou navegue via terminal:

cd padroes_01_gateway_pagamentos_gof

2. Execute a aplicação ou testes

# Executar comandos específicos da tecnologia:
python main.py # ou npm run dev / ./gradlew build

[!TIP] Dica para execução a partir da raiz do repositório: Se você abriu o repositório completo no VS Code, basta navegar até a pasta antes de executar: cd catalogo_projetos/padroes_01_gateway_pagamentos_gof`

🧭 Decisões de Arquitetura (ADRs)

• ADR 001: Adoção de Factory Method, Strategy e Decorator para conformidade total com os princípios SOLID.

🧪 Testes de Validação & Asserções

pix = PagamentoFactory.criar("pix")
assert pix.processar(100.0) == True

🏛️ Arquitetura Visual & Engenharia do Sistema

A visualização arquitetural abaixo detalha a separação de responsabilidades e o fluxo de dados implementado na subpasta app-python/:

flowchart TD
    subgraph Entrada["Camada de Entrada & CLI"]
        IN1["Interface de Comando / API"] --> IN2["Parser & Sanitização"]
    end
    subgraph Dominio["Camada de Domínio & Regras"]
        DM1["Modelos de Domínio"] --> DM2["Processamento Algorítmico"]
    end
    subgraph Armazenamento["Persistência & Recursos"]
        ST1["Banco de Dados / Arquivo"] --> ST2["Transações ACID & Logs"]
    end
    subgraph Qualidade["Validação & Qualidade"]
        QA1["Testes Automatizados"] --> QA2["Checkpoints CP-01..05 PASS"]
    end

    Entrada --> Dominio
    Dominio --> Armazenamento
    Armazenamento --> Qualidade

    style Entrada fill:#e3f2fd,stroke:#1976d2,stroke-width:1.5px
    style Dominio fill:#fffde7,stroke:#fbc02d,stroke-width:1.5px
    style Armazenamento fill:#e8f5e9,stroke:#388e3c,stroke-width:1.5px
    style Qualidade fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1.5px

🎯 Engenharia de Requisitos & Modelagem Formal

👤 User Stories (Histórias de Usuário)

⚙️ Requisitos Funcionais (RF)

🛡️ Requisitos Não-Funcionais (RNF)

🔗 Matriz de Rastreabilidade (RTM)

🏁 Checkpoints de Qualidade & Homologação