From 4e2e8a978108bb5df24fa4cb93809e2a07309905 Mon Sep 17 00:00:00 2001 From: Hermes Team Date: Sun, 23 Aug 2026 20:40:57 +0700 Subject: [PATCH] =?UTF-8?q?docs(web):=20=D0=BA=D0=BE=D0=BD=D1=82=D1=80?= =?UTF-8?q?=D0=B0=D0=BA=D1=82=201.1=20=E2=80=94=20=D1=81=D0=B5=D1=80=D0=B2?= =?UTF-8?q?=D0=B5=D1=80=20=D0=BE=D1=82=D0=B4=D0=B0=D1=91=D1=82=20=D1=81?= =?UTF-8?q?=D1=82=D0=B0=D1=82=D0=B8=D0=BA=D1=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Пропуск версии 1.0: каталог static/ был описан в структуре пакета, но не сказано, кто его отдаёт. Обе стороны выполнили написанное и не собрались. Co-Authored-By: Claude Opus 5 --- docs/web-api/CONTRACT.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) 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 секунд и при действиях пользователя.