add Upload and Download files

api/main.proto

@@ -5,6 +5,7 @@ package crabs.evening_detective_server;
 import "google/api/annotations.proto";
 import "google/protobuf/timestamp.proto";
 import "protoc-gen-openapiv2/options/annotations.proto";
+import "google/api/httpbody.proto";
 
 option go_package = "pkg/proto";
 
@@ -42,6 +43,7 @@ service EveningDetectiveServer {
       security: {
         security_requirement: {}
       }
+      summary: "Проверить доступность";
     };
   }
 
@@ -53,6 +55,7 @@ service EveningDetectiveServer {
       security: {
         security_requirement: {}
       }
+      summary: "Проверить обработку данных";
     };
   }
 
@@ -65,6 +68,8 @@ service EveningDetectiveServer {
       security: {
         security_requirement: {}
       }
+      tags   : "Регистрация и вход";
+      summary: "Зарегистрироваться";
     };
   }
 
@@ -77,6 +82,8 @@ service EveningDetectiveServer {
       security: {
         security_requirement: {}
       }
+      tags   : "Регистрация и вход";
+      summary: "Обновить пароль";
     };
   }
 
@@ -89,6 +96,8 @@ service EveningDetectiveServer {
       security: {
         security_requirement: {}
       }
+      tags   : "Регистрация и вход";
+      summary: "Войти и получить токена доступа";
     };
   }
 
@@ -101,6 +110,8 @@ service EveningDetectiveServer {
       security: {
         security_requirement: {}
       }
+      tags   : "Регистрация и вход";
+      summary: "Обновить токена доступа";
     };
   }
 
@@ -108,18 +119,30 @@ service EveningDetectiveServer {
     option (google.api.http) = {
       get: "/api/users"
     };
+    option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
+      tags   : "Пользователи";
+      summary: "Получить всех пользователей";
+    };
   }
 
   rpc GetUserById(GetUserByIdReq) returns (GetUserByIdRsp) {
     option (google.api.http) = {
       get: "/api/users/{id}"
     };
+    option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
+      tags   : "Пользователи";
+      summary: "Получить пользователя по id";
+    };
   }
 
   rpc GetMe(GetMeReq) returns (GetMeRsp) {
     option (google.api.http) = {
       get: "/api/users/me"
     };
+    option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
+      tags   : "Пользователи";
+      summary: "Получить информацию о себе";
+    };
   }
 
   rpc AddUserRole(AddUserRoleReq) returns (AddUserRoleRsp) {
@@ -127,12 +150,20 @@ service EveningDetectiveServer {
       post: "/api/users/{id}/role/add"
       body: "*"
     };
+    option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
+      tags   : "Пользователи";
+      summary: "Добавить пользователю роль";
+    };
   }
 
   rpc DeleteUserRole(DeleteUserRoleReq) returns (DeleteUserRoleRsp) {
     option (google.api.http) = {
       post: "/api/users/{id}/role/delete"
-      body  : "*"
+      body: "*"
+    };
+    option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
+      tags   : "Пользователи";
+      summary: "Забрать у пользователя роль";
     };
   }
 
@@ -140,6 +171,31 @@ service EveningDetectiveServer {
     option (google.api.http) = {
       get: "/api/ui/permissions"
     };
+    option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
+      tags   : "Доступы";
+      summary: "Получить список доступных элементов интерфейса";
+    };
+  }
+
+  rpc UploadFile(UploadFileReq) returns (UploadFileRsp) {
+    option (google.api.http) = {
+      post: "/api/files/upload"
+      body: "*"
+    };
+    option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
+      tags   : "Файлы";
+      summary: "Загрузить файл";
+    };
+  }
+
+  rpc DownloadFile(DownloadFileReq) returns (google.api.HttpBody) {
+    option (google.api.http) = {
+      get: "/api/files/{filename}"
+    };
+    option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
+      tags   : "Файлы";
+      summary: "Получить файл";
+    };
   }
 }
 
@@ -246,6 +302,20 @@ message DeleteUserRoleRsp {
 message GetPermissionsReq {}
 
 message GetPermissionsRsp {
-  string error = 1;
-  repeated string permissions = 2; 
+  string          error       = 1;
+  repeated string permissions = 2;
+}
+
+message UploadFileReq {
+  string filename = 1;
+  bytes  data     = 2;
+}
+
+message UploadFileRsp {
+  string error    = 1;
+  string filename = 2;
+}
+
+message DownloadFileReq {
+  string filename = 1;
 }