Clean Code Naming

Рекомендуемые практики

1. Для методов использовать глагол действия (Get, Update, Create, Delete).
2. Для DTO использовать явные суффиксы по роли (Request, Response, Dto).
3. Для bool-значений использовать префиксы Is, Has, Can, Should.
4. Для коллекций использовать множественное число.
5. Для enum использовать значения, понятные без чтения комментариев.

Анти-паттерны

1. obj, data, item, model в бизнес-логике.
2. Разные имена для одного и того же понятия в соседних слоях.
3. Имена с избыточной реализационной детализацией (UserSqlRepositoryServiceImpl).

Примеры

Do

• UpdateUserFullNameCommand
• GetByIdAsync
• isUserActive

Don't

• DoWork
• ProcessData
• tmpUser

Алгоритм принятия решений

1. Определи доменную роль сущности.
2. Сформируй имя по роли, а не по технической реализации.
3. Проверь, что имя однозначно читается в месте использования.
4. Проверь консистентность с соседними модулями.

Проверка перед завершением

1. Имена отражают намерение.
2. Нет неочевидных сокращений.
3. Нет двусмысленных публичных имен.
4. Сохраняется единообразие терминов между слоями.