Справочник тем чистого кода

НЕ ОБЯЗАТЕЛЬНО

Разработчику Архитектору

Теория данных (раздел 3)

Структуры в коде — Структуры данных; persistence — ORM.

Страница для быстрого поиска: вы видите симптом в коде — открываете тему в энциклопедии. Теория MAPPER; каталог приёмов Фаулера — Методы рефакторинга.

---

Маршрут по разделу 7.10

Шаг	Статья	Темы
1	Культура написания	Имена, стиль, комментарии, стандарты
2	Цикломатическая сложность	Ветвления, длина методов
3	MAPPER	Модель и предметная область
4	Модель и примитивы	Анемичность, value objects
5	Изменяемость	const, побочные эффекты
5a	Декларативный код	"Что" и "как", async
6	Условия и null	Fail fast, if, Optional
7	Связанность	Singleton, god object
8	YAGNI и долг	Объём кода, техдолг
9	Тесты	Качество assert
10	Исключения	try/catch
11	Итоги, Чек-лист	Закрепление

---

Темы и статьи

Тема	Статья	Смежные материалы
Запахи, рефакторинг	Методы рефакторинга программного кода, Культура написания и поддержки кода	Легаси
MAPPER, биекция	MAPPER — модель кода и предметная область	DDD 114
Анемичные модели, DTO	Анемичные модели и примитивная одержимость	ООП
Примитивы, value objects	Анемичные модели и примитивная одержимость, Примитивы, value objects и маленькие типы	Фаулер: Replace Data Value with Object
Изменяемость	Изменяемость, побочные эффекты и неизменяемые данные	Параллелизм
Декларативность	Декларативный код — что и как	Async
Имена, стандарты, комментарии	Культура написания и поддержки кода	614 однострочники
Сложность, DRY, feature flags	Цикломатическая сложность и читаемость кода, YAGNI, быстрый провал и техдолг в коде	White-box
Fail fast, if, null	Условия, null и явные контракты	Методы рефакторинга программного кода
Связанность, глобалы, иерархии	Связанность, глобалы и запахи модульности	7-12/2
YAGNI, оптимизация, техдолг	YAGNI, быстрый провал и техдолг в коде	4-06/1
Тестовый код	Тесты как часть культуры кода	7-05
Исключения	Исключения и обработка ошибок в читаемом коде	8-03
Безопасность ввода	8-03	—

---

Симптом → куда идти

Вы видите в коде	Энциклопедия
string для email, денег, дат	Анемичные модели и примитивная одержимость, Примитивы, value objects и маленькие типы
Сервис на 500 строк, сущность пустая	Анемичные модели и примитивная одержимость
if по типу / коду статуса	Условия, null и явные контракты
?. и null повсюду	Условия, null и явные контракты
Utils.*, static mutable state	Связанность, глобалы и запахи модульности
Один баг — правки в 8 файлах	Связанность, глобалы и запахи модульности, 7-12/2
Закомментированный код	Культура написания и поддержки кода, YAGNI, быстрый провал и техдолг в коде
assertTrue(x)	Тесты как часть культуры кода
Пустой catch	Исключения и обработка ошибок в читаемом коде
Фича + рефакторинг в одном PR	YAGNI, быстрый провал и техдолг в коде, 7-11/3
Пирамида .then / callback	Декларативный код — что и как
Где правило X?	Utils / Manager

---

Фаулер и практики раздела

	Каталог Фаулера	Статьи 7.10
Фокус	Именованные приёмы рефакторинга	Запахи, модель домена, процесс ревью
В энциклопедии	Методы рефакторинга программного кода	этот раздел

На ревью: запах из Методы рефакторинга программного кода → приём Фаулера → проверка по MAPPER.

---