Глоссарий
Adapter
Конкретная реализация Port. Переводит формат внешнего мира (HTTP, SQL, AMQP) в формат core.
Adapter — реализация Port’а.
Живёт в infrastructure- или interface-слое. Знает про конкретную технологию: SQLAlchemy, httpx, RabbitMQ. Скрывает эти детали от use case.
Пример: PostgresOrderRepository реализует OrderRepositoryPort через SQLAlchemy. HttpPaymentGateway реализует PaymentGatewayPort через httpx. RabbitEventPublisher реализует EventPublisherPort через FastStream.
Правило: один Adapter = одна технология. Если PostgresOrderRepository знает про Redis — что-то не так.
Adapter — не «класс с постфиксом Adapter». Это роль. PostgresOrderRepository, HttpPaymentGateway, RabbitEventPublisher — все Adapter’ы, никакого суффикса не носят.