chore: publish clean community baseline

docs/data-model.md

@@ -0,0 +1,96 @@
+# Модель данных
+
+Документ фиксирует текущую Community data model.
+
+## Workspace
+
+Workspace содержит:
+
+- operations;
+- agents;
+- secrets;
+- auth profiles;
+- logs;
+- usage.
+
+## Operation
+
+Operation описывает один REST integration contract.
+
+Основные поля:
+
+- `id`
+- `workspace_id`
+- `name`
+- `display_name`
+- `category`
+- `protocol = rest`
+- `status`
+- `target`
+- `input_schema`
+- `output_schema`
+- `input_mapping`
+- `output_mapping`
+- `execution_config`
+- `tool_description`
+- `created_at`
+- `updated_at`
+
+## REST target
+
+REST target содержит:
+
+- `base_url`
+- `method`
+- `path_template`
+- `static_headers`
+
+Поддерживаемые методы:
+
+- `GET`
+- `POST`
+- `PUT`
+- `PATCH`
+- `DELETE`
+
+## Agent
+
+Agent определяет MCP endpoint и набор published operations.
+
+Основные поля:
+
+- `id`
+- `workspace_id`
+- `slug`
+- `display_name`
+- `description`
+- `status`
+
+Operation публикуется в agent через binding.
+
+## Secrets и auth profiles
+
+`Secret` хранит encrypted secret material.
+
+`AuthProfile` описывает, как применить secret к REST request:
+
+- bearer token;
+- basic auth;
+- API key header;
+- API key query parameter.
+
+Plaintext secret не возвращается через API после создания.
+
+## Logs и usage
+
+Invocation logs фиксируют:
+
+- workspace;
+- agent;
+- operation;
+- request id;
+- status;
+- latency;
+- structured error context.
+
+Usage rollups агрегируют вызовы по периодам.