Как сложность убивает проекты

О чем
Почему нужно бороться со сложностью
Откуда берется
Кто и как может с ней бороться
Сложность – это усилия, потраченные коллективом на создание определенного количества материала

Управление сложностью каждый день
Команда должна понимать и дописывать код (хотя бы в текущем проекте)
Сложность, остается в проекте надолго
Сложность «заразна»
Чтобы код понимал аналитик, PO, тестировщик

«Протекание» и смешение уровней абстракции
Неправильное именование
Слабая связанность, сильная связность
Отсутствие unit-тестов
Не применяются SOLID, YAGNI …
…
Откуда появляется сложность

Сложность предметной области
Что мешает развитию системы, в которой в общем-то все неплохо
Сложность, внесенная разработчиком
Сложность, внесенная умелым разработчиком
Сложный язык, Framework, сложные задачи
Сложно поднимать окружение

Желание решить задачу выше своих компетенций
Недостаточное понимание задачи
Чаще встречается у молодых разработчиков
Оверинжиниринг

Желание использовать модный фрэймворк/подход
Желание развить компетенции
Чаще свойственно разработчикам среднего уровня
Желание написать «классно»

Гибкий и качественный код
Продуманные точки расширения
Сложные алгоритмы
Гений

CodeReview для всех
Отдельный пункт CodeReview – «проверить понятность»,
Управление творческой энергией разработчика

Практики из SCRUM
Не давать задачу «целиком»
Force collective code ownership
Коммуникации

DI/IoC
AOP
DDD и Enterprise-паттерны
Асинхронность/многопоточность
Обобщенные классы и алгоритмы
Использование готовых компонентов
Функциональный стиль
…
Как повысить качество и сложность кода

IL Code
Нативный код
.NET Sources
Nuget lib sources
Common Code
Module common code
Business logic
Работа на глубине
Common business logic

Enterprise
Locator
Layer
Service
Repository
Broker
ActiveRecord
Tier
Bus
Interceptor
ServiceWrapper
Adapter
Microservices

Уровень классов

Уровень методов

Что делать?
Написать как обычно
«А не рано ли принимается решение»

#1
#2

Ограничение набора инструментов
Знать возможности используемого фрэймворка
Предпочитать встроенные инструменты
Бюрократия при добавлении новых библиотек – это не всегда плохо

Непреодолимая сложность
Требования к производительности
Сложность предметной области
Компромиссы и ограничения фрэймворка, библиотек и бизнес-требований

#1 Просто код

#1 Контекст

#1 Документация и комментарии

#2 Просто код

#2 Комментарии

Документация, комментарии
Описание сложного алгоритма (возможно со ссылками)
«Почему так»
Контекст

Валидация графа
Алгоритм
Поиск «треугольников»
Упрощение графа с использованием шагов:
Убрать «петли»
Сократить пути, относящиеся к одной параллельности
Убрать «тупики»
Упростить пути, сходящиеся в одной параллельности
…. еще сколько-то шагов

Изоляция/Инкапсуляция
Сложность не отражается на публичных интерфейсах
От сложности ничего не зависит
Сложность сконцентрирована в одном месте