Configure admin title and deploy docs

This commit is contained in:
Your Name
2026-07-28 12:37:04 +05:00
parent bb2c58e02f
commit 3ab8a7b4f2
7 changed files with 68 additions and 88 deletions
+40 -57
View File
@@ -31,9 +31,11 @@
- Telegram: `aiogram`.
- AI: `litellm`, сейчас используется Anthropic через LiteLLM.
- Логи: `loguru`.
- Системный запуск на сервере: `systemd`.
- Reverse proxy / TLS: nginx + сертификат для `https://sw.exostring.xyz`.
- Репозиторий: GitHub `exostring/n8_parser`.
- Runtime/deploy: локальная инфраструктура Proxmox + Coolify + Docker.
- Reverse proxy / TLS: edge-proxy Caddy из локальной инфраструктуры.
- Публичная админка: `https://panel.f-n8.ru` (`https://admin.f-n8.ru` после обновления DNS).
- Deploy-репозиторий: Gitea `http://192.168.1.135:3000/exostring/new_vk_parser.git`, remote `gitea`.
- GitHub `origin` используется как upstream/backup, не как основной deploy remote.
## 3. Структура проекта
@@ -74,6 +76,8 @@
Если меняется поведение системы, эксплуатационная схема, публикационный формат, БД, деплой или админка, это нужно отражать в `PROJECT.md` или другом релевантном `.md` рядом с кодом.
Инфраструктурная карта вне репозитория: `D:\DEVELOPMENT\.infra.md`. Перед любыми deploy/server действиями сначала читать её. Для этого проекта актуален контур Gitea -> Coolify -> LXC 105; старые инструкции про `sw.exostring.xyz`, `109.120.156.205`, `/opt/vk-parser` и ручной `systemctl` не использовать без явной команды пользователя.
Текущие зафиксированные изменения:
- Публичный сайт вынесен в самостоятельное приложение `forma_n8_site/` и разворачивается на отдельном VPS. Сайт хранит собственные статьи и медиа, отдаёт серверный HTML, RSS, sitemap, robots.txt, canonical и JSON-LD `NewsArticle`.
@@ -1230,47 +1234,42 @@ $env:PYTHONPYCACHEPREFIX="$env:TEMP\n8_pycache"
python -m py_compile src\vk_parser_app\admin.py
```
## 16. Сервер
## 16. Runtime / Deploy
Рабочий путь:
Актуальный runtime живёт в локальной инфраструктуре. Источник правды по хостам,
ключам, Coolify, Gitea и edge-proxy: `D:\DEVELOPMENT\.infra.md`.
```bash
/opt/vk-parser
Текущая схема:
```text
local repo
-> git push gitea main
-> Gitea webhook on 192.168.1.135
-> Coolify on 192.168.1.135
-> Docker app on LXC 105 / 192.168.1.105
-> edge-proxy / Caddy
-> https://panel.f-n8.ru
```
Основные команды:
Важно:
```bash
cd /opt/vk-parser
git pull --ff-only
PYTHONPATH=src .venv/bin/python scripts/apply_migrations.py
systemctl restart vk-parser-admin.service
```
- Не использовать для этого проекта старый VPS `109.120.156.205`.
- Не использовать `https://sw.exostring.xyz` как проверку текущей админки.
- Не выполнять `/opt/vk-parser`, `git pull` на VPS и `systemctl restart ...`
без явного указания пользователя, что речь именно о старом VPS.
- Основной deploy remote: `gitea`.
- URL репозитория в Coolify должен резолвиться из build/helper container на
deploy-сервере. Не использовать `http://coolify.lan:3000/...`, если это имя
не настроено внутри LXC/Docker; рабочий локальный URL Gitea:
`http://192.168.1.135:3000/exostring/new_vk_parser.git`.
- Coolify должен собирать и деплоить приложение после push/webhook; при ручном
деплое использовать Coolify API/UI из `D:\DEVELOPMENT\.infra.md`.
Проверка сервисов:
Публичная админка:
```bash
systemctl is-active vk-parser-admin.service
systemctl is-active vk-parser.service
systemctl is-active vk-storage-uploader.service
systemctl is-active ai-qualifier.service
systemctl is-active ai-writer.service
systemctl is-active tg-poster.service
systemctl is-active max-poster.service
systemctl is-active telegram-bot-api.service
```
Логи:
```bash
journalctl -u vk-parser-admin.service -n 100 --no-pager
journalctl -u vk-parser.service -n 100 --no-pager
journalctl -u vk-storage-uploader.service -n 100 --no-pager
journalctl -u ai-qualifier.service -n 100 --no-pager
journalctl -u ai-writer.service -n 100 --no-pager
journalctl -u tg-poster.service -n 100 --no-pager
journalctl -u max-poster.service -n 100 --no-pager
journalctl -u telegram-bot-api.service -n 100 --no-pager
```text
https://panel.f-n8.ru
https://admin.f-n8.ru
```
## 17. Git workflow
@@ -1281,28 +1280,12 @@ journalctl -u telegram-bot-api.service -n 100 --no-pager
git status
git add ...
git commit -m "Message"
git push
git pull --rebase gitea main
git push gitea main
```
На сервере origin настроен через deploy key.
Обычный деплой:
```bash
cd /opt/vk-parser
git pull --ff-only
PYTHONPATH=src .venv/bin/python scripts/apply_migrations.py
systemctl restart vk-parser-admin.service
```
Если менялся конкретный worker, перезапустить его:
```bash
systemctl restart ai-writer.service
systemctl restart ai-qualifier.service
systemctl restart vk-parser.service
systemctl restart vk-storage-uploader.service
```
`origin` остаётся GitHub/upstream/backup. Для deploy использовать `gitea`,
потому что Gitea webhook запускает Coolify.
## 18. Контролируемый тест AI-райтера