# JCB-NOTES

Общие правила и знания для своих проектов, не привязанные к одному проекту.

| Раздел | Что | Как меняется | Как на него ссылаются |
|---|---|---|---|
| Стандарты | правила: «так делаем», проверяемо — соответствует / не соответствует | редко, с версией и записью в «Истории» | по имени и версии: «jcb-git-workflow v1.0» |
| Приложение 1 к стандарту | как я выполняю стандарт на своих примерах и технологиях; ничего не требует | свободно, без версии | не ссылаются: читают, когда нужно |
| Гайды | как сделать конкретное дело, по шагам: подключить службу, настроить инструмент, пройти процедуру | по мере того, как меняется то, о чём гайд | не ссылаются |

Документ — **стандарт**, если по нему можно сказать «проект соответствует / не соответствует». Ответ на «почему» или
«как» — **приложение**: у каждого стандарта своё «Приложение 1» на моих примерах.

## Стандарты

| Код | Документ | Версия | О чём |
|---|---|---|---|
| jcb-git-workflow | [Ветки и версии](standards/git-workflow/) | v1.0 | `dev` / `main`, слияния `--no-ff`, версии `v<год>.<номер>` |
| jcb-git-public-ready | [Репозиторий готов к публикации](standards/git-public-ready/) | v0.1 | личное — в `private/` и `*.local*`, стоп-лист и сканер секретов перед коммитом |
| jcb-git-private-backup | [Бэкап личного](standards/git-private-backup/) | v0.1 | `private/` — свой репозиторий, зашифрованный целиком, копия вне машины, проверка восстановления |
| jcb-dotenv | [Настройки только в .env-файлах](standards/dotenv/) | v1.0 | один набор переменных во всех файлах, переключатели явно |
| jcb-devports | [Порты](standards/devports/) | v1.0 | блок из 10 портов на проект, реестр вне репозиториев |
| jcb-external-services | [Внешние службы](standards/external-services/) | v1.0 | без службы — без функции, модуль на службу, решение на сбой |
| jcb-testing | [Автопроверки](standards/testing/) | v0.1 | против production-сборки, виды `server` / `ui` / `e2e`, тестовые ручки |
| jcb-deploy | [Сборка и выкладка](standards/deploy/) | v0.1 | образ, миграции при старте, `/_health`, списки до и после выкладки |

Версия — `v<старший>.<младший>`: правило поменялось по сути (проект может перестать соответствовать) — старший
номер (`v2.0`); добавилось или уточнилось, не ломая соответствия, — младший (`v1.1`). `v0.x` — черновик: может меняться как угодно, без новой старшей версии.

Проект, который следует стандартам, перечисляет их с версиями в своём `CLAUDE.md` (или README):
`jcb-git-workflow v1.0`, `jcb-dotenv v1.0`.

## Для Claude

Чтобы Claude в проекте знал стандарты, добавь в `CLAUDE.md` проекта одну строку — принятые стандарты с версиями и
оглавление:

```md
Стандарты: jcb-git-workflow v1.0, jcb-dotenv v1.0 — https://justcatboy.github.io/jcb-notes/llms.txt
```

| Файл | Что |
|---|---|
| [llms.txt](llms.txt) | оглавление: как пользоваться и ссылки на `.md` всех документов |
| [standards.json](standards.json) | стандарты с текущими версиями и ссылками на все версии |
| [llms-full.txt](llms-full.txt) | весь сайт одним файлом |

Текст принятой версии не меняется: `standards/<имя>/<версия>.md`, например
[standards/dotenv/v1.0.md](standards/dotenv/v1.0.md). Версия в шапке стандарта ведёт туда же.

## Гайды

Как сделать конкретное дело: по шагам.

| Гайд | Версия | О чём |
|---|---|---|
| [Google OAuth](guides/google-oauth/) | v0.1 | клиент OAuth, Testing и публикация, привязка к аккаунту с той же почтой |
| [Brevo](guides/brevo/) | v0.1 | почта по SMTP: домен (DKIM, DMARC), отправитель, SMTP-ключ |
| [Cloudflare Turnstile](guides/turnstile/) | v0.1 | виджет, проверка токена на сервере, тестовые ключи |

## Notes

| Документ | О чём |
|---|---|
| [Мой стек](notes/stack/) | на чём я пишу сейчас; многие стандарты выросли из него — Nuxt, PostgreSQL, Playwright |
| [Eleventy и Astro](notes/eleventy-vs-astro/) | почему этот сайт на Astro: кто стоит за каждым, как часто меняются, перспективы |
