Глосарій

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

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

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

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

Чому "гексагон"

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

Спорідненість

Clean Architecture, Onion Architecture — різні назви тієї ж ідеї: бізнес-логіка не залежить від інфраструктури. Різниця — в деталях шарування.