Перейти к содержимому

Репозиторий готов к публикации

Стандарт jcb-git-public-ready - v0.1 - 2026-11-16Скачать .md

Каждый коммит считается публичным. Приватность репозитория — настройка хостинга, а не защита: репозиторий открывают, форкают, копируют в бэкапы и показывают помощникам. Поэтому история 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 — <id>+<логин>@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-NOTESv2026.006Исходники на GitHubCC BY 4.0llms.txt