FubanGo 🚫✨

fubango

substantivo masculino [informal, gíria]
feminino: fubanga

1. Pessoa e/ou coisa considerada desprovida de graça, desajeitada ou de aparência descuidada.

   Ser humano de estética duvidosa, dono de um visual que parece ter sido montado às pressas durante um apagão.

   “O cara era todo fubango, mas tinha um bom coração.”

   “O bicho apareceu todo fubango na festa, com a camisa florida laranja e papete do Gustavo Kuerten azul.”

2. Indivíduo tido como cafona ou de gosto duvidoso no modo de se vestir ou se comportar.

   Pessoa com gosto peculiar, que acredita piamente que brilho combina com oncinha e perfume forte é sinal de respeito.

   “Aquele terno amarelo ficou muito fubango.”

   “A fubanga chegou iluminando o bar inteiro com aquele salto de acrílico.”

Etimologia: origem incerta; possivelmente criação popular de tom zombeteiro, associada à sonoridade expressiva. Talvez inventada num boteco entre um gole e outro, quando alguém precisava de uma palavra pra descrever o indescritível.

Sinônimos: brega, cafona, feioso, desengonçado, bagaceiro (pop.).

Antônimos: estiloso, elegante, bonito.

FubanGo é um repositório educacional que ensina Golang através de anti-padrões e exemplos negativos.

Propósito

Este projeto tem como objetivo ensinar Golang de uma maneira única: mostrando primeiro como não fazer as coisas. Para cada conceito, apresentamos:

1. Um problema a ser resolvido;
2. Uma implementação propositalmente ruim;
3. Análise detalhada de por que a implementação é problemática;
4. A forma correta de implementação;
5. Comparação entre as duas abordagens.

Estrutura do Projeto

/exemplos
    /01-basicos
        /variaveis
        /estruturas-de-controle
        /funcoes
    /02-intermediario
        /error-handling
        /concorrencia
        /interfaces
    /03-avancado
        /goroutines
        /channels
        /context
    /04-casos-reais
        /api-design
        /database
        /testes

Cada diretório contém:

• ruim.go - Implementação propositalmente ruim
• analise.md - Análise detalhada dos problemas
• bom.go - Implementação seguindo as melhores práticas
• benchmark_test.go - Testes de performance (quando aplicável)

Como Usar

1. Leia o problema proposto
2. Analise o código ruim em ruim.go
3. Leia a análise detalhada em analise.md
4. Compare com a solução correta em bom.go
5. Execute os benchmarks para ver a diferença de performance

Índice de Anti-Padrões Documentados

📁 01-Básicos

Variáveis

1. Nomes de Variáveis Não Descritivos - ruim.go:7
2. Não Aproveitando Inferência de Tipo - ruim.go:11
3. Declarações Redundantes - ruim.go:17
4. Variáveis Não Utilizadas - ruim.go:22
5. Escopo Global Desnecessário - ruim.go:26
6. Conversões Desnecessárias - ruim.go:30
7. Shadowing de Variáveis - ruim.go:35
8. Valores Mágicos - ruim.go:42
9. Falta de Agrupamento Lógico - ruim.go:47

Estruturas de Controle

1. If's Aninhados Excessivamente - ruim.go:7
2. Switch Mal Estruturado - ruim.go:19
3. For com Continue/Break Desnecessários - ruim.go:33
4. Loop Infinito com Break - ruim.go:47
5. Range com Índice Não Utilizado - ruim.go:61
6. Condições Complexas - ruim.go:67

Funções

1. Muitos Parâmetros e Retornos - ruim.go:9
2. Uso de Variáveis Globais - ruim.go:7
3. Código Repetitivo - ruim.go:23
4. Função que Faz Muitas Coisas - ruim.go:34
5. Recursão Mal Implementada - ruim.go:53
6. Tratamento de Erros Ignorado - ruim.go:60
7. Função Anônima Complexa - ruim.go:66

📁 02-Intermediário

Error Handling

