mayatnikovandClaude Opus 5
383e374f0f
Отзыв с 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
3.0 KiB
3.0 KiB
ADR-022: Деплой — nginx, systemd, кросс-сборка
Уточнён ADR-032 (StateDirectoryMode и UMask в юните), ADR-056 (access_log off), ADR-057 (bare version помечает сборку из изменённого дерева) и ADR-065 (версия и время коммита в GET /api/config, времени компиляции в бинаре нет).
Контекст
Целевой сервер (ssh xmatic, Ubuntu 22.04) уже держит nginx на 80/443 с десятком сайтов и certbot. Go на сервере нет. HTTPS обязателен (ADR-002), но TLS в самом бинаре означал бы либо autocert — четвёртую зависимость, — либо конфликт за 443 с nginx.
Решение
- TLS терминирует nginx. Bare слушает
127.0.0.1:8411(порт свободен; 8090 занят PocketBase). Сертификат — certbot дляbare.xmatic.team, как у остальных сайтов на машине. - nginx проксирует всё на бинарь; для
/api/events—proxy_buffering off,proxy_read_timeout 1h, HTTP/1.1 к апстриму. Сервер дополнительно шлётX-Accel-Buffering: no. Конфиг —docs/deploy.md. - Бинарь под systemd: пользователь
bare,/opt/bare/bare, база в/var/lib/bare/bare.db, секреты в/etc/bare/env(режим 0600). Юнит сProtectSystem=strict,ProtectHome=yes,NoNewPrivileges=yes. - Конфигурация — переменные окружения с префиксом
BARE_:ADDR,DB,ORIGIN,VAPID_PUBLIC,VAPID_PRIVATE,VAPID_SUBJECT,INVITE_CODE. Подкомандаbare vapidгенерирует пару ключей. Подкомандаbare serveзапускает сервер. - Клиентская статика встроена в бинарь через
embed: артефакт деплоя — ровно один файл, и обещание ADR-001 «код в продакшене байт в байт совпадает с репозиторием» проверяется сравнением с тегом. - Сборка локально:
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build. Деплой —scripts/deploy.sh: сборка,scp,install,systemctl restart. Без контейнеров.
Следствия
- Проверка подлинности клиента сводится к проверке бинаря: хеш файла на сервере против сборки из тега.
- Зависимость от чужого nginx на той же машине — осознанная: он уже там и уже умеет сертификаты.
- Статику отдаёт Go, не nginx: заголовки безопасности и ETag в одном месте.