Files

T

mayatnikovandClaude Opus 5 383e374f0f iOS: запрет масштабирования, версия в подвале, самообновление, строка ввода

Отзыв с iPhone после первого живого прогона.

Масштабирование запрещено (ADR-066): viewport как в соседнем sixlines плюс
viewport-fit=cover, мета-теги установленного приложения, touch-action против
двойного тапа и страховка на JS — гашение жестов iOS, потому что мета-строку
Safari вправе проигнорировать. Размеры шрифтов не тронуты: 14 px из брифа
остаются, поднимать поля до 16 px владелец отклонил. Цена — доступность
для тех, кому зум нужен — записана в ADR и в ui.md честно.

Версия в подвале (ADR-065, 067): GET /api/config отдаёт короткую ревизию
и время коммита. Именно коммита, а не сборки: штамп компиляции в бинаре
means каждая пересборка даёт новый хеш, и обещание ADR-022 «бинарь собирается
из тега байт в байт» перестаёт проверяться.

Самообновление PWA (ADR-068, 070): в режиме приложения на iPhone перезагрузки
нет, и старая версия жила бы вечно. Проверка при возврате в приложение,
включение ждущей оболочки, перезагрузка — но не тогда, когда в строке набран
текст. Замок от петли сравнивает версию оболочки, а не считает перезагрузки:
счётчик отменял саму фичу, долгоживущая вкладка переставала обновляться.
Замерено: было 30, 60, 120, 240 секунд между релизами, стало ровно 30.

Строка ввода — редактируемый блок (ADR-069): iOS рисует над клавиатурой
полосу со стрелками и «готово» для полей формы, и убрать её со страницы
нельзя. Для contenteditable не рисует. Режим plaintext-only с проверкой,
что он применился, и запасным путём с разбором вставки: невалидное значение
атрибута в части браузеров делает блок нередактируемым вовсе. Чтение
и запись только через textContent, innerHTML в клиенте по-прежнему нет.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015DbCjVfTFq4ZFG8juD45YJ

2026-08-23 15:11:13 +03:00

4.4 KiB

Raw Blame History

ADR-065: Версия — короткая ревизия, «время сборки» — время коммита

Уточняет ADR-022 (подлинность бинаря проверяется сверкой хеша со сборкой из тега) и ADR-057 (+dirty у сборки из изменённого дерева).

Доведён до интерфейса ADR-067: версия и время коммита стоят в подвале сайдбара.

Контекст

Интерфейс должен называть версию, которая сейчас работает: иначе разговор о поломке начинается с угадывания, обновилось ли то, что человек видит.

Ревизия у сервера уже есть — revision() в cmd/bare читает vcs.revision и vcs.modified (ADR-057), — но живёт в main и снаружи недоступна. internal/api до неё не дотягивается.

Второй вопрос — «время сборки». Естественный ответ, штамп момента компиляции через -ldflags -X, ломает ADR-022: артефакт деплоя — один файл, и его подлинность проверяется тем, что сборка из тега даёт тот же хеш. Со временем компиляции внутри каждая пересборка одного и того же коммита даёт другой файл, и сверка перестаёт что-либо значить. Рядом с ревизией лежит vcs.time — время коммита, приходящее из git вместе с ней. Оно воспроизводимо и отвечает на настоящий вопрос: какой код работает, а не когда его компилировали.

Решение

Чтение build info переезжает в internal/build: полная ревизия, признак изменённого дерева, время коммита. cmd/bare и internal/api берут версию оттуда — двух форматов у одной величины не заводится.
Версия — семь символов ревизии. У сборки из изменённого дерева к ним дописывается +dirty (ADR-057), без ревизии вовсе — unknown.
«Время сборки» — это vcs.time, время коммита. Штампа момента компиляции в бинаре нет и не появится.
GET /api/config отдаёт version (строка) и commitAt (миллисекунды Unix, 0 если времени нет). Отдельного /api/version нет: конфигурацию клиент читает до входа и так, а второй эндпоинт ради двух полей — лишний маршрут. В других ответах версии тоже нет.
bare version печатает то же самое: короткую ревизию и время коммита в UTC одной строкой.

Следствия

Сверка «хеш файла на сервере против сборки из тега» остаётся проверяемой: в бинаре не осталось ничего, что менялось бы от пересборки.
bare version больше не печатает полный хеш. Семи символов хватает и человеку, и git show; docs/deploy.md говорит то же.
Время в интерфейсе отстаёт от момента деплоя ровно настолько, насколько деплой отстал от коммита. Это и спрашивают.
Сборка не из git — go run, go build -buildvcs=false, тестовый бинарь — показывает unknown и 0. Тесты видят именно её: vcs.* тестовому бинарю не проставляются, и это состояние проверяется ими прямо.
Клиенту остаётся показать два поля; где именно и какими словами — docs/ui.md.

4.4 KiB Raw Blame History

ADR-065: Версия — короткая ревизия, «время сборки» — время коммита

Контекст

Решение

Следствия

4.4 KiB

Raw Blame History