Stage 03.1 - mock exchange integration

docs/git_flow_dzentra_bot.md

@@ -0,0 +1,189 @@
+# Git Setup Flow: dzentra_bot
+
+## Полный процесс: от `git init` до первого `push` в Gitea
+
+---
+
+## 📍 0. Перейти в корень проекта
+
+```bash
+cd ~/vsprojects/dzentra_bot
+pwd
+```
+
+Ожидаемо:
+```
+.../vsprojects/dzentra_bot
+```
+
+---
+
+## 🧱 1. Инициализация Git
+
+```bash
+git init
+```
+
+Проверка:
+```bash
+git status
+```
+
+---
+
+## 📦 2. Проверка `.gitignore`
+
+```bash
+cat .gitignore
+```
+
+Должны быть строки:
+```
+app/.env
+app/.venv/
+__pycache__/
+.DS_Store
+```
+
+---
+
+## ➕ 3. Добавить все файлы
+
+```bash
+git add .
+```
+
+Проверка:
+```bash
+git status
+```
+
+---
+
+## 💾 4. Первый commit
+
+```bash
+git commit -m "bootstrap v2 stable start"
+```
+
+---
+
+## 🔗 5. Подключить удалённый репозиторий (Gitea)
+
+```bash
+git remote add origin https://gitadmin@git.segeba.by/gitadmin/dzentra_bot.git
+```
+
+Проверка:
+```bash
+git remote -v
+```
+
+---
+
+## 🌿 6. Установить ветку main
+
+```bash
+git branch -M main
+```
+
+---
+
+## 🔐 7. Настроить сохранение токена (macOS)
+
+```bash
+git config --global credential.helper osxkeychain
+```
+
+---
+
+## 🚀 8. Первый push
+
+```bash
+git push -u origin main
+```
+
+При запросе:
+
+### Username:
+```
+gitadmin
+```
+
+### Password:
+👉 вставить **Personal Access Token из Gitea**
+
+---
+
+## ✅ 9. Проверка
+
+```bash
+git status
+git branch -vv
+```
+
+Проверить в Gitea — файлы должны появиться.
+
+---
+
+# 🔁 Дальнейшая работа
+
+## Каждый цикл разработки
+
+```bash
+git status
+git add .
+git commit -m "описание изменения"
+git push
+```
+
+---
+
+# 🖥 Работа с проектом
+
+## Запуск бота
+
+```bash
+cd app
+source .venv/bin/activate
+python -m src.main
+```
+
+## Git всегда из корня
+
+```bash
+cd ~/vsprojects/dzentra_bot
+git status
+```
+
+---
+
+# 🚀 Deploy на Synology
+
+```bash
+git pull
+sudo docker compose -f infra/compose/docker-compose.yml up --build -d
+```
+
+---
+
+# ⚠️ Важно
+
+Не коммитить:
+
+```
+app/.env
+app/.venv
+ключи
+пароли
+логи
+```
+
+---
+
+# 🎯 Итог
+
+Git используется как:
+- система контроля версий
+- история проекта
+- мост между Mac и Synology