merge: chore/cleanup-remove-bloat-and-secrets into main

2026-07-02 01:24:22 +07:00 · 2026-07-02 01:24:22 +07:00 · bde2f3a97d
commit bde2f3a97d
1173 changed files with 437609 additions and 0 deletions
--- a/EMAIL_SETUP.md
+++ b/EMAIL_SETUP.md
@ -0,0 +1,160 @@
+# Email Forwarding Setup Guide
+# =============================
+#
+# This system forwards emails from your domains to a Gmail inbox,
+# then polls that inbox and forwards emails to your Telegram admin bot.
+#
+# NO AUTO-REPLIES - emails appear in Telegram for admin review.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+SETUP STEPS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+1. CREATE GMAIL RECEIVER ACCOUNT
+   ------------------------------
+   Create a new Gmail account (or use existing):
+
+   Example: rugmunch.admin@gmail.com
+
+   IMPORTANT: Enable 2FA and create an App Password:
+   - Go to: https://myaccount.google.com/security
+   - Enable 2-Step Verification (if not already)
+   - Go to: https://myaccount.google.com/apppasswords
+   - Create a new app password (select "Mail" and your device)
+   - COPY THE 16-CHARACTER PASSWORD (no spaces)
+
+   You'll need:
+   - Email: rugmunch.admin@gmail.com (or your choice)
+   - App Password: XXXX XXXX XXXX XXXX (16 chars)
+
+2. CONFIGURE CLOUDFLARE EMAIL ROUTING
+   -----------------------------------
+
+   For rugmunch.io:
+   - Log in to Cloudflare dashboard
+   - Go to your rugmunch.io zone
+   - Click "Email" → "Email Routing"
+   - Click "Add Route"
+   - Create these addresses (all forward to same Gmail):
+
+     admin@rugmunch.io → rugmunch.admin@gmail.com
+     support@rugmunch.io → rugmunch.admin@gmail.com
+     contact@rugmunch.io → rugmunch.admin@gmail.com
+
+   For cryptorugmunch.com:
+   - Go to your cryptorugmunch.com zone
+   - Click "Email" → "Email Routing"
+   - Click "Add Route"
+   - Create these addresses:
+
+     admin@cryptorugmunch.com → rugmunch.admin@gmail.com
+     team@cryptorugmunch.com → rugmunch.admin@gmail.com
+     info@cryptorugmunch.com → rugmunch.admin@gmail.com
+
+   IMPORTANT: Make sure Email Routing is ENABLED (toggle ON)
+
+3. CONFIGURE BACKEND ENVIRONMENT VARIABLES
+   ----------------------------------------
+
+   Add these to your /root/.secrets/project_envs/rmi-backend.env:
+
+   # Email Forwarding
+   EMAIL_RECEIVER=rugmunch.admin@gmail.com
+   EMAIL_PASSWORD=xxxx xxxx xxxx xxxx  (app password, no spaces)
+   TELEGRAM_ADMIN_CHAT_ID=123456789    (your admin Telegram chat ID)
+   EMAIL_POLL_INTERVAL=60              # check every 60 seconds
+
+   # Get your Telegram Chat ID:
+   - Message your bot: @userinfobot
+   - Send any message
+   - It will reply with your ID (e.g., 123456789)
+
+4. START RESTART BACKEND
+   ----------------------
+   Restart your backend service:
+
+   sudo systemctl restart rmi-backend
+
+   Or if running manually:
+   cd /srv/rmi/backend
+   source venv/bin/activate
+   python main.py
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+VERIFICATION
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Check logs for email polling startup:
+  sudo journalctl -u rmi-backend -f
+
+You should see:
+  [RMI] 📧 Email polling enabled - starting IMAP service
+
+Send a test email to:
+  admin@rugmunch.io
+
+Wait 1-2 minutes. You should receive a Telegram message in your admin chat:
+
+  📧 New Email
+
+  From: sender@example.com
+  Domain: rugmunch.io
+  Subject: Test Email
+  Time: 2026-05-01 12:34:56
+
+  ━━━━━━━━━━━━━━━━━━━━
+
+  This is the email body...
+
+  Inbox: rugmunch.admin@gmail.com
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+FAQ
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Q: Can users reply to these emails?
+A: Emails can be replied to (standard email), but your system
+   won't auto-reply. Admins review in Telegram and respond manually
+   via their email client.
+
+Q: What happens if Gmail IMAP fails?
+A: The poller logs errors and retries on next interval. Emails
+   are marked as read, so they won't be re-sent to Telegram.
+
+Q: Can I forward to a different email?
+A: Yes, just change EMAIL_RECEIVER to any Gmail/IMAP-enabled
+   address. You'll need an app password for Gmail.
+
+Q: How many emails can I receive?
+A: Gmail free accounts: 15GB storage (roughly 10,000+ emails)
+   Cloudflare Email Routing: Unlimited forwards
+
+Q: Do I need to configure MX records?
+A: NO! Cloudflare Email Routing handles this automatically when
+   you enable Email Routing for your zone.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+TROUBLESHOOTING
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+"IMAP login failed":
+  - Check EMAIL_PASSWORD is correct (use app password, not regular password)
+  - Ensure IMAP is enabled in Gmail settings
+  - Try logging into Gmail IMAP manually: telnet imap.gmail.com 993
+
+"No emails appearing in Telegram":
+  - Verify Cloudflare Email Routing is ENABLED
+  - Check that emails are actually arriving in Gmail inbox
+  - Look at backend logs for polling errors
+  - Wait up to 2 minutes (poll interval)
+
+"Duplicate emails in Telegram":
+  - Emails are marked as read after first poll
+  - Check Gmail isn't moving emails back to inbox
+  - Reset seen_message_ids by restarting backend
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━