Глоссарий

Гексагональная архитектура

Гексагональная архитектура (Ports & Adapters, Алистер Кокберн) — доменная логика в центре, изолированная от внешнего мира через порты (интерфейсы) и адаптеры (реализации). HTTP, очереди, БД, CLI — всё внешнее, взаимозаменяемое.

Порты и адаптеры

Port — интерфейс, описывающий взаимодействие с доменом. Например: UserRepository, PaymentGateway
Primary adapter — инициирует действие (HTTP-контроллер, CLI-команда, очередь)
Secondary adapter — реализация порта (MySQL репозиторий, Stripe gateway, SendGrid mailer)

Почему "гексагон"

Шестиугольник в названии — не технический факт, а символ: у домена есть несколько сторон (портов) для внешнего взаимодействия. Количество не фиксировано.

Родственные концепции

Clean Architecture, Onion Architecture — разные названия той же идеи: бизнес-логика не зависит от инфраструктуры. Разница — в деталях слоёв.