References: Рекурсивная публикация записей с вложенными ссылками

User Story: https://tracker.yandex.ru/PRXS-1305

Subtask: https://tracker.yandex.ru/PRXS-1449

Добавлен метода сервиса References.Publish для рекурсивной публикации. Позволяет:

• Получить предварительный список неопубликованных связанных записей для принятия решения пользователем
• Опубликовать запись и все связанные элементы
• Опубликовать элементы по списку ссылок

proto/references/references.proto

@@ -24,8 +24,37 @@ message GetResponse {
   repeated Reference notfound = 2;
 }
 
-// References принимает список ссылок на записи и возвращает два списка:
-// список найденных записей и не найденных ссылок
+// PublishRequest запрос на публикацию записей по ссылкам
+message PublishRequest {
+  string space_id = 1; // Пространство публикации
+  string env_id = 2; // Окружение публикации
+  repeated Reference references = 3; // Список ссылок на записи для публикации
+  bool recursive = 4; // Рекурсивно публиковать все ссылки на найденные записи
+  bool force = 5; // Принудительно публиковать записи, даже если они содержат не опубликованные ссылки
+}
+
+// PublishResponse ответ на запрос публикации записей
+message PublishResponse {
+  repeated Reference published = 2; // Список опубликованных записей
+  repeated Reference notfound = 3; // Список не найденных записей
+  repeated Reference unpublished = 4; // Список не опубликованных записей, требующих публикации
+}
+
+// References сервис предназначен для работы со ссылками на записи
 service References  {
+
+  // Get возвращает список записей по ссылкам
   rpc Get(GetRequest) returns(GetResponse) {}
+
+  // Publish принимает список ссылок на записи и публикует их с учетом вложенных ссылок.
+  //
+  // - В случае если флаг `recursive` установлен в true, то будут рекурсивно опубликованы
+  //   все записи на которые ссылаются найденные записи.
+  // - Если флаг `recursive` установлен в false, то будут опубликованы записи
+  //   только из списка `references` в случае если они не содержат не опубликованных
+  //   ссылок. В противном случае возвращается список не опубликованных записей `unpublished`
+  //   которые требуют публикации. Список `published` при этом будет пустым. В случае если флаг
+  //   `force` установлен в true, то записи будут опубликованы даже если они содержат
+  //   не опубликованные ссылки.
+  rpc Publish(PublishRequest) returns(PublishResponse) {}
 }