Cleannode

educationalnodejscleancode
GitHub|Out 2023 - Nov 2023

No segundo semestre de 2023, tive a oportunidade de ministrar uma oficina na UPF (Universidade de Passo Fundo) durante o evento OpenTI II. O tema escolhido foi algo que estava estudando no dia a dia: boas práticas de Código Limpo com NodeJS.

A proposta da oficina era simples, mas ambiciosa: em um único encontro, mostrar a importância do Código Limpo no desenvolvimento de software e, na prática, construir exemplos de código aplicando esses conceitos. A ideia era que os participantes saíssem não apenas com trechos funcionais, mas com uma mentalidade diferente sobre como escrever software.

Estrutura da Oficina

A oficina foi dividida em três módulos progressivos:

  • Introdução — contextualização sobre o que é Código Limpo e por que ele importa;
  • Boas Práticas — exploração de princípios e convenções que tornam o código mais legível, manutenível e escalável;
  • Aplicação — desenvolvimento prático de exemplos de código com TypeScript e NodeJS, aplicando todos os conceitos discutidos.

O foco não estava em frameworks ou ferramentas específicas, mas nos fundamentos que transcendem qualquer tecnologia: nomes significativos, funções pequenas, responsabilidade única e código que se explica por si mesmo.

Tecnologias Utilizadas

Para a parte prática, utilizei:

  • Node.js: ambiente de execução JavaScript no servidor;
  • TypeScript: linguagem principal da oficina, utilizada para agregar tipagem estática e melhorar a qualidade do código.

A escolha de TypeScript foi deliberada — queria mostrar que Código Limpo não é sobre a linguagem, mas sobre como você a utiliza. TypeScript, com seu sistema de tipos, oferece uma camada extra de clareza que reforça os princípios de Clean Code.

Sobre o Evento

A oficina foi realizada no âmbito do OpenTI II, evento organizado na UPF. Mais detalhes sobre o evento podem ser consultados na página do Sympla.

O repositório com todo o material e código da oficina está disponível no GitHub.