feat: add platform access foundation

docs/admin-api.md

@@ -51,9 +51,15 @@
 - `GET /api/admin/workspaces/{workspace_id}`
 - `PATCH /api/admin/workspaces/{workspace_id}`
 - `GET /api/admin/workspaces/{workspace_id}/members`
+- `GET /api/admin/workspaces/{workspace_id}/invitations`
 - `POST /api/admin/workspaces/{workspace_id}/invitations`
 - `DELETE /api/admin/workspaces/{workspace_id}/invitations/{invitation_id}`
 
+Контракт:
+
+- `POST /invitations` возвращает metadata invitation и одноразовый `invite_token`;
+- `invite_token` доступен только в create-response и не возвращается повторно в list endpoints.
+
 ### 5.2. Operations
 
 - `GET /api/admin/workspaces/{workspace_id}/operations`
@@ -106,6 +112,12 @@
 - `POST /api/admin/workspaces/{workspace_id}/platform-api-keys/{key_id}/revoke`
 - `DELETE /api/admin/workspaces/{workspace_id}/platform-api-keys/{key_id}`
 
+Контракт:
+
+- `POST /platform-api-keys` возвращает metadata ключа и одноразовый `secret`;
+- `secret` доступен только в create-response;
+- list endpoints возвращают только metadata, `prefix`, `status`, `scopes` и `last_used_at`.
+
 ### 5.7. Observability
 
 - `GET /api/admin/workspaces/{workspace_id}/logs`

docs/data-model.md

@@ -170,7 +170,48 @@
 - `created_at`
 - `last_used_at`
 
-### 3.8. `InvocationLog`
+Секрет:
+
+- полный secret показывается только один раз при создании;
+- в persistent storage сохраняется только `secret_hash`.
+
+### 3.8. `User`
+
+Поля:
+
+- `id`
+- `email`
+- `display_name`
+- `status`
+- `created_at`
+
+### 3.9. `Membership`
+
+Поля:
+
+- `workspace_id`
+- `user_id`
+- `role`
+- `created_at`
+
+### 3.10. `InvitationToken`
+
+Поля:
+
+- `id`
+- `workspace_id`
+- `email`
+- `role`
+- `status`
+- `expires_at`
+- `created_at`
+
+Токен:
+
+- полный invite token показывается только один раз при создании;
+- в persistent storage сохраняется только `token_hash`.
+
+### 3.11. `InvocationLog`
 
 Продуктовая запись о вызове tool.
 
@@ -189,7 +230,7 @@
 - `response_preview`
 - `created_at`
 
-### 3.9. `UsageRollup`
+### 3.12. `UsageRollup`
 
 Агрегированная статистика по периоду.