Facade: простой интерфейс для сложной системы

Facade: простой интерфейс для сложной системы

Хорошая регистрация пользователя - это пять-семь шагов внутри и одна функция снаружи. Facade - про эту одну функцию.

Проблема

Чтобы зарегистрировать пользователя, нужно:

  1. Валидировать данные
  2. Создать запись в БД
  3. Отправить welcome-email
  4. Записать событие в аналитику
  5. Создать настройки по умолчанию

Если клиентский код вызывает каждый сервис отдельно:

// в обработчике
if err := validator.Check(email, pass); err != nil { return err }
user, err := userRepo.Create(email, pass)
if err != nil { return err }
_ = mailer.SendWelcome(user.Email)
tracker.Event("register", user.ID)
settingsRepo.CreateDefaults(user.ID)
<?php
declare(strict_types=1);

// в обработчике
$validator->check($email, $pass);
$user = $userRepo->create($email, $pass);
try {
    $mailer->sendWelcome($user->email);
} catch (Throwable) {
    // некритично
}
$tracker->event('register', $user->id);
$settingsRepo->createDefaults($user->id);
# в обработчике
validator.check(email, password)
user = user_repo.create(email, password)
try:
    mailer.send_welcome(user.email)
except Exception:
    pass  # некритично
tracker.event("register", user.id)
settings_repo.create_defaults(user.id)

Тот же код повторяется в API-обработчике, в CLI, в тестах. Каждый «клиент» знает все 5 шагов и правильный порядок - клиентский код не следует SRP, потому что вынужден держать в голове чужие детали.

Решение: Facade

Facade - один метод (или структура), который скрывает координацию нескольких подсистем. Клиент вызывает Register() и не думает о деталях.

Клиент → один метод фасада → 5 сервисов по порядку

Сценарий регистрации: фасад или Use Case?

Ниже - классический учебный «фасад регистрации». Посмотри на код, а чуть дальше разберём, почему по намерению он ближе к Use Case.

type RegisterFacade struct {
    validator Validator
    users     UserRepo
    mail      Mailer
    tracker   Tracker
    settings  SettingsRepo
}

func NewRegisterFacade(
    v Validator, u UserRepo, m Mailer, t Tracker, s SettingsRepo,
) *RegisterFacade {
    return &RegisterFacade{
        validator: v, users: u, mail: m, tracker: t, settings: s,
    }
}

func (f *RegisterFacade) Register(email, pass string) (*User, error) {
    // 1. Валидация
    if err := f.validator.Check(email, pass); err != nil {
        return nil, fmt.Errorf("validation: %w", err)
    }

    // 2. Создание пользователя
    user, err := f.users.Create(email, pass)
    if err != nil {
        return nil, fmt.Errorf("create user: %w", err)
    }

    // 3. Некритичные операции - ошибки не блокируют регистрацию
    if err := f.mail.SendWelcome(email); err != nil {
        log.Printf("welcome email failed: %v", err)
    }
    f.tracker.Event("register", user.ID)
    f.settings.CreateDefaults(user.ID)

    return user, nil
}

Клиентский код прост:

user, err := facade.Register(email, pass)
final class RegisterFacade
{
    public function __construct(
        private readonly Validator $validator,
        private readonly UserRepo $users,
        private readonly Mailer $mail,
        private readonly Tracker $tracker,
        private readonly SettingsRepo $settings,
        private readonly LoggerInterface $logger,
    ) {}

    public function register(string $email, string $pass): User
    {
        // 1. Валидация
        $this->validator->check($email, $pass);

        // 2. Создание пользователя
        $user = $this->users->create($email, $pass);

        // 3. Некритичные операции - ошибки не блокируют регистрацию
        try {
            $this->mail->sendWelcome($email);
        } catch (Throwable $e) {
            $this->logger->warning('welcome email failed', ['err' => $e->getMessage()]);
        }
        $this->tracker->event('register', $user->id);
        $this->settings->createDefaults($user->id);

        return $user;
    }
}

Клиентский код прост:

$user = $facade->register($email, $pass);
import logging

logger = logging.getLogger(__name__)


class RegisterFacade:
    def __init__(
        self,
        validator: Validator,
        users: UserRepo,
        mail: Mailer,
        tracker: Tracker,
        settings: SettingsRepo,
    ) -> None:
        self._validator = validator
        self._users = users
        self._mail = mail
        self._tracker = tracker
        self._settings = settings

    def register(self, email: str, password: str) -> User:
        # 1. Валидация - при ошибке validator бросает ValidationError
        self._validator.check(email, password)

        # 2. Создание пользователя
        user = self._users.create(email, password)

        # 3. Некритичные операции - ошибки не блокируют регистрацию
        try:
            self._mail.send_welcome(email)
        except Exception:
            logger.warning("welcome email failed", exc_info=True)
        self._tracker.event("register", user.id)
        self._settings.create_defaults(user.id)

        return user

Клиентский код прост:

user = facade.register(email, password)

Критичные ошибки (валидация, БД) не перехватываются и летят вызывающему исключением - аналог return nil, err. Перехватывается только некритичная почта.

Один вызов вместо пяти. Порядок, обработка ошибок, логирование - всё внутри фасада.

ℹ️ Фасад упрощает клиентский код

Без фасада каждый клиент (handler, CLI, тест) повторяет одну и ту же последовательность вызовов. Фасад - единая точка входа. Изменил порядок шагов? Правишь одно место.

