Алгоритм работы с GitHub

 

Как Системный Архитектор, я приветствую твое решение использовать Git. Без системы контроля версий (VCS) серьезная разработка невозможна. Это твоя «машина времени» и страховка от любых ошибок.

Вот профессиональный, но понятный алгоритм работы с Git (Git Workflow) для нашего проекта.

---

ЭТАП 0: Подготовка (Делается один раз)

Прежде чем писать код, мы должны «инициализировать» репозиторий и сказать Гиту, что игнорировать.

1. Открой терминал в папке твоего проекта (в VS Code: Ctrl + ~).

2. Инициализация: Создает скрытую папку .git, где будет храниться история.

   code Bash

    git init
  

Создание .gitignore: (Критически важно!). Мы не должны сохранять папку node_modules (она весит сотни мегабайт и скачивается автоматически) и файлы сборки.

Создай файл с именем .gitignore в корне проекта и вставь туда этот текст:

code Text

1.     node_modules/
   dist/
   build/
   .env
   .DS_Store
   src-tauri/target/
     

---

ЭТАП 1: «Золотой Цикл» (Твоя ежедневная рутина)

Это основной цикл, который ты будешь повторять 10-20 раз в день.

1. Проверка статуса
Перед тем как что-то делать, посмотри, какие файлы изменились.

code Bash

    git status
  

(Красным будут показаны измененные файлы).

2. Добавление изменений (Stage)
Ты говоришь Гиту: "Я хочу сохранить эти файлы в следующем снимке".

code Bash

    git add .
  

(Точка означает "все файлы". Если хочешь конкретный файл: git add src/App.tsx).

3. Фиксация изменений (Commit)
Ты делаешь "снимок" (Save Point). Обязательно пиши осмысленный комментарий в кавычках.

code Bash

    git commit -m "Добавил компонент анализа энтропии"
  

Совет: Пиши комментарии в повелительном наклонении (как приказ): "Fix bug", "Add feature", "Update styles".

---

ЭТАП 2: Работа с ветками (Уровень Профи)

Архитектурно правильно не работать в главной ветке (main или master). Главная ветка всегда должна быть рабочей (стабильной).

Алгоритм для новой фичи (например, добавляем Tauri):

1. Создать ветку и переключиться на неё:

   code Bash

    git checkout -b feature/add-tauri
  

(Теперь ты в параллельной вселенной. Все изменения здесь не ломают основной код).

Работать, кодить, коммитить:

code Bash

    git add .
git commit -m "Настроил конфигурацию tauri"
  

Возврат в главную ветку (когда закончил):

code Bash

    git checkout main
  

Слияние (Merge):
Забираем изменения из ветки фичи в главную.

code Bash

1.     git merge feature/add-tauri
     

---

ЭТАП 3: Синхронизация с Облаком (GitHub/GitLab)

Чтобы код не пропал, если сгорит жесткий диск, и чтобы я (или другой разработчик) мог его скачать.

1. Привязка (один раз):
Создай пустой репозиторий на GitHub. Он даст тебе ссылку (например, https://github.com/user/aegis-stream.git).

code Bash

    git remote add origin https://github.com/user/aegis-stream.git
  

2. Отправка кода (Push):
После коммитов отправляем их в облако.

code Bash

    git push -u origin main
  

3. Скачивание обновлений (Pull):
Если ты работал с ноутбука, а теперь сел за ПК.

code Bash

    git pull
  

---

Экстренные ситуации (Кнопки "Отмена")

1. Я наговнокодил, но еще не сделал commit:
   Вернуть файл к состоянию последнего коммита.

   code Bash

    git checkout -- src/App.tsx
  

(Осторожно, изменения пропадут безвозвратно!)

Я сделал commit, но понял, что это ошибка:
Отменить последний коммит, но оставить изменения в файлах (чтобы исправить).

code Bash

1.     git reset --soft HEAD~1
     

---

Твоя шпаргалка (Cheat Sheet)

Команда	Что делает на простом языке
git init	Создает новый проект Git здесь
git status	Что я поменял?
git add .	Подготовить всё к сохранению
git commit -m "text"	Сохранить (Сделать точку восстановления)
git push	Отправить в интернет (GitHub)
git pull	Скачать из интернета
git checkout -b name	Создать новую ветку (ответвление)
git checkout main	Вернуться в главную ветку
git merge name	Влить ветку name в текущую

Советую начать прямо сейчас: сделай git init, git add . и git commit -m "Initial commit v1.0". Это будет твоя первая точка опоры.