| # /root/backend/ — RMI CANONICAL BACKEND |
|
|
| ## ⚠️ THIS IS THE ONE AND ONLY BACKEND |
|
|
| All other copies are dead. If you find code at `/srv/rugmuncher-backend/main.py`, |
| `/root/rmi/backend/`, or anywhere else — it's STALE. Work here ONLY. |
|
|
| ## Architecture |
|
|
| ``` |
| /root/backend/ |
| ├── main.py # FastAPI app (5040 lines) — entry point |
| ├── Dockerfile # Backend container build |
| ├── Dockerfile.worker # Worker container build |
| ├── requirements.txt # Python dependencies |
| ├── .env.example # All required env vars documented |
| ├── generate_env.py # Auto-generate .env from Hermes config |
| ├── app/ # All application modules |
| │ ├── news_service.py # 15+ source news aggregator |
| │ ├── rag_service.py # Redis-based RAG vector store |
| │ ├── auth.py # Authentication |
| │ ├── payments.py # Payment processing |
| │ ├── content_syndicate.py # Multi-platform content publishing |
| │ └── ... (80+ modules) |
| ``` |
|
|
| ## How to Use |
|
|
| ### Backend changes (Python): |
| ```bash |
| # Edit files here. Volume mount means changes are LIVE: |
| docker restart rmi-backend |
| |
| # Or for dependency changes, rebuild: |
| cd /srv/rugmuncher-backend |
| docker compose build backend --no-cache |
| docker compose up -d backend |
| ``` |
|
|
| ### Environment setup: |
| ```bash |
| python3 generate_env.py --force |
| # Then edit .env to fill in missing values |
| ``` |
|
|
| ### API documentation: |
| - Swagger: http://localhost:8000/docs |
| - Health: http://localhost:8000/health |
|
|
| ## Docker Compose |
|
|
| Compose file: `/srv/rugmuncher-backend/docker-compose.yml` |
| Context: `context: /root/backend` (builds from here) |
| Mount: `/root/backend:/app` (live code, no rebuild needed) |
|
|
| All container names use hyphens: `rmi-backend`, `rmi-worker`, `rmi-n8n`, etc. |
|
|
| ## Development Rules |
|
|
| 1. **Never edit files outside this directory** for backend work |
| 2. **Always `python3 generate_env.py`** after adding new env vars |
| 3. **`.env` never committed** — use `.env.example` as template |
| 4. **Test with `curl localhost:8000/health`** after changes |
| 5. **Volume mount = live reload** — just restart the container |
| |
| ## Related Systems |
| |
| | System | Location | Container | |
| |--------|----------|-----------| |
| | n8n workflows | /root/n8n-data/ | rmi-n8n | |
| | Orchestrator | /srv/rugmuncher-backend/orchestrator/ | rmi-orchestrator | |
| | Telegram bot | /srv/rugmuncher-backend/bots/telegram/ | rmi-telegram-bot | |
| | Frontend | /srv/rugmuncher-backend/rmi-frontend/ | Vercel/Cloudflare | |
| | Hermes AI | /root/.hermes/ | CLI process | |
| | Langfuse | /srv/langfuse/ | Separate compose | |
| | Redis | Composed | rmi-redis | |
| |
