Files
ct-forms-portal/docs/PROCESS.md
Тимур Городецкий 58a6e13f36 docs: ветки — только для долгих, зависимых и рискованных задач
Один разработчик без ревью: ветка нужна не всегда, а когда защищает main от
полуготового кода. Мелкие фиксы — прямо в main.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-27 10:47:00 +05:00

2.9 KiB
Raw Permalink Blame History

Как ведётся работа над порталом

Проект ведёт один разработчик. Требования приходят из Teams-чата и устно, поэтому вся история — что просили, что решили, что выехало — хранится здесь и в Gitea, а не в памяти.

Где что лежит

Что Где Отвечает на вопрос
Задачи Gitea Issues ct-forms-portal Что надо сделать, кто и когда попросил
Решения docs/adr/ Почему сделано именно так, какие были варианты
Изменения CHANGELOG.md Что и в какой версии выехало на прод
Код коммиты с (#номер) Каким кодом закрыта задача

Путь запроса

  1. Пришло сообщение (чат, устно) — каждый пункт становится issue. В issue — цитата или скрин как есть, дата, кто попросил.
  2. Разбор. Метка по типу: bug, ux, feature, perf, справочники, вопрос-бизнесу, смена-модели.
    • Если пункт меняет устройство данных (смена-модели) — сначала ADR, потом код.
    • Если нужен ответ бизнеса (вопрос-бизнесу) — вопрос в чат, issue ждёт ответа.
  3. Работа. Баг — сначала падающий Jest-тест, потом фикс. Коммиты — тип: описание (#номер).
    • Мелкий фикс (час-два, один-два коммита) — прямо в main.
    • Ветка feat/<номер>-кратко или fix/<номер>-кратко — если задача на несколько дней, зависит от внешнего (новые списки SP, потоки, бэкенд) или рискованная. Цель одна: main в любой момент можно выкатить на прод.
  4. Деплой. Запись в CHANGELOG.md, тег версии vX.Y.Z (= версия в config/package-solution.json), issue закрывается, в чат — короткий список изменений.

Вопрос, который задаём каждому новому пункту

Это меняет то, как устроены данные, или только как они показываются?

Только показ или поведение — делаем. Меняет данные — сначала проходим весь путь: где создаётся, кто видит, что уходит в отчёт, INCORE и согласование. Потом ADR.