1. Ignorar Erros - ruim.go:10
2. Uso Inadequado de Panic - ruim.go:18
3. Erros Genéricos - ruim.go:25
4. Perda de Contexto - ruim.go:34
5. Mistura de Erros e Logs - ruim.go:43
6. Falta de Agrupamento de Erros - ruim.go:51
7. Recover Indiscriminado - ruim.go:64

Concorrência

1. Race Conditions - ruim.go:9
2. Deadlocks - ruim.go:21
3. Goroutine Leaks - ruim.go:44
4. Uso Incorreto de Canais - ruim.go:53
5. Compartilhamento sem Sincronização - ruim.go:63
6. Select Mal Implementado - ruim.go:75
7. WaitGroup Mal Usado - ruim.go:91
8. Mutex por Valor - ruim.go:104

Interfaces

1. Interface Grande e Não Coesa - ruim.go:7
2. Exposição de Detalhes de Implementação - ruim.go:16
3. Dependência de Tipos Concretos - ruim.go:24
4. Violação do ISP - ruim.go:33
5. Uso Excessivo de interface{} - ruim.go:48
6. Erro Personalizado Incorreto - ruim.go:54
7. Container Genérico Ruim - ruim.go:65
8. Embedding Excessivo - ruim.go:75

📁 03-Avançado

Goroutines

1. Goroutines Sem Controle de Término - ruim.go:11
2. Compartilhamento de Variáveis da Closure - ruim.go:21
3. Número Excessivo de Goroutines - ruim.go:32
4. Comunicação Através de Variáveis Compartilhadas - ruim.go:41
5. Vazamento de Goroutines em Loops - ruim.go:58
6. Panic em Goroutine Sem Recuperação - ruim.go:69
7. CPU-Bound com Muitas Goroutines - ruim.go:82
8. Sincronização Incorreta com WaitGroup - ruim.go:96
9. Deadlock com Canais - ruim.go:110
10. Ordem de Execução Não Garantida - ruim.go:120
11. Timeout Mal Implementado - ruim.go:132
12. Recurso Compartilhado Sem Proteção - ruim.go:146

Channels

1. Canal Sem Buffer Quando Necessário - ruim.go:9
2. Fechamento Múltiplo - ruim.go:21
3. Envio para Canal Fechado - ruim.go:35
4. Select Bloqueante - ruim.go:48
5. Canal Compartilhado - ruim.go:58
6. Direção Não Especificada - ruim.go:72
7. Loop Infinito - ruim.go:78
8. Range Sem Fechamento - ruim.go:90

Context

1. Uso de Timer Sem Cancelamento - ruim.go:9
2. Operação Bloqueante Sem Context - ruim.go:19
3. Ignorar Função Cancel de Context - ruim.go:27
4. Context Como Interface Genérica - ruim.go:36
5. Passar Context por Cópia Incorreta - ruim.go:42

📁 04-Casos Reais

API Design

1. Side-Effects em Endpoints GET - ruim.go:11
2. Vazamento de Dados Sensíveis - ruim.go:20
3. Falta de Autenticação e Autorização - ruim.go:43
4. Mistura de Responsabilidades - ruim.go:51
5. Falta de Versionamento - ruim.go:72
6. Ausência de Contratos Claros - ruim.go:79
7. Falta de Tratamento de Erros Consistente - ruim.go:85

Database

1. Abrir e Fechar Conexão Por Requisição - ruim.go:11
2. SQL Injection por Concatenação de Strings - ruim.go:21
3. Ignorar Erros de Operações de Banco - ruim.go:31
4. Transação Sem Rollback em Caso de Erro - ruim.go:47
5. Falta de Context com Timeout - ruim.go:64
6. Não Usar Prepared Statements - ruim.go:73
7. Ausência de Migrations e Versionamento de Schema - ruim.go:80

Testes

1. Testes Dependentes de Ordem e Estado Global - ruim.go:11
2. Testes Lentos Sem Mocks - ruim.go:25
3. Uso de Sleep em Testes - ruim.go:43
4. Falta de Assertions e Validações - ruim.go:59
5. [Testes Não Isolados (Sem