Git Workflow: как выбрать модель ветвления для команды

# Один trunk, все коммитят напрямую
# Для маленьких команд или при переходе с SVN

git switch main
git pull --rebase origin main
git commit -am "Add feature"
git push origin main

# Основа большинства workflow
# Каждая задача — своя ветка

git switch -c feature/user-profile
# ... разработка ...
git push origin feature/user-profile
# → Pull Request → Review → Merge

# main всегда deployable
# Feature ветки от main, PR для review

git switch -c feature/dark-mode
git push origin feature/dark-mode
gh pr create
# CI/CD деплоит после merge в main

# Структурированные релизы
# main + develop + feature/release/hotfix

git flow feature start user-auth
# ... разработка ...
git flow feature finish user-auth
git flow release start 1.2.0
git flow release finish 1.2.0

# Коммиты в main несколько раз в день
# Feature flags для незавершённого кода

git switch main
git commit -am "feat: add search (behind flag)"
git push origin main
# CI/CD сразу тестирует и деплоит

# .github/workflows/ci.yml (GitHub Actions)
on:
  pull_request:
  push:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: npm test
      - run: npm run lint

# GitHub Actions: автодеплой при merge в main
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to production
        run: ./deploy.sh production

# Автоматическое удаление веток при merge
# GitHub Settings → Delete branch on merge

# Commitlint для стандарта коммитов
npm install -D @commitlint/cli @commitlint/config-conventional
echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js

# 1. Создать feature ветку от main
git switch main
git pull --rebase origin main
git switch -c feature/user-authentication

# 2. Разрабатывать на своей ветке
git add src/auth.js
git commit -m "feat: implement login form"
git add tests/auth.test.js
git commit -m "test: add authentication tests"

# 3. Отправить на GitHub
git push origin feature/user-authentication

# 4. Создать Pull Request на GitHub
# GitHub UI: Compare & pull request

# 5. Code Review — товарищи смотрят код
# - Обсуждение в комментариях PR
# - Запросы на изменения (Request Changes)
# - Утверждение (Approve)

# 6. После утверждения — merge в main
# GitHub UI: Merge pull request

# 7. После merge удалить feature ветку
git switch main
git pull origin main
git branch -d feature/user-authentication
git push origin --delete feature/user-authentication

# 8. Все остальные обновляют main
git switch main
git pull origin main

# Инициализировать gitflow
git flow init
# Вопросы про имена веток — можно оставить по умолчанию

# Начать feature
git flow feature start user-profile
# Создаст ветку feature/user-profile от develop

# Разработка
git add src/profile.js
git commit -m "feat: user profile page"
git push origin feature/user-profile

# Закончить feature
git flow feature finish user-profile
# Merge в develop и удаление feature ветки

# Подготовка к релизу (когда features готовы)
git flow release start 1.2.0
# Создаст ветку release/1.2.0 от develop

# Финальные правки в release ветке
echo "1.2.0" > version.txt
git commit -am "bump: version 1.2.0"

# Закончить release
git flow release finish 1.2.0
# Merge в main + develop, создаст тег 1.2.0

# Критический баг в production — hotfix
git flow hotfix start 1.2.1
# Создаст ветку hotfix/1.2.1 от main

# Исправить баг
git add src/bug.js
git commit -m "fix: critical security issue"

# Закончить hotfix
git flow hotfix finish 1.2.1
# Merge в main и develop

# Вместо long-lived feature веток — краткосрочные ветки
# Коммиты в main несколько раз в день

# Для незавершённого функционала — feature flags
// src/features.js
const FEATURES = {
  newDashboard: process.env.FEATURE_NEW_DASHBOARD === 'true',
  betaSearch: process.env.FEATURE_BETA_SEARCH === 'true',
}

// src/dashboard.js
import { FEATURES } from './features'

export function Dashboard() {
  if (FEATURES.newDashboard) {
    return <NewDashboard />
  }
  return <OldDashboard />
}

# Сам код в main, но можно отключить

# Рабочий процесс:
git switch -c feature/new-dashboard  # краткоживущая ветка
# ... разработка ...
git commit -m "feat: new dashboard behind flag"
git push origin feature/new-dashboard
# PR и merge в main

# После merge и deploy флаг включается постепенно:
FEATURE_NEW_DASHBOARD=true git push  # плавное включение для % пользователей

# На GitHub: нажать Fork (создаёт копию под вашим аккаунтом)

# Клонировать свой форк
git clone https://github.com/YOUR_USERNAME/project.git
cd project

# Добавить upstream (исходный репозиторий)
git remote add upstream https://github.com/ORIGINAL_OWNER/project.git

# Создать feature ветку
git switch -c feature/fix-typo

# Разработка и коммиты
git commit -am "fix: typo in README"

# Отправить в ваш форк
git push origin feature/fix-typo

# На GitHub: нажать "Create Pull Request"
# PR будет отправлен в исходный репозиторий

# Синхронизация с upstream если долго разрабатываете
git fetch upstream
git rebase upstream/main

git push -f origin feature/fix-typo

# Структура
project/
  ├─ apps/
  │  ├─ web/
  │  ├─ mobile/
  │  └─ api/
  └─ packages/
     └─ shared-utils/

# Feature ветки могут затрагивать несколько приложений
git switch -c feature/api-v2-and-web-update

# Коммиты касаются разных частей
git add apps/api/v2/handler.js
git commit -m "feat(api): implement v2 endpoint"

git add apps/web/src/fetch.js
git commit -m "feat(web): consume v2 API"

git add packages/shared-utils/request.js
git commit -m "feat(shared): add v2 request helper"

# Один PR но несколько изменений
# CI/CD обычно тестирует все затронутые приложения