From a93997b0bb5eaad26601420ada39e41e54441feb Mon Sep 17 00:00:00 2001
From: Aleksey Sabilin <aleksey@sabilin.com>
Date: Wed, 29 Jul 2026 23:16:47 +0300
Subject: [PATCH] docs: document calendar.settings org defaults

Cross-link EventHubBack#63 and EventHubFront#44 for known keys,
unknown passthrough, and 400 invalid_settings.
---
 EventHubBackSpec.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/EventHubBackSpec.md b/EventHubBackSpec.md
index 7750414..242344c 100644
--- a/EventHubBackSpec.md
+++ b/EventHubBackSpec.md
@@ -29,7 +29,15 @@ EventHub — платформа для управления событиями 
 - `category` — категория (enum)
 - `color` — цвет отображения
 - `image_url` — изображение календаря
-- `settings` — дополнительные настройки (map)
+- `settings` — дополнительные настройки (map). Известные org-default ключи
+  (валидируются на PUT/PATCH; неизвестные ключи — passthrough, напр. `week_patterns`):
+  - `default_location` — `{ "address": "…", "lat"?: number, "lon"?: number }`;
+    `address` — непустая строка; `lat`/`lon` — оба или ни одного (числа)
+  - `default_duration_minutes` — integer 1..1440
+  - `default_recurrence` — `null` или
+    `{ "enabled": boolean, "freq": "DAILY"|"WEEKLY"|"MONTHLY", "interval": integer ≥ 1 }`
+  - Невалидное значение известного ключа → **400** `{error: "invalid_settings", key: "…"}`
+    (см. EventHub/EventHubBack#63, UI: EventHub/EventHubFront#44)
 
 ### 2.1.1. Специалисты календаря
 Таблица `calendar_specialist`: связь пользователя-специалиста с **commercial**-календарём.