raa-parser_poster/RAA.md

RAA Parser/Poster

RAA is a separate deployment copied from the FN-8 parser/poster codebase.

Runtime

• Local workspace: D:\DEVELOPMENT\raa-parser_poster
• Public admin domain: https://raa.panel.f-n8.ru
• Gitea repo: http://192.168.1.135:3000/exostring/raa-parser_poster.git
• Proxmox LXC: CTID 107, hostname raa-parser-poster, IP 192.168.1.106
• Server path: /opt/raa-parser/app
• Deploy method: manual Docker Compose inside CTID 107.
• Edge proxy: Caddy in CTID 110 proxies raa.panel.f-n8.ru to 192.168.1.106:8000.
• Health check: https://raa.panel.f-n8.ru/health
• Site poster must stay disabled until a site adapter is configured.
• The current site-poster adapter boundary is site_poster_provider; only ghost exists in code today. WordPress should be added as a code adapter, not as arbitrary executable code stored in settings.

Current Deployment

Created on 2026-08-03.

• App container and Postgres run via /opt/raa-parser/app/docker-compose.yml.
• Runtime .env is stored only on the server at /opt/raa-parser/app/.env.
• APP_SECRET_KEY, DB password, and initial admin password were generated on deploy and are not committed.
• Initial admin login is admin.
• vk-parser, vk-storage-uploader, and daily-report default to disabled for a fresh RAA DB.
• Site poster defaults to disabled; do not enable it until an RAA site provider is chosen.

Deploy Notes

To update this deployment:

1. Push changes to the Gitea repo.
2. SSH to Proxmox host from D:\DEVELOPMENT\.infra.md.
3. Run inside CTID 107:

cd /opt/raa-parser/app
git pull --rebase
docker-compose up -d --build
curl -fsS http://127.0.0.1:8000/health

First-Run Settings

Set real secrets in env, not in git:

• APP_SECRET_KEY
• ADMIN_BOOTSTRAP_LOGIN
• ADMIN_BOOTSTRAP_PASSWORD
• DB_*
• TG_BOT_TOKEN
• TELEGRAM_API_ID
• TELEGRAM_API_HASH
• VK_ACCESS_TOKEN or VK_GROUP_ACCESS_TOKEN

Set runtime settings in the admin UI/DB:

• TG_MEDIA_CHANNEL_ID
• tg_poster_bot_token
• tg_poster_chat_id
• vk_poster_owner_id
• site_poster_enabled=false
• site_poster_provider=""