chore: v0.36.0-dev + CI/CD в docs + copilot instructions

2026-05-31 17:44:52 +03:00
parent 7f71cb1709
commit f4475c441f
3 changed files with 94 additions and 17 deletions
@@ -0,0 +1,55 @@
+# Инструкция для Copilot — проект elmAI
+
+> Последнее обновление: 31 мая 2026 · v0.36.0-dev
+
+## Репозитории
+
+| Репо | Назначение | Хостинг |
+|------|-----------|---------|
+| `elmer/` (этот) | Сервер Python/Flask | gitea.services.ngcloud.ru/Nail/elmer |
+| `elmer/android/` | Android-приложение Kotlin | github.com/Repinoid/elmer-android |
+
+## Деплой
+
+### Сервер (obdai.ru, 5.172.178.213)
+- Код: `/opt/elmer` (git clone gitea)
+- Ветка: `master` (по умолчанию)
+- Деплой: `ssh obdai.ru "cd /opt/elmer && git pull && sudo systemctl restart elmer"`
+- Сервис: `gunicorn -w 4 -b 127.0.0.1:8000 web.app:app`
+- Прокси: nginx :443 → :8000
+
+### APK
+- Сборка: вручную (`./gradlew assembleDebug` в `android/`)
+- Доставка: `scp app-debug.apk obdai.ru:/opt/elmer/web/static/app-debug.apk`
+- Ссылка: `https://obdai.ru/elmer.apk` → `web/static/app-debug.apk`
+- НИКАКИХ GitHub Actions, CI/CD сервисов
+
+### Версионирование
+- APK: `android/app/build.gradle.kts` → `versionName`
+- Сайт: `web/templates/index.html` (синхронизировать вручную)
+- Документация: в заголовках `.md` файлов
+
+## Правила работы
+
+1. **Не выдумывать инфраструктуру.** Никаких GitHub Actions, Docker, Kubernetes, CI/CD сервисов. Всё вручную.
+2. **Читать документацию перед действиями.** `doc/architecture.md` — канонический источник.
+3. **Не редактировать отчёты Опуса.** `doc/opus-review*.md` — только для чтения.
+4. **Ключи и токены:** LLM-ключ только на сервере (`config.yaml`), НЕ в APK. `X-Api-Key` приложения — через `BuildConfig.API_KEY` из `local.properties`.
+5. **Git:** `elmer/` и `elmer/android/` — отдельные репо, отдельные коммиты.
+6. **Ветки:** `master` — продакшен, `opus-fixes` и др. — для правок. Вливать в master когда готово.
+7. **После правок:** коммит + пуш + (если сервер) деплой через SSH.
+8. **Версия:** менять в трёх местах — `build.gradle.kts`, `index.html`, доки.
+
+## Структура сервера
+
+```
+elmer/
+├── api/          # REST, БД, скрипты, парсер
+├── brain/        # LLM-клиент, промпты
+├── obd/          # ELM327 стейт-машина
+├── web/          # Flask, шаблоны, статика (APK)
+├── android/      # Android-приложение (отдельный репо)
+├── doc/          # Документация
+├── config.yaml   # LLM API key, порты
+└── run.py        # Локальный запуск
+```