docs: extend protocol platform architecture
This commit is contained in:
+23
-6
@@ -124,13 +124,13 @@ Crank - платформа для публикации внешних API в в
|
||||
- изолировать данные команд;
|
||||
- строить logs и usage не глобально, а по tenant boundary.
|
||||
|
||||
## 5. Границы целевого MVP
|
||||
## 5. Границы целевого продукта
|
||||
|
||||
### Входит
|
||||
|
||||
- `Workspace` как tenant boundary.
|
||||
- Операции `REST`, `GraphQL`, `unary gRPC`.
|
||||
- Controlled streaming operations поверх `Streamable HTTP`, REST SSE и gRPC server-streaming.
|
||||
- Операции `REST`, `GraphQL`, `gRPC`, `WebSocket`, `SOAP`.
|
||||
- Controlled streaming operations поверх `Streamable HTTP`, REST SSE, gRPC server-streaming и WebSocket upstream.
|
||||
- `Agent` и привязка операций к агенту.
|
||||
- Agent-scoped MCP endpoints.
|
||||
- Platform API keys.
|
||||
@@ -140,11 +140,12 @@ Crank - платформа для публикации внешних API в в
|
||||
- Импорт и экспорт operation-конфигураций в `YAML`.
|
||||
- Hot reload опубликованных agents и operations.
|
||||
|
||||
### Не входит
|
||||
### Отложено
|
||||
|
||||
- GraphQL `subscription`.
|
||||
- gRPC client-streaming и bidirectional streaming.
|
||||
- SOAP.
|
||||
- raw infinite stream passthrough.
|
||||
- полный стек WS-* расширений.
|
||||
- Оркестрация workflow.
|
||||
- Биллинг.
|
||||
- Full RBAC policy engine.
|
||||
@@ -209,12 +210,28 @@ GraphQL в MCP публикуется как фиксированная опер
|
||||
- JSON-oriented schema model поверх protobuf;
|
||||
- без client-streaming и bidi.
|
||||
|
||||
### WebSocket
|
||||
|
||||
- upstream-only adapter;
|
||||
- bounded `window`, `session` и `async_job`;
|
||||
- subscribe/unsubscribe messages;
|
||||
- heartbeat и reconnect policy;
|
||||
- не используется как downstream MCP transport.
|
||||
|
||||
### SOAP
|
||||
|
||||
- WSDL-driven request-response integration;
|
||||
- service/port/operation selection;
|
||||
- SOAP envelope и fault normalization;
|
||||
- request-response first;
|
||||
- long-running workflows через `async_job`, если upstream это поддерживает.
|
||||
|
||||
### Streaming
|
||||
|
||||
Платформа поддерживает controlled streaming model:
|
||||
|
||||
- downstream transport: `Streamable HTTP` с optional SSE;
|
||||
- upstream streaming: REST SSE и gRPC server-streaming;
|
||||
- upstream streaming: REST SSE, gRPC server-streaming и WebSocket;
|
||||
- execution modes: `unary`, `window`, `session`, `async_job`;
|
||||
- никакого raw infinite stream passthrough в MCP client.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user