Sobre Design de Software

O que é complexidade?

O que é complexidade?

Design de Software Arquitetura de Software Complexidade
Post originally published on vepo.substack.com.

Sobre Design de Software

O que é complexidade?

Motivador

Comecei a ler o livro A Philosophy of Software Design, o livro surge das notas de aula de um curso de Software Design na Stanforn University CS-190.

Esse é um curso que eu gostaria de fazer, tendo cursado uma modalidade praticamente industrial de Engenharia de Computação, muito do meu foco na graduação foi desenvolvimento C e Assembler. Ao entrar no mercado tive que aprender a abstrair, e abstração é tudo no mundo de software.

Essas notas serão livres, não se propões a serem um resumo do livro.

Software e Diagramas

Você pode não ter desenhado nenhum diagram do seu software ou do seu sistema como um todo. Mas esse diagrama existe, ele é virtual, é baseado no conjunto das interações de cada peça do seu sistema, de cada classe do seu software. Você vai começar a racionalizar ele quando começar a colocar “no papel” esses diagramas.

Na Engenharia de Software existem várias ferramentas e linguagens de apresentação que você pode usar, mas eu recomendo uma bem mais simples pra começar: README.md.

Notas em um quadro

Quando for começar a escrever, pense em quem vai ler. O que é preciso saber? Coloque suas ideias em uma sessão chamada Racional. Depois coloque uma sessão (ou um novo documento) com todas as informações necessárias para execução. Por fim vá descrevendo cada conceito que seu software tem, um glossário com os termos usados.

Eric Evans em Domain-Driven Design afirma que cada projeto tem sua Linguagem Onipresente, está é a definição dos termos que em comum entre o código e o negócio. É muito importante esses termos estarem bem definidos.

Se possível, coloque as decisões arquiteturais também. Crie um diretório de documentação e faça a lista com tudo que foi cogitado e escolhido. Porque não usamos tal biblioteca?

A grande limitação ao se escrever software, é entender o sistemas que estamos criando.

Software é complexo, e podemos reduzir essa complexidade documentando as ideias e conceitos que estamos usando. Um simples desenho vai ajudar muito que pode te ajudar a desenvolver.

De onde vem a complexidade?

A complexidade vem da dificuldade de compreensão. Qualquer dificuldade de compreensão no desenvolviment/manutenção do software causará dificuldade.

Segundo John Ousterhout, os sintomas da complexidade são:

Um dos mais importantes objetivos de um bom Desgin é para um sistema ser óbvio.

A complexidade vem principalmente de dependências e obscuridade. Dependência significa quando uma parte depende de ourta, quanto menos dependências entre as partes, menos complexidade seu software terá. E obscuridade significa aquilo que não é obvio, seu software tem comportamentos mágicos ou paranormais? Se for escolher entre fazer algo que pareça mágica, faça uma boa escolha e documente o processo.

Por fim, a complexidade é incremental. Nenhum software é descartável, todos podem ser salvos. Se você encontra muita dificuldade, uma pergunta que se tem que fazer: quanto custaria pra reescrever tudo? Nunca parta para opção de reescrever sem antes ter uma estatística e provavelmente será a opção mais cara.

Caso não queira reescrever, um dica é o livro Trabalho Eficaz com Código Legado. Nele o autor vai trabalhar várias abordagens de como trabalhar com seu código. Uma que já validei em uma empresa que trabalhei foi fazer uma fachada em alguns modulos. Criar uma interface e ir reescrevendo os modulos aos poucos. Outra é você ir fazendo mudanças pequenas, melhorando o design.

Conclusão

Todo design de software evolui. Se hoje pode estar bom, em poucos meses pode estar ruim. Vale pensar em como as funcionalidades devem ser colocadas.

Sobre Design de Software

O que é complexidade?
Originally published March 04, 2021