From 1fdc7be73347e78b57e6c9933bdc12c3c64639ab Mon Sep 17 00:00:00 2001 From: Dmitry Dementiev Date: Wed, 29 Jul 2026 21:49:47 +0300 Subject: [PATCH] =?UTF-8?q?docs(adr):=20=D0=B4=D0=BE=D0=BC=20=D1=80=D0=B0?= =?UTF-8?q?=D0=B7=D1=80=D0=B0=D0=B1=D0=BE=D1=82=D0=BA=D0=B8=20=E2=80=94=20?= =?UTF-8?q?Gitea,=20GitHub=20=E2=80=94=20=D0=BE=D0=B4=D0=BD=D0=BE=D1=81?= =?UTF-8?q?=D1=82=D0=BE=D1=80=D0=BE=D0=BD=D0=BD=D0=B5=D0=B5=20=D0=B7=D0=B5?= =?UTF-8?q?=D1=80=D0=BA=D0=B0=D0=BB=D0=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - вопрос о доме репозитория и трекера висел без решения после блокировки GitHub-аккаунта; своя площадка выигрывает по существу, а не только как вынужденная мера. - Что: - добавлен ADR-0007: активная разработка в Gitea, GitHub — публичное зеркало кода (push-mirror, направление одно). - зафиксировано, что issues не зеркалируются, а durable-часть (спеки, ADR, история коммитов) уезжает в зеркало вместе с кодом. - репозиторий v2 создаём сразу в Gitea. - Проверка: - чтением docs/adr/0007-gitea-as-development-home.md. --- docs/adr/0007-gitea-as-development-home.md | 45 ++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/adr/0007-gitea-as-development-home.md diff --git a/docs/adr/0007-gitea-as-development-home.md b/docs/adr/0007-gitea-as-development-home.md new file mode 100644 index 0000000..b198f08 --- /dev/null +++ b/docs/adr/0007-gitea-as-development-home.md @@ -0,0 +1,45 @@ +# ADR-0007: Дом разработки — свой Gitea, GitHub — зеркало + +Принято: 2026-07-29 +Статус: accepted + +## Решение + +Активную разработку — код, issues, PR, ревью — ведём в собственном Gitea +(`git.dementev.space`). Он остаётся домом независимо от того, чем закончится +история с блокировкой GitHub-аккаунта. GitHub держим как **публичное зеркало** +кода: туда уходит `main`, чтобы у менти и внешнего читателя была привычная +публичная ссылка. + +## Контекст + +Поводом стала блокировка аккаунта `dementev-dev` (2026-07-26): работа встала, +пока не подняли Gitea. Но решение принято не «назло» блокировке — своя площадка +выигрывает и по существу: + +- **Свой API — без лимитов.** Агентские скиллы (wayfinder, триаж, конвейер) + дёргают трекер интенсивно. На чужом хостинге это упирается в квоты, на своём — + нет. +- **Ещё одна резервная копия.** Репозиторий физически лежит на своём железе, а + не только у поставщика услуги. +- **Ролевые игры с менти.** Форк репозитория, ветка, PR, ревью, обсуждение в + issue — весь учебный цикл «как в настоящей команде» Gitea даёт целиком, и + удобнее GitLab. Заводить менти учебные аккаунты на своём хосте можно свободно. + +Против Gitea был один довод: публичность ссылок и привычность GitHub в резюме +менти. Зеркало его снимает. + +## Последствия + +- **Трекер один — Gitea.** Контракт уже переписан на `tea` + (`docs/agents/issue-tracker.md`). Зеркало на GitHub — только код; issues туда + не едут, и это не потеря: issue — вещь короткоживущая, а всё, что должно + пережить задачу, лежит в самом репозитории — спеки (`docs/specs/`), ADR и + история коммитов. Зеркало кода несёт эту часть целиком. +- **Зеркало настраиваем встроенным push-mirror Gitea**, направление одно: + Gitea → GitHub. Обратной синхронизации нет, чтобы не было двух источников + истины. Настройка отложена до разблокировки аккаунта. +- **Репозиторий v2** (кандидат имени `clickstream-data-platform`) создаём сразу + в Gitea, с тем же зеркалированием. +- В ADR-0001 GitHub Issues значится как отклонённый вариант — это запись своего + времени (тогда поток держали файлами в `.scratch/`), переписывать её не нужно.