IMP-281: Dominant-v2 proto

[ndiezel0]

No description provided.

[A77AY]

есть предложение сортировать по умолчанию (для query *) по id

[A77AY]

для остальных случаев по весу

[A77AY]

а есть сейчас какая то логика почему разделено на два сервиса Repository и RepositoryClient?

[ndiezel0]

АПИ RepositoryClient важно для ядра и потому надо держать в стабильном состоянии. Но на самом деле какого-то великого смысла нет, кроме как референса к исторической практике

[A77AY]

выглядит что он уже итак переписан и туда докинули еще один депрекейтед метод, как будто весь сервис депрекейтед, но просто repository не умеет checkout

[nanodirijabl]

@ndiezel0

1. Для капи операций типа GetCountries нужна поддержка чекаута коллекции объектов по типу и референсу версии. Например типа того что я прежде добавлял в этот ПР (только нужно 1: VersionReference version_ref):

       /**
        * Возвращает список объектов данного типа.
        */
       ObjectVersionsResponse GetObjectsByType (
           1: Version version
           2: domain.DomainObjectTypes type
           3: RequestParams request_params
       )
           throws (1: ObjectTypeNotFound ex1)

2. В существующих инструментах тестирования в ХГ есть необходимость в сбросе состояния версии до заданной, например после группы мутирующих домен тест кейсов. Сейчас это осуществляется через вычитку всего "снепшота" (всех объектов) целевой версии с последующим апсёртом на актульную версию. Превентивно задепрекейченная функция CheckoutSnapshot в принципе подойдёт, но так же подойдёт и SearchFullObjects без использования критериев поиска.

   Предлагаю пересмотреть комментарии к этим функциям и добавить замечания об ограничениях и их области применимости.

   Так же предлагаю явно разделить часть API нового протокола доминанты на публичное API и внутреннее API, например по-сервисно (service RepositoryInternal {..., где только публичное API стоит рассматривать для разработки новых клиентов сервиса. Внутреннее же API может содержать что-либо ориентированное для работы с конкретным сервисом или служебный костыль. В случае костыля явно помечать кто использует, чтобы потом легко и без лишних обсуждений можно было отправлять его под нож.

3. В качестве альтернативного решения с добавлением CheckoutSnapshot для нужд ХГ, предлагаю рассмотреть вариант с добавлениев функции Version Rollback (1: Version version, 2: AuthorID author_id), которая и будет осуществлять откат домен-конфига до состояния целевой версии без выворачивания наружу (и в API) "снепшота".