# 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`:

```sh
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=""`