Переходим от Feature-based разработки к Domain Driven Design

SkyEng
Skyeng — это онлайн-школа английского языка нового поколения.
В школе работают профессионалы, помогающие жителям современных мегаполисов выучить английский язык в условиях недостатка времени.

Маркетинг
Ма́рке́тинг (от англ. marketing «рыночная деятельность») — организационная функция и совокупность процессов создания, продвижения и предоставления продукта или услуги покупателям и управление взаимоотношениями с ними с выгодой для организации.

Маркетинг
Тратить меньше (на продвижение и предоставление)
Получать больше (увеличение аудитории, создание новых продуктов)
Деньги!

Что требуется от разработки
Качественно
Быстро
Дешево

Пример

Задачка
Надо сделать виджет
Дизайн есть!
Пользователь оставляет заявку
В календаре выбирает дату и время вводного урока

Вводный урок
Что это?

Задачка
Надо сделать виджет
Дизайн есть!
Пользователь оставляет заявку
В календаре выбирает дату и время вводного урока

Как будем делать тех. ревью?
От базы/интеграций
От api фронтенда
От проблемы бизнеса

И от базы/интеграций и от api
Сервис букинга — получить, выбрать, отменить
Фронтовое api — получить, выбрать, отменить
База — таблица свзяка education_service_id, booking_slot_id
Что там дальше, подумаем потом ;)
Что думает по этому поводу бизнес?

Чего хочет бизнес от разработки.
Качественно — не терять сценарии и лучше понимать бизнес проблемы
Быстро — быстро описывать сценарии в коде в отрыве от конкретных технологий (технологии не важны)
Дешево — возможность проверять сценарии как можно раньше (оно вообще работает? может и разрабатывать не надо?)

Что дальше?
Опишем сервис
Пробуем удовлетворить все 3 потребности
Посмотрим со стороны гексагональной архитектуры

«Allow an application to equally be driven by users, programs, automated test or batch scripts, and to be developed and tested in isolation from its eventual run-time devices and databases.».
— Alistair Cockburn
Позволяет взаимодействовать с приложением как пользователю, так и программам, автоматическим тестам, скриптам пакетной обработки. Также позволяет разрабатывать и тестировать приложение без каких-либо дополнительных устройств или баз данных.

Hexagonal architecture / Ports and adapters
Пользователь
Программы
Тесты
Скрипты
Базы
Внешние Апи
Доп. устройства
Приложение

Попробуем описать сервис — Application
Приложение

class SelfTrialBookingService
{
...
public function __construct(
OperatorsServiceInterface $operatorsService,
BookingServiceInterface $bookingService,
SelfTrialRepositoryInterface $selfTrialRepository )
{
$this->operatorsService = $operatorsService;
$this->bookingService = $bookingService;
$this->selfTrialRepository = $selfTrialRepository;
}
}
Какие сервисы нужны?
(что если их нет? или есть?)
Что нам понадобится от них?
Что нужно от репозитория?

interface OperatorsServiceInterface
{
public function holdCall(int $educationServiceId, DateInterval $interval, string $reason): void;
public function disableCall(int $educationServiceId, string $reason): void;
public function enableCall(int $educationServiceId, string $reason): void;
}
Отложить звонок, сразу после заявки
Отменить звонок вообще, если пользователь выбрал дату/время
Назначить звонок, если пользователь передумал

interface BookingServiceInterface
{
public function bookSlot(string $slotId, string $reason): void;
public function cancelSlot(string $slotId, string $reason): void;
public function isSlotAvailableForEducationService(string $slotId, int $educationServiceId): bool;
public function getAvailableSlots();
}
Выбрать дату/время
Отменить дату/время
Проверить подходит ли дата/время
Получить список дат/времени

interface SelfTrialRepositoryInterface
{
public function save(SelfTrial $selfTrial);
public function getSelfTrialByEducationServiceId(int $educationServiceId): ?SelfTrial;
}
Сохранить
Получить

public function startSelfTrialProcess(int $educationServiceId): void
{
$this->operatorsService->holdCall(
$educationServiceId,
new DateInterval(self::HOLD_CALL_INTERVAL),
'self_trial'
);
$selfTrial = SelfTrial::start($educationServiceId);
$this->selfTrialRepository->save($selfTrial);
}
public static function start(int $educationServiceId) : SelfTrial
{
$instance = new self($educationServiceId);
$instance->status = SelfTrialStatus::STARTED();
return $instance;
}

public function bookSlot(int $educationServiceId, string $slotId, string $reason): void
{
$selfTrial = $this ->selfTrialRepository
->getSelfTrialByEducationServiceId($educationServiceId);
//Валидация и DomainException
$this->bookingService->bookSlot($slotId, $reason);
$this->operatorsService->disableCall($educationServiceId, $reason);
$selfTrial->bookSlot($slotId);
$this->selfTrialRepository->save($selfTrial);
}
public function bookSlot(string $slotId)
{
$this->slotId = $slotId;
$this->status = SelfTrialStatus::BOOKED();
}

public function cancelSelfTrial(int $educationServiceId, string $reason): void
{
$selfTrial = $this
->selfTrialRepository
->getSelfTrialByEducationServiceId($educationServiceId); //Валидация и DomainException
$this->bookingService->cancelSlot($selfTrial->getSlotId(), $reason);
$this->operatorsService->enableCall($educationServiceId, $reason);
$selfTrial->cancel();
$this->selfTrialRepository->save($selfTrial);
}
public function cancel()
{
$this->status = SelfTrialStatus::CANCELLED();
}

Да

Application
Качественно — не терять сценарии и лучше понимать бизнес проблемы
Быстро — быстро описывать сценарии в коде в отрыве от конкретных технологий (технологии не важны)
Дешево — возможность проверять сценарии как можно раньше (оно вообще работает? может и разрабатывать не надо?)

Насколько это гибко?
Вот тут будет кнопка отмены!!!

Да

Насколько это гибко?

public function bookSlot(int $educationServiceId, string $slotId, string $reason): void
{
$selfTrial = $this ->selfTrialRepository
->getSelfTrialByEducationServiceId($educationServiceId);
//Валидация и DomainException
$this->bookingService->bookSlot($slotId, $reason);
$this->operatorsService->disableCall($educationServiceId, $reason);
$this->operatorsService->enableCall($educationServiceId, $reason);
$selfTrial->bookSlot($slotId);
$this->selfTrialRepository->save($selfTrial);
}

+ обновление деталей звонка
Да

При чем тут DDD?
Ubiquitous Language (единый язык)
Можно показать заказчику
Если не поймет, покрыть BDD тестом
Bounded Context (контекст предметной области)

Hexagonal architecture / Ports and adapters
Пользователь
Программы
Тесты
Скрипты
Базы
Внешние Апи
Доп. устройства
Приложение

Более красивая картинка ;)
https://herbertograca.com/2017/09/14/ports-adapters-architecture/

Зачем
Позволяет концентрироваться на домене
Выделение бизнес логики
Тесты
Заменяемые элементы
Дисциплина (именование папок, куда что положить)

Заметки на полях
Что с атомарностю (@synchronized)?
Почему не ивенты из модели?
Где эксепшены?