Модуль 8. Sync Input Adapters

Время выполнения задания: ~1-1.5 часа 

Сложность: ⭐️⭐️ (максимум ⭐️⭐️⭐️⭐️⭐️)

Бонусы: 200

На вашем счету сейчас: 1 бонуса/ов

Для того чтобы сервис работал, ему нужна база данных и прочие зависимости. Все эти зависимости запускаются в Docker и находятся в проекте Infrastructure.

Подтяните последнюю версию Infrastructure

• Если вы ранее не скачивали проект, то:

git clone https://gitlab.com/microarch-ru/ddd-in-practice/infrastructure.git

• А если скачивали, то просто обновите:

git pull https://gitlab.com/microarch-ru/ddd-in-practice/infrastructure.git

• Откройте терминал и перейдите в папку Infrastructure
• Выполните команду 

docker-compose up

• Если ваш компьютер маломощный, то вы можете запускать инфраструктурные системы выборочно. Оставьте в команде, только нужные системы:

docker-compose up postgres kafka init-kafka kowl geo notification discount backoffice basket

Установите в проект следующие пакеты:

• https://echo.labstack.com/docs/quick-start
• https://github.com/oapi-codegen/oapi-codegen

Легенда

Вы отвечаете за разработку микросервиса Delivery (доставка)

Подготовка

• Вы работаете в своём Git репозитории "delivery"
• Создайте ветку module-8
• Выполните задание в ней 

Задача

• Реализуйте HTTP API методы микросервиса Delivery. Для этого:
  • Сгенерируйте HTTP Server:
    • Добавьте server.cfg.yaml файл в /configs (показан ниже)
    • Выполните команду генерации сервера (показана ниже)
    • Если все прошло успешно, то в папке pkg/servers появятся файлы

• Реализуйте HTTP Handler в соответствии с контрактом.
• Реализуйте Job (регулярные задачи)
  • Перемещение курьеров 1 раз в 1 секунду
  • Назначение заказов 1 раз в 1 секунду
• В методе CreateOrder вызовите команду с вымышленными параметрами (пример показан ниже).
• Скомпилируйте приложение
• Запустите приложение
• Убедитесь, что методы корректно работают (используйте Postman коллекцию)

package: servers
output: internal/generated/servers/servers.gen.go
generate:
  - types
  - echo-server
  - embedded-spec
  - models
  - strict-server
import-mapping: {}

oapi-codegen -config configs/server.cfg.yaml https://gitlab.com/microarch-ru/ddd-in-practice/system-design/-/raw/main/services/delivery/contracts/openapi.yml

Далее в курсе мы будем создавать заказ, обрабатывая сообщение из Kafka от микросервиса Basket, но пока этот функционал у нас не реализован, а тестировать уже хочется. Ниже показано, как может выглядеть реализация тестового API метода CreateOrder:

func (s *Server) CreateOrder(c echo.Context) error {
    createOrderCommand, err := commands.NewCreateOrderCommand(uuid.New(), "Несуществующая", 5)
    if err != nil {
        return problems.NewBadRequest(err.Error())
    }

    err = s.createOrderCommandHandler.Handle(c.Request().Context(), createOrderCommand)
    if err != nil {
        if errors.Is(err, errs.ErrObjectNotFound) {
            return problems.NewNotFound(err.Error())
        }
        return problems.NewConflict(err.Error(), "/")
    }

    return c.JSON(http.StatusOK, nil)
}

Критерии оценивания

• API методы есть и работают
• Приложение компилируется и запускается
• Исходный код залит в Git репозиторий