# Инструкция по commit и push в Git ## Репозиторий Работать с Git нужно из корня репозитория `SHiNE-product/`: ```bash cd /home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-product ``` ## Канонический Gitea Всегда использовать этот Git-сервер и этот remote: ```text https://git.shineup.me/Aidar/SHiNE-server.git ``` Проверка и исправление `origin`: ```bash git remote set-url origin https://git.shineup.me/Aidar/SHiNE-server.git git remote -v ``` Старый адрес `git2.shineup.me` не использовать. Секреты, токены, приватные ключи, `.env`, логи и сборочные артефакты в Git не добавлять. ## Перед коммитом ```bash git status --short --branch git diff --check git diff ``` Перед обычным коммитом обновить `VERSION.properties`: - только UI — увеличить `client.version`; - только сервер — увеличить `server.version`; - UI и сервер — увеличить обе версии; - в рабочей ветке использовать patch-инкремент: `1.2.346` → `1.2.347`. Сообщения коммитов писать на русском языке. ## Commit ```bash git add <нужные-файлы> git commit -m "Краткое описание изменения" ``` Для локального `git commit` токен не нужен. Не использовать `git add .`, если в рабочем дереве есть непроверенные локальные файлы. ## Push Сначала проверить ветку и remote: ```bash git branch --show-current git remote -v ``` Для push использовать токен из переменной окружения `GITEA_TOKEN`; сам токен в команду, файл или историю shell не записывать. При HTTPS Git обычно запросит имя пользователя и пароль токена: ```bash export GITEA_TOKEN='токен задаётся локально и не коммитится' git push origin HEAD unset GITEA_TOKEN ``` Если credential helper не умеет автоматически подставлять `GITEA_TOKEN`, использовать настроенный локально способ авторизации Gitea; не вставлять токен в URL remote. После push проверить результат: ```bash git status --short --branch git log -1 --oneline ``` ## Ветка `main` `main` предназначена для стабильных версий. По умолчанию изменения сначала коммитить в рабочей ветке, затем вливать в `main`. Для merge в `main` увеличивать вторую цифру версии и обнулять третью: `1.2.346` → `1.3.0`. Перед push в `main` отдельно проверить diff, версию и отсутствие секретов.