Merge branch 'feature/PRXS-768-TransferSpace' into 'master'

Добавлен метод Move для переноса пространства

See merge request !11

proto/spaces/spaces.proto

@@ -72,12 +72,12 @@ message DeleteRequest {
 }
 
 message TransferRequest {
-  string space_id = 1;
-  string transfer_to_org = 2;
+  string space_id = 1; // Идентификатор перемещаемого пространства
+  string transfer_to_org = 2; // Идентификатор организации, в которую пространство должно быть перемещено
 }
 
 message AbortTransferRequest {
-  string space_id = 1;
+  string space_id = 1; // Идентификатор перемещаемого пространства
 }
 
 message ListTransfersRequest {
@@ -88,8 +88,9 @@ message ListTransfersResponse {
   repeated Space spaces = 1;
 }
 
-message AcceptTransferRequest {
-  string space_id = 1;
+message MoveRequest {
+  string space_id = 1; // Идентификатор перемещаемого пространства
+  string org_id = 2; // Идентификатор организации, в которую пространство должно быть перемещено. Обязателен для заполнения только в случае запросов с системным уровнем доступа, в остальных случаях опционален
 }
 
 service Spaces {
@@ -104,16 +105,20 @@ service Spaces {
   // будет отображаться в списке входящих запросов на перемещение в организации `orgID` (запрос ListIncoming)
   // С пространством можно продолжать работу в текущей организации, пока запрос на перемещение не будет
   // принят в целевой организации
+  // Перенос может быть инициирован только владельцем организации, которой принадлежит пространство
   rpc Transfer(TransferRequest) returns(google.protobuf.Empty) {}
 
-  // AbortTransfer - отменить перемещение пространства в другую организацию
+  // AbortTransfer - отменить перемещение пространства в другую организацию. Может быть вызван как
+  // владельцем пространства-инициатора, там и владельцем принимающего пространства
   rpc AbortTransfer(AbortTransferRequest) returns(google.protobuf.Empty) {}
 
   // ListTransfers возвращает список пространств, перемещение которых было запрошено в текущую организацию
   rpc ListTransfers(ListTransfersRequest) returns(ListTransfersResponse) {}
 
-  // AcceptTransfer - принять запрос на перемещение пространства. Оно будет перемещено в текущую организацию со
+  // Move - перенести пространство в организацию, установленную в Space.TransferToOrg. Пространство переносится со
   // всеми входящими в него данными: ролями, участниками, контентом, пр. и более не будет доступно в
-  // старой организации
-  rpc AcceptTransfer(AcceptTransferRequest) returns(google.protobuf.Empty) {}
+  // исходной организации.
+  // В случае, если запрос осуществляется с системным уровнем доступа и передан параметр `org_id`, то перенос будет
+  // осуществлен вне зависимости от того, был он инициирован через метод `Transfer` или нет
+  rpc Move(MoveRequest) returns(google.protobuf.Empty) {}
 }