*Автор: [<https://t.me/anna_mozer_pro_it>](<https://t.me/anna_mozer_pro_it>)*

Важно соблюдать консистентность названий в API (да и вообще везде, в базе данных, в коде).

Консистентность (или согласованность) означает использование одинаковых, похожих и понятных обозначений для свойств, методов и других элементов системы. Это помогает уменьшить когнитивную нагрузку:

• при проектировании: нет необходимости каждый раз изобретать названия;
• при чтении: стандартные свойства несут одинаковое значение в разных методах;
• при реализации: меньше возможность опечатки, т.к. IDE (среда разработки) поможет выбирать из уже существующих переменных.

Быстрый чек-лист для проверки:

• [ ] Свойства написаны в едином стиле
• [ ] Используются стандартные названия и стандартные правила наименования
• [ ] Названия согласованы между несколькими слоями приложения
• [ ] Отсутствует полиморфизм в структуре

А теперь поподробнее:

• [ ] Свойства написаны в едином стиле

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

• camelCase, например "createdAt": 1320296464 ;
• snake_case, например "created_at": "Thu Nov 03 05:19;38 +0000 2011" ;
• PascalCase, например "DateTime": "2011-10-29T09:35:00Z" ;
• kebab-case, например "date-time": "2011-10-29T09:35:00Z" ;
• UPPER_CASE_SNAKE_CASE, например "UPDATE_TIME": "2011-10-29T09:35:00Z" ;
• и другие вариации.

<aside> 💡 Часто на разных слоях системы придерживаются разных стилей, но в пределах одного слоя стоит использовать один (с некоторыми оговорками) стиль.

</aside>

С разработчиками из моей команды у нас такая договоренность:

• В БД мы используем snake_case.