RU Concepts Architecture

Архитектура

CLI / SDK  ──►  gateway (опц.)  ──►  secrets + registry + proposals
                 │
                 ▼
         провайдер вычислений (Docker | Podman)
                 │
     ┌───────────┴───────────┐
     ▼                       ▼
 sandbox-контейнер      proxy sidecar
 (агент + workspace)    (policy egress)

Плоскости

Плоскость	Компоненты
Control	CLI, HTTP API gateway, encrypted secrets, proposals
Data	Sandbox-контейнер, bind workspace, процесс агента
Enforcement	Proxy sidecar, Landlock/seccomp через whaleshell-init

Путь create

1. CLI резолвит образ, policy, providers, soft defaults.
2. Driver обеспечивает образы Engine (sandbox + slim proxy).
3. Driver создаёт internal network, proxy, sandbox, volumes.
4. Gateway регистрирует sandbox при наличии.
5. Guest ходит через HTTP(S)_PROXY на sidecar.

Модули

Модуль	Роль
whaleshell-cli	Пользовательский CLI
whaleshell-core	Схема policy + engine
whaleshell-driver	Docker / Podman / stubs
whaleshell-proxy	Egress sidecar + policy.local
whaleshell-gateway	Control plane
whaleshell-runtime	Init, образы, helpers агента
whaleshell-providers	Credential-профили

Карта: MODULES.md · ARCHITECTURE.md.