docs: extend protocol platform architecture

This commit is contained in:
a.tolmachev
2026-04-06 01:57:26 +03:00
parent 04ed704e94
commit 7f15b2db9e
12 changed files with 475 additions and 34 deletions
+8 -2
View File
@@ -8,7 +8,7 @@ Crank - платформа для публикации внешних API в в
- Разработать MCP server на Rust.
- Поддержать динамическое добавление интеграций через UI или конфигурацию.
- Обеспечить единый сценарий работы оператора для REST, GraphQL и gRPC.
- Обеспечить единый сценарий работы оператора для REST, GraphQL, gRPC, WebSocket и SOAP.
- Нормализовать внешние протоколы в единую внутреннюю модель операции.
- Ограничивать набор tools на уровне конкретного агента, а не отдавать один глобальный каталог.
- Поддержать workspace-изоляцию, platform access и observability.
@@ -21,6 +21,8 @@ Crank - платформа для публикации внешних API в в
- Поддержка REST для `GET`, `POST`, `PUT`, `PATCH` и `DELETE`.
- Поддержка GraphQL для `query` и `mutation`.
- Поддержка unary и bounded server-streaming для gRPC.
- Поддержка WebSocket upstream integrations в bounded execution modes.
- Поддержка SOAP/WSDL enterprise integrations.
- Поддержка controlled streaming modes поверх MCP `Streamable HTTP`.
- Platform API keys и membership layer.
- Observability: invocation logs, usage aggregates, latency/error metrics.
@@ -54,6 +56,8 @@ Crank - платформа для публикации внешних API в в
- `docs/protocols/rest.md` - требования и ограничения для REST.
- `docs/protocols/graphql.md` - требования и ограничения для GraphQL.
- `docs/protocols/grpc.md` - требования и ограничения для gRPC.
- `docs/protocols/websocket.md` - требования и ограничения для WebSocket.
- `docs/protocols/soap.md` - требования и ограничения для SOAP.
## Ключевая идея продукта
@@ -90,8 +94,10 @@ Crank - платформа для публикации внешних API в в
- REST
- GraphQL
- gRPC
- WebSocket
- SOAP
`SOAP` сознательно не входит в текущий scope.
Все пять протокольных семейств входят в целевой product scope. Разница только в очередности реализации.
## Frontend e2e