dzentra_bot/docs/git_flow_dzentra_bot.md

Git Setup Flow: dzentra_bot

Полный процесс: от git init до первого push в Gitea

---

📍 0. Перейти в корень проекта

cd ~/vsprojects/dzentra_bot
pwd

Ожидаемо:

.../vsprojects/dzentra_bot

---

🧱 1. Инициализация Git

git init

Проверка:

git status

---

📦 2. Проверка .gitignore

cat .gitignore

Должны быть строки:

app/.env
app/.venv/
__pycache__/
.DS_Store

---

➕ 3. Добавить все файлы

git add .

Проверка:

git status

---

💾 4. Первый commit

git commit -m "bootstrap v2 stable start"

---

🔗 5. Подключить удалённый репозиторий (Gitea)

git remote add origin https://gitadmin@git.segeba.by/gitadmin/dzentra_bot.git

Проверка:

git remote -v

---

🌿 6. Установить ветку main

git branch -M main

---

🔐 7. Настроить сохранение токена (macOS)

git config --global credential.helper osxkeychain

---

🚀 8. Первый push

git push -u origin main

При запросе:

Username:

gitadmin

Password:

👉 вставить Personal Access Token из Gitea

---

✅ 9. Проверка

git status
git branch -vv

Проверить в Gitea — файлы должны появиться.

---

🔁 Дальнейшая работа

Каждый цикл разработки

git status
git add .
git commit -m "описание изменения"
git push

---

🖥 Работа с проектом

Запуск бота

cd app
source .venv/bin/activate
python -m src.main

Git всегда из корня

cd ~/vsprojects/dzentra_bot
git status

---

🚀 Deploy на Synology

git pull
sudo docker compose -f infra/compose/docker-compose.yml up --build -d

---

⚠️ Важно

Не коммитить:

app/.env
app/.venv
ключи
пароли
логи

---

🎯 Итог

Git используется как:

• система контроля версий
• история проекта
• мост между Mac и Synology