Качество кода

Code Quality

Качественным, называется программный код, соответствующий следующим критериям:

• Правильность

Соответствие нуждам бизнеса, решаемой проблеме. Важно также различать консистентность, то есть логичность/правильность кода и удобство использования которые между собой не связаны. Для удобства использования иногда приходится структурировать код, интерфейсы и данные не так как правильно а так как с этим кодом удобнее взаимодействовать (получать, обрабатывать данные)

• Простота

В том числе не содержащим явного и скрытого дублирования (под скрытым дублированием понимают повторяющую последовательность шагов для внесения изменения в код, например для того чтобы добавить новый end point обработчик нужно модифицировать routes конфигурацию, добавить класс контроллера, добавить класс валидатор, добавить валидатор в коллекцию валидаторов и тп)

• Понятность

Мы пишем код понятный человеку, а не компилятору

• Тестируемость и тестопригодность

Код написан в виде абстракций с понятными интерфейсами, для внутренней логики не сложно написать тест.

• Расширяемость

Архитектура приложения понятна и в код просто добавлять новые функции.

Рекомендуемая литература

• Clean Code: A Handbook of Agile Software Craftsmanship (Robert C. Martin)

  by Robert Martin

• Refactoring: Improving the Design of Existing Code, by Martin Fowler

• Working Effectively with Legacy Code Paperback, by Michael Feathers