feat: add grpc support

docs/admin-api.md

@@ -216,7 +216,7 @@
 
 ## 7. gRPC descriptor endpoints
 
-Следующие endpoints относятся к фазе `grpc-support` и не входят в `admin-api v1`:
+Следующие endpoints относятся к фазе `grpc-support` и реализованы как часть gRPC vertical slice:
 
 ### `POST /api/admin/operations/{operation_id}/descriptors/proto`
 
@@ -230,6 +230,15 @@
 
 - загрузить `descriptor set`.
 
+Ответ:
+
+```json
+{
+  "descriptor_id": "desc_01",
+  "version": 1
+}
+```
+
 ### `GET /api/admin/operations/{operation_id}/grpc/services`
 
 Назначение:
@@ -247,7 +256,9 @@
       "methods": [
         {
           "name": "CreateLead",
-          "kind": "unary"
+          "kind": "unary",
+          "input_schema": { "type": "object", "fields": {} },
+          "output_schema": { "type": "object", "fields": {} }
         }
       ]
     }
@@ -255,6 +266,8 @@
 }
 ```
 
+Discovery endpoint используется для выбора unary метода и для построения UI-формы входа/выхода до публикации операции.
+
 ## 8. Тестовый запуск
 
 ### `POST /api/admin/operations/{operation_id}/test-runs`

docs/architecture.md

@@ -230,6 +230,7 @@ gRPC target:
 - `service`
 - `method`
 - `descriptor_ref`
+- `descriptor_set_b64`
 
 ### Schema
 

docs/data-model.md

@@ -213,7 +213,8 @@
   "package": "crm.v1",
   "service": "LeadService",
   "method": "CreateLead",
-  "descriptor_ref": "desc_01hr7yn4d6g1x6vwt7h9n0e7ab"
+  "descriptor_ref": "desc_01hr7yn4d6g1x6vwt7h9n0e7ab",
+  "descriptor_set_b64": "<base64-encoded-descriptor-set>"
 }
 ```
 
@@ -225,6 +226,11 @@
 - `service`
 - `method`
 - `descriptor_ref`
+- `descriptor_set_b64`
+
+`descriptor_ref` остается ссылкой на загруженный descriptor artifact в storage и registry.
+
+`descriptor_set_b64` - runtime-ready snapshot descriptor set, который используется unary gRPC adapter для динамического вызова метода без генерации Rust-кода.
 
 ## 5. `Schema`
 

docs/diagrams.md

@@ -142,6 +142,7 @@ classDiagram
       +service
       +method
       +descriptor_ref
+      +descriptor_set_b64
     }
 
     class Schema {

docs/protocols/grpc.md

@@ -52,6 +52,7 @@ gRPC operation должна включать:
 - `service`
 - `method`
 - `descriptor_ref`
+- `descriptor_set_b64`
 - `input_schema`
 - `output_schema`
 - `input_mapping`
@@ -66,7 +67,7 @@ gRPC operation должна включать:
 3. Оператор выбирает конкретный unary-метод.
 4. UI показывает структуру request message и response message.
 5. При необходимости загружает примеры JSON для MCP input/output.
-6. Система строит черновую схему и стартовый mapping.
+6. Система строит черновую схему, стартовый mapping и runtime-ready snapshot descriptor set для выбранного метода.
 7. Оператор задает или уточняет входные MCP-параметры.
 8. Настраивает маппинг во входные protobuf fields.
 9. Настраивает маппинг из response fields в MCP output.
@@ -90,6 +91,7 @@ gRPC operation должна включать:
 
 - `.proto` и descriptor handling должны быть отделены от runtime-вызова;
 - protobuf discovery не должен жить внутри gRPC adapter;
+- runtime использует сохраненный `descriptor_set_b64`, а не исходный `.proto`;
 - `oneof`, `enum`, `repeated`, `map` и well-known types требуют отдельной нормализации;
 - `map` на слое нормализованной schema модели представляется как `array` объектов вида `{ key, value }`;
 - `oneof` на слое нормализованной schema модели представляется как `oneof` с вариантами-объектами, каждый из которых содержит одно допустимое поле;