crank/docs/database-schema.md

Схема БД

Основная БД Crank Community — PostgreSQL.

Основные таблицы

• workspaces
• users
• user_sessions
• memberships
• operations
• operation_versions
• published_operations
• operation_samples
• agents
• agent_versions
• agent_operation_bindings
• published_agents
• platform_api_keys
• secrets
• secret_versions
• auth_profiles
• invocation_logs
• usage_rollups
• yaml_import_jobs

memberships используется как служебная привязка единственного администратора к bootstrap workspace.

Operations

operations хранит текущую карточку operation.

operation_versions хранит versioned JSON contract:

• REST target;
• schemas;
• mappings;
• execution config;
• tool description;
• samples metadata.

published_operations указывает на опубликованную version.

Agents

agents хранит карточку agent.

agent_versions хранит versioned agent contract.

agent_operation_bindings связывает agent и published operations.

published_agents указывает на опубликованную version.

Secrets

secrets хранит metadata.

secret_versions хранит encrypted value.

auth_profiles хранит способ применения secrets к REST request.

Observability

invocation_logs хранит события runtime/MCP вызовов.

usage_rollups хранит агрегированную статистику.