# Почта через Brevo (SMTP) v0.1 - 2026-11-16 Письма приложения (коды, сброс пароля) через SMTP-релей Brevo от адреса своего домена, например `noreply@example.com`. ## 1. Домен Brevo → **Senders, Domains & Dedicated IPs** → **Domains** → Add a domain. Brevo покажет записи для DNS: | Запись | Тип | Для чего | |---|---|---| | Brevo code | TXT на корне домена | что домен твой | | DKIM | два CNAME (`brevo1._domainkey`, `brevo2._domainkey`) или один TXT | подпись писем доменом | | DMARC | TXT на `_dmarc` | политика для получателей; для начала `v=DMARC1; p=none; rua=mailto:<почта для отчётов>` | Значения — только из своего кабинета. Записи добавить в DNS → **Authenticate this email domain**. Если DNS у поддерживаемого провайдера (например, Cloudflare), Brevo может добавить записи сам. - В Cloudflare у DKIM-записей — **DNS only** (серое облако), иначе подпись не проверяется. - DMARC-запись у домена должна быть **одна**: если уже есть — править её, а не добавлять вторую. - Записи не удалять, пока Brevo шлёт от домена. - Бесплатные ящики (`gmail.com` и т. п.) как домен отправителя не подтвердить. ## 2. Отправитель **Senders** → Add a sender: адрес на подтверждённом домене (`noreply@example.com`) и имя, которое увидит человек. ## 3. SMTP **Settings** → **SMTP & API** → вкладка SMTP → Generate a new SMTP key. | Переменная | Значение | |---|---| | `SMTP_HOST` | `smtp-relay.brevo.com` | | `SMTP_PORT` | `587` — STARTTLS; `465` — TLS сразу; `2525` — если 587 закрыт | | `SMTP_USER` | поле **Login** на этой странице — часто вида `@smtp-brevo.com`, **не** почта аккаунта | | `SMTP_PASS` | SMTP-ключ (не пароль аккаунта и не API-ключ) | | `MAIL_FROM` | `Имя ` — отправитель из шага 2, **не** SMTP-логин | Секреты — только в окружении сервера или `.env.local`. На зарезервированные домены (`.test`, `.invalid`, `.example`, `.localhost`) приложение не должно слать никогда — даже с настроенным SMTP: адреса из проверок и примеров не уходят в Brevo и не тратят лимит. ## Проверить Отправить письмо на Gmail → «Показать оригинал»: SPF, DKIM и DMARC — `PASS`, письмо не в спаме. У Brevo свой лимит писем в сутки (зависит от тарифа) — смотреть в кабинете. ## История - v0.1 — 2026-11-16: черновик. --- # Вход через Google v0.1 - 2026-11-16 Клиент OAuth в Google Cloud для кнопки «Войти через Google». Подходит для любой библиотеки авторизации, где вход идёт через сервер (обмен кодом на сервере). ## Завести клиента [Google Cloud Console](https://console.cloud.google.com/) → свой проект → **Google Auth Platform** (раньше — «APIs & Services → OAuth consent screen»): 1. **Branding** — название приложения, почта поддержки, свой домен в Authorized domains, ссылки на главную, политику конфиденциальности и условия (без них не опубликовать). 2. **Audience** — **External**. В статусе **Testing** войти могут только «Test users» (до 100). Для всех — **Publish app**. Области `openid email profile` не «чувствительные»: проверка Google не нужна (кроме проверки бренда, если загружен логотип). 3. **Clients** → Create client → **Web application**: - **Authorized redirect URIs** — адрес возврата твоей библиотеки, например `https://example.com/api/auth/callback/google`; - **Authorized JavaScript origins** — не нужны, если обмен кодом идёт на сервере. 4. Client ID и Client secret — в переменные окружения сервера. Секрет — не в git. Для разработки — **отдельный клиент** в Testing с `http://localhost:<порт>/…` в redirect URI и собой в Test users: так `localhost` не висит в боевом клиенте. ## Что брать у Google Достаточно почты и признака «почта подтверждена». Имя и фото можно не брать: меньше данных — меньше вопросов. `prompt: 'select_account'` — Google каждый раз спрашивает, каким аккаунтом войти; без него молча входит последним. ## Аккаунт с той же почтой уже есть Привязывать вход через Google к существующему аккаунту автоматически — **только для `gmail.com` и `googlemail.com`**: там ящик и Google-аккаунт — одно и то же. Google-аккаунт можно завести на любую чужую почту, и адрес мог давно перейти к другому человеку. Для остальных доменов — ошибка «войдите паролем и привяжите Google в настройках». ## История - v0.1 — 2026-11-16: черновик. --- # Капча Cloudflare Turnstile v0.1 - 2026-11-16 Проверка «не робот» перед формами, которые шлют письма или заводят записи: регистрация, «Забыл пароль?», «Отправить код ещё раз». Домену не обязательно быть в Cloudflare. ## Завести виджет Cloudflare → **Turnstile** → Add widget: - **Hostnames** — все домены, на страницах которых виджет будет рисоваться. Виджет на домене не из списка — «Invalid domain». - **Widget mode** — Managed: Cloudflare сам решает, показывать ли задачу. - **Site Key** — в браузер (публичный), **Secret Key** — только на сервер, не в git. Для staging — отдельный виджет или адрес стенда в Hostnames того же. ## Проверка на сервере Браузер получает от виджета токен и отправляет его с формой (в теле или заголовке). Сервер проверяет токен у Cloudflare: ``` POST https://challenges.cloudflare.com/turnstile/v0/siteverify secret=&response=<токен>&remoteip=<адрес посетителя> ``` - Смотреть `success`, а ещё **`action`**: у каждой формы своё (`signup`, `reset`), и токен от одной формы не подойдёт к другой. - Токен одноразовый и живёт несколько минут: на повтор формы — новый токен. - `remoteip` — настоящий адрес посетителя; за прокси — из заголовка, только если прокси свой и заменяет его. **Cloudflare не ответил** (сеть, сбой, таймаут) — решить заранее. Разумно пропустить запрос и записать в лог: чужой сбой не должен закрыть регистрацию, а от ботов остаются лимиты. ## Разработка и проверки - Ключи пустые — капчи нет: приложение работает без неё. - Посмотреть виджет при разработке — тестовые ключи Cloudflare, всегда проходят: Site Key `1x00000000000000000000AA`, Secret Key `1x0000000000000000000000000000000AA`. Ключи «всегда не проходит» и другие — в документации Turnstile, раздел Testing. - Автопроверки к Cloudflare не ходят: капчу включает тестовый переключатель, токен — заранее известная строка. ## История - v0.1 — 2026-11-16: черновик. --- # Eleventy и Astro: почему Astro v1.0 - 2026-11-16 ## Задача Для простых сайтов мне нужен генератор статических сайтов (SSG) из экосистемы JS. Я планирую пользоваться им ближайшие несколько лет — как инструментом из своего арсенала, на котором быстро собираю нужное и держу под рукой шаблоны и паттерны, которые охотно переиспользую. ## Eleventy или Astro Для своих задач я сузил выбор до Eleventy и Astro. - **Astro** казался перегруженным: компоненты, серверный режим и сборщик Vite в инструментах разработки. - **Eleventy** ставится одним пакетом и собирает HTML из шаблонов без обязательного бандлера. Сначала я выбрал Eleventy и сделал на нём 2–3 сайта — для себя и для пробы. Он меня устраивал. Потом, раз инструмент — на годы, я изучил подробнее, что стоит за каждым проектом. Положение на ноябрь 2026. ### Eleventy (11ty) Eleventy превращает шаблоны (Liquid, Nunjucks, Markdown, JS) в HTML. Его с 2017 года делает Zach Leatherman, лицензия MIT. В сентябре 2024 проект [присоединился к Font Awesome](https://www.11ty.dev/blog/eleventy-font-awesome/). В марте 2026 команда [объявила переименование](https://www.11ty.dev/blog/build-awesome/): Eleventy v4 станет Build Awesome v4. Рядом появится Build Awesome Pro — платный конструктор сайтов поверх бесплатного открытого SSG; команда обещает сохранить бесплатное ядро, совместимость плагинов и привычные команды сборки. Первую кампанию на Kickstarter [поставили на паузу](https://blog.fontawesome.com/pausing-kickstarter/) — официально из-за проблем с рассылкой, — а [повторная](https://www.kickstarter.com/projects/fontawesome/build-awesome-pro/description) прошла в апреле–мае. Сейчас стабильная [v3 выходит как Eleventy, а предварительная v4 — как Build Awesome](https://www.11ty.dev/docs/versions/). Часть пользователей встретила перемены [негативно](https://hamatti.org/posts/au-revoir-eleventy/). Крупные версии Eleventy выходят сравнительно редко. Исходный пакет Mozilla Nunjucks последний раз выходил в апреле 2023 (3.2.4), и команда Eleventy ведёт [собственный форк](https://github.com/11ty/nunjucks), который в v4 переработали под асинхронную обработку. По-моему, это усиливает зависимость от команды Eleventy — но форк живой. ### Astro Astro — фреймворк для сайтов с упором на контент: по умолчанию отдаёт статику, интегрируется с популярными UI-библиотеками и умеет серверный режим. Его с 2021 года делают Fred K. Schott и команда, лицензия MIT. В январе 2026 команда [перешла в Cloudflare](https://astro.build/blog/joining-cloudflare/) и пообещала сохранить открытый код, лицензию MIT, поддержку разных платформ размещения и открытое управление. Пример такой поддержки — экспериментальные CDN-кеши для Netlify, Vercel и Cloudflare в [Astro 7](https://astro.build/blog/astro-7/). Для документации у Astro есть готовая тема [Starlight](https://starlight.astro.build/) — на ней этот сайт, на Astro 7, с размещением на GitHub Pages. Крупные версии выходят чаще: v6 — в марте 2026, v7 — в июне, — поэтому обновления требуют внимания. Вместе с поддержкой Cloudflare приходит и риск влияния её интересов на развитие фреймворка. ## Итог — Astro Для своих следующих сайтов я выбираю Astro. Главная причина — Cloudflare: мне в целом импонирует эта компания, и, по-моему, бесплатный и открытый Astro в её же интересах — он приводит разработчиков к её платформе. Это моя оценка, а не обещание компании. Для меня сейчас важнее всего ясность, и у Astro её больше: понятно, кто за ним стоит и зачем ему оставаться открытым. Eleventy остаётся жизнеспособным вариантом для простых сайтов: переход к Build Awesome меняет бренд и продуктовую модель, а сам проект развивается. Но картина вокруг него пока складывается. Сборка Astro по-прежнему кажется мне сложнее, чем нужно простому сайту. Я принимаю эту сложность ради ясности и считаю это подходящим компромиссом на ближайшие годы. ## История - v1.0 — 2026-11-16: первая версия. --- # Мой стек Не стандарт, а то, на чём я пишу сейчас. Многие стандарты здесь выросли из этого стека — читать их стоит с этой поправкой. ## Стек - **Nuxt 4 + Nuxt UI 4 + Tailwind CSS 4**, сервер — Nitro внутри Nuxt. - **Drizzle + PostgreSQL.** При разработке и в проверках — PGlite как сетевой сервер на своём порту: одну папку PGlite не открыть двумя процессами. Он ведёт себя не во всём как PostgreSQL (параллельные транзакции не воспроизводятся), поэтому перед выкладкой я запускаю боевой образ с настоящим PostgreSQL. - **Playwright Test** — все проверки. - **Windows, PowerShell 7, Node 26**: скрипты `.ts` запускаю напрямую. ## Как я пишу - Быстро меняющиеся библиотеки (например, better-auth) — версия закреплена точно, без `^`; обновляю с прогоном всех проверок. - Интерфейс, документы и комментарии — по-русски; коммиты — по-английски (`feat:`, `fix:`, `docs:`). - Ошибки для человека — свои тексты; незнакомую ошибку библиотеки не показываю как есть. - База: snake_case, в коде camelCase; время — `timestamptz`; id — UUID от сервера; наружу — только публичный id. - Миграции генерирую по схеме и коммичу вместе с ней. - Запись, порядок которой важен другим (журнал событий), — под блокировкой в той же транзакции. - `server/utils` в Nuxt автоимпортируется — одно имя не экспортирую из двух файлов. - При старте разработки — короткая сводка в консоли: адреса, база, что включено. --- # Сборка и выкладка Стандарт jcb-deploy - v0.1 - 2026-11-16 ## Суть Приложение выкладывается образом контейнера и знает о сервере минимум: переменные окружения и проверка здоровья. Всё про конкретную машину (прокси, файрвол, ключи, адреса) — вне репозитория. ## Образ - Сборка и запуск — разные этапы: в образе запуска только результат сборки, процесс не от root. - В образ не попадают `.env`-файлы, базы, результаты проверок, `.git`. - Настройки — только окружение контейнера. ## Приложение само - **Применяет миграции при старте.** Применённые миграции не меняются. Несколько экземпляров — миграции под блокировкой. - **Отвечает на проверку здоровья** (`GET /_health`): 200 с версией и состоянием базы или 503, если база не отвечает. - **Фоновые задачи** — по расписанию внутри приложения; повторный запуск ничего не ломает. ## Ограничения записаны - **Сколько экземпляров можно**: один, если лимиты хранятся в памяти процесса. - **За прокси**: приложение доступно только через прокси, прокси заменяет `X-Forwarded-For`, а не дописывает. ## Обвязка - Приложение слушает только локальный адрес сервера, база наружу не открыта. - CI: проверки на каждый push; образ — на тег версии, в реестр. - Выкатить и откатить версию по тегу — одной командой. Резервная копия базы и восстановление — тоже. ## Перед выкладкой и после Записаны два списка: - **перед выкладкой**: проверки зелёные; боевой образ собран и запущен локально с настоящей базой; - **после выкладки руками**: здоровье, то, что проверками не покрыто (почта, вход через поставщиков, флаги cookie на https), закрытые страницы отвечают 404. ## Проверка - Образ собирается из чистого клона; в нём нет `.env`-файлов и `.git`. - Контейнер со всеми переменными стартует, `/_health` отвечает 200. - Списки «перед выкладкой» и «после выкладки» есть. ## История - v0.1 — 2026-11-16: черновик, из практики MoveTap. --- # jcb-deploy: приложение 1 На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту. ## Образ `Dockerfile` в два этапа: 1. сборка: `npm ci --ignore-scripts` → `npm run build`; 2. запуск: только `.output`, `USER node`, `node .output/server/index.mjs`. `.dockerignore` — `.env*`, `.nuxt*`, `.output*`, `.data/`, результаты Playwright, `.git`. Шрифты скачиваются при сборке — сборке нужен интернет. ## Миграции и здоровье - Миграции Drizzle лежат в репозитории, кладутся в сборку и применяются при старте. - `GET /_health` → `{ status: 'ok', version, db: 'ok' }` или 503. - Уборка — задача Nitro по расписанию; лимиты в памяти процесса, поэтому экземпляр один. ## Обвязка - `docker-compose.yml`: приложение на `127.0.0.1:<порт>`, PostgreSQL без публикации порта, тома, проверки здоровья, лимит размера логов. - CI — GitHub Actions: проверки на каждый push, образ на тег версии — в GHCR. - `deploy/update.sh` — выкатить или откатить версию по тегу. - Прокси, файрвол и адреса машины — в личной заметке вне git. ## Списки Лежат в `docs/deploy.md` проекта. После выкладки проверяю: - `GET /_health` — 200; - регистрация на настоящую почту — письмо пришло; - cookie сессии с `Secure; HttpOnly` и нужным `Domain`; - вход через Google, виджет капчи — если ключи заданы; - админка у обычного человека — «Нет доступа», документация API и `/_test/*` — 404. --- # Порты Стандарт jcb-devports - v1.0 - 2026-11-16 ## Суть У каждого проекта свой **блок из 10 портов** (`X0`–`X9`), и всё, что проекту нужно локально, живёт внутри блока: сайт, база, тестовые серверы. Проекты можно запускать одновременно (и их проверки тоже), и они никогда не мешают друг другу. В исключительных случаях проект занимает **два блока подряд** (20 портов, `X0`–`(X+1)9`), но не отдельные порты из разных мест: граница проекта всегда кратна 10. ## Раскладка внутри блока — рекомендация Проект раскладывает порты сам; если причин делать иначе нет, удобно так: | Смещение | Что | |---|---| | +0 | сайт при разработке | | +1 | база при разработке | | +2 / +3 | сайт и база автопроверок | | +4 … +9 | всё остальное: сквозные проверки, соседние сервисы для проверок, демо | Обязательно одно: раскладка записана в документации проекта, а значения — в его `.env`-файлах. ## Реестр блоков Какой блок за каким проектом — один список на все проекты. Новый проект берёт следующий свободный блок и дописывает себя в список. Список — **вне репозиториев**: ни один проект не знает о других. ## Правила - Порты — только из `.env`-файлов, не значения по умолчанию в коде. - Проверки никогда не трогают сайт и базу разработки: у них свои порты и своя пустая база. - В скриптах ходить на `127.0.0.1:<порт>`, а не на `localhost`. - Перед запуском сервера разработки проверить, не занят ли порт. - В контейнере сайт слушает свой порт (обычно 3000), а наружу его публикуют на порт из блока. ## Проверка - Все порты проекта в его `.env`-файлах лежат внутри его блока (или двух блоков подряд) из реестра. - В коде нет номеров портов. ## История - v1.0 — 2026-11-16: первая версия, из практики MoveTap. --- # jcb-devports: приложение 1 На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту. ## Где держать реестр блоков Отдельный файл в общей папке проектов (например, `PORTS.md`), а агенту — одна строка в его личных инструкциях о том, где этот файл. Личные инструкции Claude Code — `CLAUDE.md` в папке настроек: `$CLAUDE_CONFIG_DIR/CLAUDE.md`, а если переменная не задана — `~/.claude/CLAUDE.md`. Полный путь в общих документах не писать: он у каждого свой. Реестр удобно делить на области: например, семейство связанных сервисов берёт блоки из своего диапазона, остальные проекты — из другого. ## Почему `127.0.0.1`, а не `localhost` `localhost` может разрешиться сначала в IPv6 (`::1`), а сервер слушает только IPv4 — подключение ждёт или падает. Особенно заметно в скриптах проверок и в адресе базы. ## Почему проверять, свободен ли порт Сервер разработки Nuxt, найдя порт занятым, забирает его и гасит чужой процесс — а вместе с ним гаснет и база, которую тот процесс поднял. Проверить заранее (PowerShell): ```powershell Get-NetTCPConnection -LocalPort 4000 -State Listen -ErrorAction SilentlyContinue ``` sh: `lsof -iTCP:4000 -sTCP:LISTEN`. --- # Настройки только в .env-файлах Стандарт jcb-dotenv - v1.0 - 2026-11-16 ## Суть Всё, что отличается между окружениями (адреса, порты, база, секреты, переключатели), лежит в `.env`-файлах. В коде **нет значений по умолчанию** для этих настроек: всё берётся из окружения. Если обязательной переменной нет, сервер не запускается и пишет, какой именно. ## Файлы | Файл | В git | Режим | |---|---|---| | `.env.development` | да | разработка | | `.env.test` | да | автопроверки | | `.env.test.<вид>` | да | только если нужно: вид проверок со своими серверами (например, сквозные) | | `.env.local` | нет | личное поверх разработки: своя почта админа, ключи внешних служб, пароли | | `.env.production.example` | да | шаблон для сервера: все переменные, секреты без значений | На сервере файлов нет: переменные задаются окружению процесса или контейнера. ## Правила - **У всех файлов один набор переменных в одном порядке**, отличаются только значения. Ненужное в режиме — пусто. Новая переменная — сразу во все файлы. - **Переключатели — словами из короткого списка**: `on|off`, `log|smtp`, `open|admins`. Не `1`/`true`/`yes`. - **Переключатели задаются явно**: нет значения или оно не из списка — сервер не стартует и называет переменную. Код не угадывает режим. В шаблоне для сервера у переключателей стоят боевые значения (лимиты `on`, тестовые ручки `off`), секреты — пустые. - **Ключи внешней службы — не переключатель**: их наличие и есть настройка. Все пустые — функции нет, все заданы — есть; отдельного `on|off` не нужно. Задана только часть ключей службы — сервер не стартует и называет недостающие. - **Приоритет.** Разработка: окружение оболочки > `.env.local` > `.env.development`. Автопроверки: файл главнее оболочки, `.env.local` не читается — проверки не зависят от того, что задано у человека. - **Закоммиченные файлы — без боевых значений**: секреты вида `dev-secret-…`/`test-secret-…`, адреса `localhost` / `*.test`, база локальная. - **Правила продукта — в коде, а не в окружении**: сроки, лимиты, длины. Окружение — только то, что меняется между местами запуска. - **«test» — только автопроверки.** Живой стенд перед боевым сайтом называется «staging» и получает свой шаблон. - **Чтение — в одном модуле**: он проверяет значения при старте, остальной код берёт их оттуда, а не из `process.env` напрямую. - **Каждая переменная описана** в одном документе проекта — `docs/env.md`: что делает, какие значения бывают, что стоит в каждом файле. У каждой переменной свой заголовок вида `` ### `ИМЯ` `` (несколько связанных — в одном: `` ### `SMTP_HOST`, `SMTP_PORT` ``). Оформление внутри раздела — на усмотрение проекта. ## Проверка Автопроверка в проекте читает все файлы и требует: - одинаковый набор и порядок переменных во всех файлах; - каждая переменная, которую читает код, есть в файлах; - переключатели заданы во всех файлах и только из списка значений; - закоммиченные файлы без боевых значений; шаблон без секретов; в шаблоне тестовые ручки выключены, лимиты включены; - `.env.local` в `.gitignore`; - в `docs/env.md` у каждой переменной из файлов есть заголовок, и нет заголовков переменных, которых в файлах нет. ## История - v1.0 — 2026-11-16: первая версия, из практики MoveTap. --- # jcb-dotenv: приложение 1 На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту. ## Загрузка в Node - Node 20.6+ умеет сам: `process.loadEnvFile(path)` и `util.parseEnv(text)`. На старом Node — `dotenv`. Если фреймворк читает `.env` сам — им, но проверить, что он соблюдает нужный приоритет. - Приоритет при разработке «оболочка > `.env.local` > `.env.development`»: грузить сначала `.env.local`, потом `.env.development`, не перезаписывая то, что уже задано. - В автопроверках файл главнее оболочки: прочитать файл `util.parseEnv` и записать значения поверх `process.env`. ## `docs/env.md` Стандарт требует файл и заголовок `` ### `ИМЯ` `` на переменную. Внутри раздела удобно так: ```md ### `MAIL_DELIVERY` Куда идут письма. | Значение | Что значит | |---|---| | `log` | в лог сервера | | `smtp` | отправка по SMTP | | development | test | сайт | |---|---|---| | log | log | smtp | ``` Переменные — группами («Сервер», «База», «Почта»), в конце — «Что не в `.env` и почему». ## Значения - Адрес базы и своих серверов — `127.0.0.1`, а не `localhost`: `localhost` может уйти в IPv6. - Секрет: `openssl rand -base64 32`. В закоммиченных файлах — с говорящим префиксом (`dev-secret-only-for-…`), чтобы автопроверка отличала их от боевых. Смена секрета подписи cookie выкидывает всех из аккаунтов. - Публичный адрес приложения — как его видит браузер, без `/` в конце: от него зависят ссылки в письмах, адреса возврата OAuth и `Secure` у cookie. ## Переключатели - Тестовые возможности (ручки уборки, капча по заголовку, коды без интервала) — под одним `TEST_HOOKS=on|off`, выключенным в шаблоне сервера. - Встроенные лимиты библиотек (например, вход 3 раза за 10 с) мешают разработке и проверкам — свой переключатель; собственные лимиты продукта работают всегда. ## PGlite PostgreSQL как npm-пакет, данные в папке. Папка задана — `dev` и проверки поднимают базу сами; пусто — база отдельным сервером (сайт). У каждого режима своя папка: одну папку не открыть двумя PGlite. ## Что не в `.env` - **Правила продукта** — одинаковы везде: сроки, лимиты писем. - **Списки, которые проверяются вместе с кодом** (клиенты и их адреса) — в коде. - **Флаги сборки** — ставит скрипт сборки. --- # Внешние службы Стандарт jcb-external-services - v1.0 - 2026-11-16 ## Суть Чужая служба (почта, вход через поставщика, капча, платежи) не обязательна для запуска: без неё приложение работает без её функции, а проверки проходят без настоящей службы. ## Правила - **Нет службы — нет функции**, а не ошибка: нет кнопки входа через поставщика, нет капчи. Для обязательных служб записано, что без них не работает. - **Один модуль на службу**: прямых вызовов в обход нет. - **Решение на сбой записано**: пропустить запрос или отказать. - **Проверки проходят без настоящей службы.** - **Не ждать службу там, где время ответа выдаёт данные**: например, по времени ответа не должно быть видно, есть ли такой адрес. ## Проверка - Приложение стартует и проходит проверки, когда необязательные службы не настроены. - Поиск по коду: вызовы клиента службы — только в её модуле. - По каждой службе записано, что будет без неё и при её сбое. ## История - v1.0 — 2026-11-16: первая версия, из практики MoveTap. --- # jcb-external-services: приложение 1 На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту. ## Службы и модули | Служба | Модуль | Без неё | При сбое | |---|---|---|---| | почта (SMTP) | `sendMail` | обязательна: без неё регистрации нет | письмо не уходит, человеку не видно — строка в логе | | вход через Google | настройка библиотеки авторизации | кнопки нет | не работает только вход через Google | | капча Cloudflare Turnstile | `verifyHuman` | капчи нет | запрос пропускается, строка в логе: чужой сбой не закрывает регистрацию, от ботов остаются лимиты | ## Без настоящей службы - **Почта**: `MAIL_DELIVERY=log` — письмо в лог сервера; при разработке и в проверках ещё и в память, код читается тестовой ручкой `/_test/mail?to=<почта>`. - **Капча**: в проверках включается заголовком `x-test-captcha: 1`, верный токен — `test-pass`. Посмотреть живой виджет при разработке — тестовые ключи Cloudflare, которые всегда проходят. - **Google**: в проверках ключей нет — кнопки нет, логика привязки проверяется без Google. Для сценария входа — поддельный поставщик в тестовой сборке. ## Время ответа Письмо с кодом при регистрации и «Забыл пароль?» отправляется в фоне, ответ не ждёт SMTP: иначе по задержке видно, что адрес есть и письмо ушло. ## Почта На зарезервированные домены (`.test`, `.invalid`, `.example`, `.localhost`) `sendMail` не шлёт никогда, даже с настроенным SMTP. --- # Бэкап личного Стандарт jcb-git-private-backup - v0.1 - 2026-11-16 ## Суть У проекта две части: **публичная** — то, что хранит git проекта, и **личная** — то, что git проекта игнорирует, но что жалко потерять: заметки, планы, входные файлы, настоящие данные. Удалённая копия проекта бэкапит только публичную часть. Личная бэкапится отдельно, **своим репозиторием, зашифрованным целиком** до того, как уйти с машины. ## Личная часть - Вся личная часть проекта — в **одной папке `private/`** в корне. Git проекта её игнорирует. - `private/` — **отдельный git-репозиторий** со своей историей и своей удалённой копией. - Файлы личных настроек рядом с общими (`.env.local` и подобные) в бэкап не входят: секреты из них хранятся в менеджере паролей, а сам файл собирается заново. Если файл собрать заново нельзя — его место в `private/`. - В бэкап не входит то, что получается заново: зависимости, сборки, кэши, локальные базы разработки. ## Правила - **Удалённая копия хранит только шифротекст** — содержимое, имена файлов, сообщения коммитов. Шифрование — на машине, до отправки. Хостинг копии видит только размер и время. - **Ключ — в менеджере паролей и ещё в одном месте вне машины** (вторая машина, бумага). Бэкап без ключа равен потерянному бэкапу. - **Репозиторий бэкапа — приватный** у хостинга, вдобавок к шифрованию. Публичным он не бывает никогда. - **Хотя бы одна копия — вне машины.** Копия на том же диске защищает от ошибки, но не от потери машины. - **Регулярно**: не реже раза в неделю, автоматически, и вручную перед опасным: переписыванием истории, переустановкой системы, переездом на другую машину. - **Восстановление проверяется** раз в три месяца: клон в пустую папку на другой машине или в другой учётной записи, расшифровка, сравнение с оригиналом. - **Один проект — один репозиторий бэкапа**, имя — от имени проекта (`<проект>-private`). Так проекты восстанавливаются по одному и не мешают друг другу. ## Проверка Проект соответствует, если: - личное проекта лежит в `private/`, и git проекта её игнорирует; - `private/` — git-репозиторий, у его удалённой копии адрес с шифрованием, и в истории копии нет открытого текста; - последний успешный бэкап — не старше недели; - последняя проверка восстановления — не старше трёх месяцев, её дата и результат записаны. ## Спорное — обсудить - Где записывать дату проверки восстановления: в общем журнале бэкапов на машине или в каждом проекте. - Нужна ли вторая копия вне машины (у другого хостинга или на внешнем диске). ## История - v0.1 — 2026-11-16: черновик. --- # jcb-git-private-backup: приложение 1 На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту. ## Как было Zip-архивы `<проект>-<дата>.zip` в папке `backup/` рядом с проектами: вручную, без шифрования, на том же диске. Защищает от своей ошибки, но не от потери машины и не от того, кто получит доступ к диску. ## Шифрование: git-remote-gcrypt [git-remote-gcrypt](https://spwhitton.name/tech/code/git-remote-gcrypt/) — «удалённый адрес с шифрованием» для git: перед отправкой шифрует всё через GPG — содержимое, имена файлов, сообщения, ветки. На хостинге лежит один непрозрачный набор файлов. Работает поверх обычного SSH или HTTPS к GitHub/GitLab. Один раз на машину: ```sh gpg --quick-generate-key "backup " ed25519 sign,encr never gpg --list-secret-keys --keyid-format long # id ключа gpg --export-secret-keys --armor > backup-key.asc # → в менеджер паролей, файл удалить ``` `git-remote-gcrypt` — один shell-скрипт: положить в `PATH` (на Windows — рядом с `git.exe` Git Bash) или поставить пакетом в Linux. На Windows работу через Git Bash ещё нужно проверить. ## Новый проект ```sh cd <проект>/private git init git config user.name backup git config user.email backup@example.invalid git remote add origin gcrypt::git@github.com:<логин>/<проект>-private.git git config remote.origin.gcrypt-participants git add -A && git commit -m "backup" && git push -u origin main ``` Репозиторий `<проект>-private` на GitHub — создать заранее, пустым и **приватным**. Автор — заглушка: сообщения и авторы всё равно зашифрованы, но так в копии нет даже личного имени. ## Регулярный бэкап Скрипт обходит проекты и отправляет каждый `private/`, где есть изменения: ```sh #!/bin/sh # backup-private.sh <папка с проектами> find "$1" -maxdepth 3 -type d -path '*/private/.git' | while read -r git; do dir=$(dirname "$git") cd "$dir" || continue if [ -n "$(git status --porcelain)" ]; then git add -A && git commit -q -m "backup $(date +%F)" fi git push -q origin HEAD || echo "НЕ ОТПРАВЛЕН: $dir" >&2 cd - >/dev/null done ``` На Windows — Планировщик заданий, раз в день при входе в систему: ```powershell schtasks /create /tn "backup-private" /sc daily /st 21:00 ` /tr "\"C:\Program Files\Git\bin\bash.exe\" -lc '~/bin/backup-private.sh ~/projects'" ``` Сообщения в `private/` — «backup <дата>», а не по смыслу: это бэкап, а не история работы. ## Проверка восстановления ```sh mkdir /tmp/restore && cd /tmp/restore git clone gcrypt::git@github.com:<логин>/<проект>-private.git diff -r <проект>-private ~/projects/<проект>/private --exclude=.git ``` На второй машине — сначала `gpg --import backup-key.asc` из менеджера паролей: заодно проверяется, что ключ там действительно есть. ## Другой вариант: restic Если git-история для личного не нужна — [restic](https://restic.net/): шифрует всё, хранит снимки без повторов, пишет в папку, на SFTP, S3-совместимые хранилища. Один репозиторий restic на все `private/` сразу или по одному на проект. ```sh restic -r <хранилище> init # пароль → в менеджер паролей restic -r <хранилище> backup --files-from=private-dirs.txt # список папок private/ restic -r <хранилище> forget --keep-daily 7 --keep-weekly 8 --keep-monthly 12 --prune restic -r <хранилище> restore latest --target /tmp/restore ``` Стандарт ему тоже соответствует, кроме требования «`private/` — git-репозиторий»; если перейду на restic — поменяю стандарт. --- # Репозиторий готов к публикации Стандарт jcb-git-public-ready - v0.1 - 2026-11-16 ## Суть **Каждый коммит считается публичным.** Приватность репозитория — настройка хостинга, а не защита: репозиторий открывают, форкают, копируют в бэкапы и показывают помощникам. Поэтому история git в любой момент такова, что её можно выложить на GitHub, GitLab или куда угодно в открытом виде. Личное живёт отдельно: вне репозитория или в папке, которую git игнорирует на любой машине. Бэкап личного — своим путём, отдельно от публичной истории. ## Что считается личным | Вид | Примеры | |---|---| | Секреты | токены, ключи API, пароли, строки подключения, cookies, закрытые ключи и сертификаты | | Данные о людях | почта, телефон, адрес, настоящие имена и логины — свои и чужие | | Данные о машине | домашний путь (`C:\Users\<имя>\…`, `/home/<имя>/…`), имя компьютера, внутренние адреса, имена сетей | | Личное содержимое | дневник, заметки, финансы, здоровье, переписка, выгрузки чатов, закладки, профили | | Рабочее | названия и пути чужих (рабочих) проектов, данные клиентов | | Данные из работы программы | дампы и файлы баз, логи, бэкапы, выгрузки из служб | | Метаданные | почта автора коммита, EXIF в фотографиях, свойства документов | ## Где живёт личное 1. **Вне репозитория** — по умолчанию: менеджер паролей, окружение процесса, папка настроек пользователя. 2. **`private/` в корне репозитория** — всё личное, что удобно держать рядом с проектом: заметки, входные файлы, бэкапы, настоящие данные, планы. Одна папка на всё вместо россыпи имён в `.gitignore`. 3. **Файлы `*.local` и `*.local.*`** — личное поверх общего файла, рядом с ним: `.env.local`, `CLAUDE.local.md`, `.claude/settings.local.json`. `private/`, `*.local` и `*.local.*` git игнорирует **глобально** (`core.excludesFile`): так защищён любой репозиторий, даже новый и без своего `.gitignore`. В `.gitignore` проекта они продублированы — для другой машины и для того, кто склонирует репозиторий. ## Правила - **Автор коммитов — адрес-заглушка хостинга** (на GitHub — `+<логин>@users.noreply.github.com`), задан в конфиге репозитория. Глобально — `user.useConfigOnly=true`: без настройки в репозитории git просит её, а не подставляет имя машины. - **Код и данные — раздельно.** Программа, которая работает с личными данными (дневник, закладки, финансы), хранит в git код, схему и пример данных (`data.example/` или фикстуры), а настоящие данные — в `private/` или вне репозитория; путь к ним — настройка окружения. - **Примеры — заглушками**: почта `user@example.com`, домены `example.com` и `*.test`, адреса `192.0.2.x`, `198.51.100.x`, `203.0.113.x`, люди — вымышленные (`ivan.petrov`, `anna`), пути — относительные или через `~` / `$HOME`. - **Файлы помощников** (`CLAUDE.md`, `AGENTS.md` и подобные) — только общее для всех, кто открывает проект: пути относительные, без личного и рабочего. Личное — в `CLAUDE.local.md` или в настройках пользователя. - **Фотографии и документы — без метаданных**: EXIF и свойства очищены перед коммитом. - **Бэкап личного — отдельно от публичного репозитория**: архивом, отдельным приватным репозиторием или программой бэкапа. Шифрованные файлы в общей истории (git-crypt, SOPS) — вне этого стандарта: история вечная, и утёкший однажды ключ открывает её целиком. - **Две проверки перед каждым коммитом** (хук), обе — по тому, что уходит в коммит: - **сканер секретов**; - **личный стоп-лист** — строки, которые встречаться не должны: почта, телефон, имя, домашний путь, имя компьютера. Сам список лежит вне репозиториев, в настройках пользователя, и тоже никуда не попадает. - **У репозитория с удалённой копией — сканер секретов в CI** по каждому push: на случай, если хук обошли. ## Если личное уже попало в историю 1. **Секрет — сразу отозвать и выпустить новый.** Это главный шаг: копии истории уже могли разойтись. 2. Убрать из истории: переписать (замена строк, удаление файлов, замена авторов) или схлопнуть историю в один коммит. 3. Если репозиторий уже был снаружи — переписанную историю отправить с `--force`, старые ветки и теги удалить, о форках и кэшах помнить: они остаются. ## Проверка Репозиторий соответствует, если: - сканер секретов по **всей истории** (все ветки и теги) чистый; - ни одна строка из стоп-листа не встречается ни в одной версии файлов и ни в одном сообщении коммита; - у всех коммитов автор и коммиттер — адрес-заглушка хостинга; - `private/`, `*.local`, `*.local.*` в `.gitignore` проекта, и ни один такой путь не встречается в истории; - в истории нет файлов баз, дампов, логов, архивов бэкапов, закрытых ключей; - в `CLAUDE.md` и подобных нет абсолютных путей. Машина соответствует, если глобально заданы `user.useConfigOnly=true`, `core.excludesFile` с `private/`, `*.local`, `*.local.*` и хук с двумя проверками. ## История - v0.1 — 2026-11-16: черновик, по разбору своих репозиториев. --- # jcb-git-public-ready: приложение 1 На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту. ## Что нашлось в моих репозиториях Разбор перед первой версией — откуда взялись правила: - **Автор коммитов зависел от машины**: в историях встречались имя пользователя Windows, имя компьютера и личный ящик — в том числе в двух публичных репозиториях. Отсюда `user.useConfigOnly` и замена авторов перед публикацией. - **Личные данные лежали как данные проекта**: дневник (`data/entries.jsonl`) и профиль закладок (`src/data/profiles/personal.json`) — в git. Отсюда «код и данные — раздельно». - **В заметках для помощника** — абсолютный путь и название рабочего проекта. Отсюда правило о `CLAUDE.md`. - **В тестах — собственное имя** как пример логина. Отсюда заглушки. - **В `.gitignore` у каждого проекта свой набор**: `/notes/`, `/input/`, `/backups/`, `/note.txt`, `/certs/`. Отсюда одна папка `private/`. ## Настройка машины — один раз ```sh git config --global user.useConfigOnly true git config --global core.excludesFile ~/.config/git/ignore git config --global core.hooksPath ~/.config/git/hooks ``` `~/.config/git/ignore`: ```text private/ *.local *.local.* ``` `~/.config/git/denylist` — по строке на запись, сравнение без учёта регистра: ```text моя-почта@example.com +7 700 000 00 00 Имя Фамилия C:\Users\<имя> <имя-компьютера> ``` ## Новый репозиторий ```sh git init git config user.name <логин> git config user.email +<логин>@users.noreply.github.com # id и адрес — в настройках почты GitHub ``` В `.gitignore` проекта — те же три строки, что в глобальном. ## Хук перед коммитом `~/.config/git/hooks/pre-commit` — общий для всех репозиториев. Глобальный `core.hooksPath` заменяет `.git/hooks` репозитория, поэтому в конце хук передаёт управление хуку проекта, если он есть. ```sh #!/bin/sh # 1. Секреты в том, что уходит в коммит. gitleaks git --pre-commit --staged --redact --no-banner || exit 1 # 2. Личный стоп-лист: добавленные строки и имена файлов. list="$HOME/.config/git/denylist" if [ -s "$list" ]; then hits=$( { git diff --cached -U0 | grep '^+' ; git diff --cached --name-only ; } | grep -i -F -f "$list") if [ -n "$hits" ]; then echo "Стоп-лист: в коммите личное — исправь или убери из индекса." >&2 exit 1 fi fi # 3. Хук проекта. own="$(git rev-parse --git-dir)/hooks/pre-commit" [ -x "$own" ] && exec "$own" "$@" exit 0 ``` На Windows хук выполняет Git Bash, который ставится вместе с Git; `gitleaks` — `winget install gitleaks`. Найденное в выводе хук не печатает: так строка из стоп-листа не оседает в логах терминала. Сообщение коммита хук `pre-commit` не видит — его проверяет `commit-msg` так же, по стоп-листу. ## CI GitHub Actions, `.github/workflows/gitleaks.yml`: ```yaml name: gitleaks on: [push, pull_request] jobs: scan: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - uses: gitleaks/gitleaks-action@v2 env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} ``` Плюс в настройках репозитория: **Secret scanning** и **Push protection** — включены. ## Перед тем как открыть репозиторий ```sh gitleaks git --redact # вся история git log --all --format='%an <%ae>%n%cn <%ce>' | sort -u # все авторы и коммиттеры git log --all --name-only --format= | sort -u # все файлы, когда-либо бывшие в истории git grep -i -F -f ~/.config/git/denylist $(git rev-list --all) # стоп-лист по всем версиям git log --all --format=%B | grep -i -F -f ~/.config/git/denylist # стоп-лист по сообщениям ``` Список файлов — глазами: `private/`, `*.local*`, `.env` без суффикса шаблона, `*.sql`, `*.db`, `*.log`, `*.zip`, `*.pem`, `*.key`, папки `backups/`, `notes/`, `data/`. ## Убрать из истории Короткая история или прошлое не нужно — схлопнуть (так сделано у jcb-notes перед публикацией): ```sh git checkout --orphan clean && git add -A && git commit -m "chore: initial public version" git branch -D main && git branch -m main ``` Нужна история — `git filter-repo` (`pip install git-filter-repo`), на свежем клоне: ```sh git filter-repo --mailmap ../mailmap.txt # авторы: «Новое Старое » git filter-repo --replace-text ../replace.txt # строки: «старое==>заглушка» git filter-repo --invert-paths --path private/ --path data/entries.jsonl # файлы целиком ``` `mailmap.txt` и `replace.txt` — вне репозитория: в них то самое личное. ## Данные отдельно от кода На примере дневника: ```text journal/ data.example/ # в git: схема и пара вымышленных записей private/data/ # настоящие записи, игнорируется .env.development # JOURNAL_DATA=private/data ``` Тесты читают `data.example/`, программа — то, что в `JOURNAL_DATA`. ## Бэкап личного Архивы `<проект>-<дата>.zip` в отдельной папке бэкапов вне репозиториев: туда попадает `private/` и `*.local*` — то, чего в удалённой копии нет. Удалённая копия репозитория бэкапит только публичное. ## Фотографии `exiftool -all= -overwrite_original <файл>` — убрать EXIF; проверить: `exiftool <файл>`. --- # Ветки и версии Стандарт jcb-git-workflow - v1.0 - 2026-11-16 Две ветки: в **`dev`** идёт вся работа, в **`main`** — только версии. Версия — слияние `dev` в `main` с `--no-ff` и тегом. Так `main` читается как список выпусков, а вся работа видна внутри каждого слияния. ``` dev ──●──●──●──●──●──●──●──●──●── \ \ \ main ●───●v2026.001──●v2026.002──●v2026.003 ``` ## Номер версии `v<год>.<номер>`: год выпуска и номер по порядку в этом году, три цифры — `v2026.001`, `v2026.002`, … С нового года — снова с `001` (`v2027.001`). Номер ничего не говорит о размере изменений: это просто «какой по счёту выпуск». Всегда три цифры — чтобы при любом темпе теги сортировались как строки. Тег — аннотированный (`git tag -a`), сообщение слияния и тега — сам номер. Тег стоит **на коммите слияния в `main`**, не на коммите в `dev`: версия — ровно то, что попало в `main`, и тег без слияния не поставить. ## Обычная работа - Всё — в `dev`: коммиты, правки, эксперименты. В `main` напрямую не коммитить никогда. - Перед выпуском в `dev` всё должно быть зелёным: все проверки, какие есть в проекте (типы, линтер, тесты). ## Выпустить версию 1. В `dev` чисто, проверки прошли. 2. Номер: последний тег этого года + 1, или `001`, если тегов в этом году нет. 3. Слить и поставить тег: ```sh git switch main git merge --no-ff dev -m v2026.004 # всегда слияние, даже если можно было бы перемотать git tag -a v2026.004 -m v2026.004 git switch dev # работа продолжается в dev ``` С удалённым репозиторием — отправить обе ветки и тег: `git push origin main dev v2026.004`. `main` обратно в `dev` сливать не нужно: в `main` нет ничего, кроме слияний из `dev`, следующее слияние пройдёт без конфликтов. ## Исправление в выпущенной версии Отдельных веток для исправлений нет, срочных правок прямо в `main` — тоже: исправить в `dev`, проверить и сразу выпустить следующую версию. Откатить сайт — выложить предыдущий тег. ## Правила - В `main` — только слияния `--no-ff` из `dev` с тегом версии. Никаких прямых коммитов, перемотки и `rebase`. Исключение — первый коммит репозитория, от которого начинается `dev`. - Тег не переносить и не удалять после того, как он ушёл наружу (выложен или отправлен в удалённый репозиторий). - Выкладывается всегда тег, а не «последний `main`»: версия на сервере = тег. - Выпуск — только по просьбе человека; `push` — после отдельного подтверждения: это уходит наружу. ## Проверка Репозиторий соответствует, если: - `git log --first-parent main` — первый коммит и дальше только слияния (у каждого два родителя), второй родитель каждого — из `dev`; - на каждом слиянии в `main` ровно один тег, аннотированный, вида `v\d{4}\.\d{3}`, и тег совпадает с сообщением; - номера внутри года идут подряд с `001`, без пропусков и повторов. ## История - v1.0 — 2026-11-16: первая версия, из правил MoveTap; проверки проекта — словами, без конкретных команд. --- # jcb-git-workflow: приложение 1 На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту. ## Следующий номер версии PowerShell: ```powershell $y = (Get-Date).Year $last = git tag --list "v$y.*" | Sort-Object | Select-Object -Last 1 $n = if ($last) { [int]($last -replace "^v$y\.") + 1 } else { 1 } $v = "v$y.{0:D3}" -f $n ``` sh: ```sh y=$(date +%Y) last=$(git tag --list "v$y.*" | sort | tail -n 1) n=$(( ${last:+10#${last#v$y.}} + 1 )) v=$(printf 'v%s.%03d' "$y" "$n") ``` Сортировка строками работает, потому что номер всегда из трёх цифр. `10#` в sh — чтобы `008` не читалось как восьмеричное. ## Смотреть ```sh git log --first-parent --oneline main # только версии git log --oneline v2026.001..v2026.002 # что вошло в версию git diff v2026.001 v2026.002 --stat # что изменилось между версиями git describe main # последняя версия, если смотреть из dev ``` ## Новый репозиторий Первый коммит — в `main`, от него — `dev`; дальше в `main` только слияния: ```sh git init -b main git commit --allow-empty -m "Начало" # или первое содержимое git switch -c dev ``` ## Автор коммитов в публичном репозитории Почта автора видна в истории всем. Чтобы не светить настоящую — анонимная почта GitHub `+@users.noreply.github.com` (id — числовой, из профиля). Задать только для репозитория: ```sh git config user.name git config user.email +@users.noreply.github.com ``` --- # Автопроверки Стандарт jcb-testing - v0.1 - 2026-11-16 ## Суть Автопроверки идут против **production-сборки** приложения, на своих портах и со своей пустой базой. Одна команда проверяет всё и ничего не трогает у разработчика. ## Виды | Вид | Против чего | Что проверять | |---|---|---| | `server` | сборка по HTTP, без браузера | API, правила, права, безопасность | | `ui` | та же сборка, страницы в браузере | экраны и сценарии человека | | `e2e` | окружение «как на сайте»: несколько приложений, поддомены | то, что видно только вместе: общие cookie, CORS, переходы между сайтами | `e2e` — только если приложение работает вместе с другими; можно отдельной командой, если прогон долгий. ## Правила - **Тестовая сборка** — production-сборка в свои папки; пересобирается, только если исходники новее. - **Своё окружение**: серверы и сами проверки читают одни и те же настройки, не зависящие от разработчика. - **База** — пустая каждый прогон. - **У каждой проверки свои данные**: проверки идут параллельно на общей базе. - **Время не ждать**: сроки проверяются тестовой ручкой «как будто сейчас `now`», только на своих записях. - **Тестовые ручки** — под одним переключателем и одним путём (`/_test/*`). Ручки, отдающие секреты (коды из писем), — только вместе с этим переключателем или в режиме разработки. - **После изменений** — типы, линтер, проверки. Новое поведение — проверка в `server`, страница — в `ui`, то, что видят соседние сайты, — в `e2e`. - **Экраны** — и на ширине телефона, без горизонтальной прокрутки. Ошибка в консоли браузера — провал проверки. - **Что не покрыто** — записано таблицей «что и как проверить руками»; пройти перед выкладкой. ## Проверка - Одна команда запускает все виды и проходит на чистой машине без настроек разработчика. - Отдельная проверка: в production-сборке без тестового переключателя `/_test/*` отвечают 404. - Таблица «что проверить руками» есть. ## История - v0.1 — 2026-11-16: черновик, из практики MoveTap. --- # jcb-testing: приложение 1 На моих примерах: как я выполняю этот стандарт в своих проектах и на своих технологиях. Не требование — соответствие проверяется только по стандарту. ## Инструменты - **Playwright Test**, виды — проекты Playwright: `server`, `ui`, `e2e`. - Тестовая сборка Nuxt — в `.nuxt-test` и `.output-test`; скрипт запуска пересобирает её, только если исходники новее. - Настройки — `.env.test` и `.env.test.e2e`: по ним запускаются серверы, их же читают проверки. - База — PGlite, своя папка на вид проверок, каждый прогон с нуля. ## Поддомены без файла hosts Chromium направляет `*.<проект>.test` на эту машину флагом `--host-resolver-rules` в `playwright.config.ts`. Приложение выдаёт cookie на `.<проект>.test` — как на боевом домене. ## Данные и время - Метка (`stamp()`) в почте и логине — у каждой проверки свои записи. - `POST /_test/cleanup { now, … }` — уборка «как будто сейчас `now`» только для своих записей. - У каждого «браузера» свой адрес в `X-Forwarded-For` — лимиты по адресу не срабатывают на всех сразу. ## Тестовые ручки Все — при `TEST_HOOKS=on`: `/_test/mail?to=<почта>` (коды из писем), `/_test/cleanup`, капча по заголовку `x-test-captcha: 1` с токеном `test-pass`. Встроенные лимиты библиотеки входа в проверках выключены, свои лимиты работают. ## Экраны Ширина телефона — 375 px. Помощники: `watchConsole` (ошибка консоли — провал), `expectNoHorizontalScroll`. ## Что проверяю руками Вход через Google, живой виджет Turnstile (тестовые ключи), настоящая почта, `Secure`-cookie на https, лимиты библиотеки входа (включены только в production), уборка по расписанию.