From 126598dd8a9d2bf03301a18e3d14384de92f070f Mon Sep 17 00:00:00 2001
From: Repinoid <tazet@narod.ru>
Date: Wed, 3 Jun 2026 08:37:18 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83?=
 =?UTF-8?q?=D0=BA=D1=86=D0=B8=D1=8F=20=D0=BF=D0=BE=20git=20=E2=80=94=20?=
 =?UTF-8?q?=D1=80=D0=B5=D0=BF=D0=BE,=20pull,=20push,=20=D0=B4=D0=B5=D0=BF?=
 =?UTF-8?q?=D0=BB=D0=BE=D0=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/git-guide.md | 75 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 doc/git-guide.md

diff --git a/doc/git-guide.md b/doc/git-guide.md
new file mode 100644
index 0000000..83a9172
--- /dev/null
+++ b/doc/git-guide.md
@@ -0,0 +1,75 @@
+# Инструкция по Git
+
+> v0.36.0-dev, 3 июня 2026
+
+## Структура репозиториев
+
+Один проект — два git-репо в одной папке:
+
+```
+elmer/                   ← git-репо #1 (gitea)
+├── api/                 серверный код
+├── brain/               LLM-клиент
+├── obd/                 ELM327
+├── web/                 Flask, сайт, APK
+├── doc/                 документация
+├── android/             ← git-репо #2 (github) — Android-приложение
+│   ├── app/             исходники Kotlin
+│   ├── build.gradle.kts сборка
+│   └── ...
+├── config.yaml          конфиг сервера
+└── ...
+```
+
+## Ремоуты
+
+| Репо | URL |
+|------|-----|
+| Сервер (elmer/) | `https://gitea.services.ngcloud.ru/Nail/elmer.git` |
+| Android (elmer/android/) | `https://github.com/Repinoid/elmer-android.git` |
+
+## Команды
+
+### Сервер
+
+```bash
+cd elmer
+git pull origin master      # забрать изменения
+git add -A                  # добавить всё
+git commit -m "..."         # закоммитить
+git push origin master      # отправить
+```
+
+### Android
+
+```bash
+cd elmer/android
+git pull origin master      # забрать изменения
+git add -A                  # добавить всё
+git commit -m "..."         # закоммитить
+git push origin master      # отправить
+```
+
+## Деплой на сервер (obdai.ru)
+
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
+  "cd /opt/elmer && git pull origin master && sudo systemctl restart elmer"
+```
+
+## Сборка APK (на сервере)
+
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
+  "export ANDROID_SDK_ROOT=\$HOME/android-sdk && \
+   export ANDROID_HOME=\$ANDROID_SDK_ROOT && \
+   cd /opt/elmer/android && \
+   ./gradlew clean assembleDebug && \
+   cp app/build/outputs/apk/debug/app-debug.apk /opt/elmer/web/static/"
+```
+
+## Важно
+
+- `android/` в `.gitignore` родительского репо — его изменения коммитятся отдельно
+- Ветка везде `master`
+- Перед началом работы всегда делать `git pull` в обоих репо