Initial commit: local_machine docs and scripts

docs/git/LOCAL_MACHINE_GITEA_SETUP.md

@@ -0,0 +1,68 @@
+# local_machine — репозиторий на Gitea
+
+Репозиторий **local_machine** на сервере Gitea (gitea.hunab.app): документация и скрипты для локальной машины.
+
+## Быстрый старт
+
+### 1. Создать репозиторий на Gitea (один раз)
+
+**Вариант А — через веб-интерфейс**
+
+1. Открыть: https://gitea.hunab.app  
+2. Войти под пользователем `hunabgit` (или своим).  
+3. **New Repository** → Name: `local_machine` → Create Repository.  
+4. Репо создавать **пустым** (без README / .gitignore).
+
+**Вариант Б — через API (если есть токен)**
+
+```bash
+# Токен: Gitea → Settings → Applications → Generate New Token (write:repository, read:repository)
+export GITEA_TOKEN="your_token"
+bash scripts/deployment/gitea/setup-and-push.sh --create-only
+```
+
+### 2. Инициализация и первый пуш
+
+Из корня **local_machine** (не из родительского репо):
+
+```bash
+cd /Users/eternal/code/local_machine
+bash scripts/deployment/gitea/setup-and-push.sh
+```
+
+Скрипт:
+
+- инициализирует git в `local_machine` (если ещё нет `.git`);
+- добавляет `origin` (SSH или HTTPS);
+- делает первый коммит и `git push -u origin main`.
+
+### 3. Если пуш из РФ зависает
+
+По гайду [GITEA_COMPLETE_GUIDE.md](./GITEA_COMPLETE_GUIDE.md):
+
+- предпочтительно **SSH** (порт 2223):  
+  `git remote set-url origin git@gitea.hunab.app:hunabgit/local_machine.git`  
+  и снова `git push -u origin main`;
+- либо использовать прокси/скрипты пуша из основного репо (bundle-метод), если они у вас настроены.
+
+## .gitignore
+
+В корне проекта настроен `.gitignore`, чтобы не пушить:
+
+- системный мусор: `.DS_Store`, `Thumbs.db`;
+- секреты и ключи: `.env`, `*.pem`, `*.key`, конфиги VPN с ключами (`docs/connectivity/vpn/*.conf`);
+- артефакты: `node_modules/`, `__pycache__/`, `*.log`, `*.tmp`, кэши и т.п.;
+- IDE/редакторы: `.idea/`, `.vscode/`, `.cursor/`.
+
+Конфиги с приватными ключами (WireGuard и т.д.) в репозиторий не попадают.
+
+## Дальнейшая работа
+
+- Клонирование:  
+  `git clone https://gitea.hunab.app/hunabgit/local_machine.git`  
+  или по SSH:  
+  `git clone git@gitea.hunab.app:hunabgit/local_machine.git`
+- Обычные коммиты и пуш:  
+  `git add ... && git commit -m "..." && git push origin main`
+
+Полный гайд по Gitea (пуши, SSH, bundle, из РФ): [GITEA_COMPLETE_GUIDE.md](./GITEA_COMPLETE_GUIDE.md).