Facade и Use Case: похожи снаружи, разные по назначению

В коде они часто выглядят одинаково - один входной метод вместо пяти вызовов, - и отсюда рождается путаница. Различает их намерение, а не форма:

Facade (GoF)Use Case / Application Service
Что решаетсложность доступа к готовой подсистемеописывает прикладной сценарий целиком
Откуда берётсяиз желания спрятать неудобный или разросшийся APIиз требования продукта: «пользователь регистрируется»
Что внутрипоследовательность вызовов подсистемысценарий: проверки, вызовы домена, транзакция, публикация события
Можно ли выброситьда, если API стал удобнымнет: сценарий никуда не денется
Уровеньприём проектированияслой архитектуры

⚠️ «Use Case - это Facade с бизнес-правилами» - формулировка, от которой стоит отказаться

Она склеивает два понятия так, что потом их трудно разделить.

Проверка на практике простая: Facade появляется из-за неудобства существующего кода, Use Case - из-за требования предметной области. Если подсистему завтра заменят удобной библиотекой, фасад исчезнет; сценарий «зарегистрировать пользователя» останется, потому что он есть в продукте, а не в коде.

Из этого следует и разное отношение к бизнес-правилам. Facade их не должен содержать - иначе правила расползутся по обёрткам инфраструктуры. Use Case содержит правила уровня сценария (что проверить, в каком порядке позвать, чем закончить транзакцию), но не правила самого домена - те живут в сущностях и агрегатах.

А теперь честно про RegisterFacade из примера выше: он пограничный, и назван фасадом по инерции. Посмотри, что он делает: вызывает валидацию, создаёт пользователя, а дальше принимает решение - «ошибка приветственного письма не отменяет регистрацию». Последнее и есть правило уровня сценария: его придумал не программист ради удобства, а продукт («не терять регистрации из-за почты»).

По намерению это Use Case. Фасадом он был бы, если бы только пробрасывал вызовы, а решение о том, что критично и что нет, принимал вызывающий.

Это и есть главная мысль раздела: по коду отличить нельзя, отличают по причине появления. Один и тот же набор строк оказывается фасадом или сценарием в зависимости от того, откуда взялось требование - из неудобства API или из предметной области. Поэтому «Facade с бизнес-правилами» - плохое определение: как только правила появились, это уже не фасад.

Когда фасад полезен

СценарийЗачем фасад
Отправка письма: шаблон + рендер + SMTPОдин вызов Send() вместо трёх
Оплата: проверка → списание → чекКлиент не знает деталей
Импорт данных: парсинг → маппинг → БДОдин метод Import()
Деплой: сборка → тест → пуш → SSHmake deploy = фасад

Фасад в Go stdlib

http.ListenAndServe(addr, handler)
 - фасад над: создание Server, TCP-listener, Accept-loop, goroutine per conn

json.Marshal(v)
 - фасад над: рефлексия, encoder, буфер, типы

exec.Command(name, args...).Run()
 - фасад над: fork, exec, pipe, wait

http.ListenAndServe - одна строка, за которой скрыта сложная машинерия: создание TCP-сокета, принятие соединений, запуск горутин, парсинг HTTP.

Когда фасад маскирует проблемы

Фасад - это «удобная дверца». Но если за дверцей хаос, фасад его не исправит, а только спрячет:

God Facade - метод DoEverything() на 200 строк. Это не фасад, это монолит с красивым именем. Фасад должен делегировать, а не содержать логику.

Сокрытие плохого API - если подсистемы спроектированы плохо, фасад лишь откладывает рефакторинг. Лучше исправить подсистемы.

Фасад над фасадом - если ты оборачиваешь фасад другим фасадом, что-то пошло не так с декомпозицией.

⚠️ Бизнес-правила живут в домене

Фасад координирует вызовы, но НЕ содержит бизнес-правила. «Пароль минимум 8 символов» - это домен/валидатор. Фасад просто вызывает validator.Check(). Это применение SRP на уровне модуля: у фасада ровно одна причина меняться - изменение оркестрации шагов.

Когда НЕ использовать

Одна подсистема - если ты координируешь один сервис, фасад - лишняя обёртка. Вызывай сервис напрямую.

Клиенту нужен контроль - если разные клиенты вызывают шаги в разном порядке или пропускают некоторые, один фасад не подойдёт. Возможно, нужен Builder или несколько фасадов.

Тривиальная координация - если «фасад» это 2 вызова подряд, проще оставить как есть.

Связь с другими паттернами

Facade + Adapter - адаптер внутри фасада для внешних SDK
Facade + Observer - фасад публикует событие после выполнения
Facade + Factory - фабрика создаёт фасад с нужными зависимостями
Facade + Mediator - похожи: оба координируют, но Mediator управляет
                        взаимодействием МЕЖДУ объектами

Мини-задание

  • Выдели один фасад для частого сценария в приложении (регистрация, оплата, импорт)
  • Проверь: фасад только координирует? Или содержит бизнес-логику? Если да - вынеси логику в домен
  • Найди http.ListenAndServe в исходниках Go - сколько шагов он скрывает?
  • Подумай: есть ли в проекте «God Service» на 500 строк? Может, его стоит разбить на фасад + отдельные сервисы?

Зарегистрируйтесь бесплатно, чтобы пройти квиз, решить задание с автопроверкой, вести прогресс.