diff --git a/docs/web-api/CONTRACT.md b/docs/web-api/CONTRACT.md index 5c44810..48ffffa 100644 --- a/docs/web-api/CONTRACT.md +++ b/docs/web-api/CONTRACT.md @@ -1,6 +1,6 @@ # Контракт веб-интерфейса Hermes Hub -Версия контракта: **1.0** +Версия контракта: **1.1** Дата: 2026-08-23 Этот документ — **единственный** источник истины для двух сторон: серверной (задание A15) и клиентской (A16). Обе стороны разрабатываются параллельно и до слияния друг друга не видят. @@ -111,6 +111,15 @@ test ``` Веб-клиент **обязан** проверять это поле и не показывать неработающую кнопку, а предлагать обходной путь. + +### `GET /` и статика + +**Сервер обязан отдавать сам интерфейс, а не только API.** Корневой маршрут возвращает `static/index.html`, каталог `static/` монтируется целиком. + +Пункт добавлен постфактум: в версии 1.0 контракт описал каталог `static/` в структуре пакета, но не назвал, **кто его отдаёт**. Обе стороны выполнили написанное — API отвечал, файлы клиента лежали в репозитории — и всё равно не собрались: в браузере был `404`. Ответственность за пропуск на авторе контракта, а не на исполнителях. + +Урок общего свойства: в контракте между двумя сторонами недостаточно описать, что каждая делает. Нужно назвать, **где именно они стыкуются** и кто отвечает за стык. + ## 5. Обновление данных Первая версия — **опрос**: клиент запрашивает `/api/snapshot` раз в 5 секунд и при действиях пользователя.