# NetVibe VPN - Telegram Content Aggregation & Automated Publishing Pipeline سیستم جامع و چندعاملی (Multi-Agent) برای رصد خودکار کانال‌های مرجع تلگرام در حوزه فیلترشکن، پروکسی و هوش مصنوعی، بازنویسی هوشمند و جذاب با لحن عامیانه ایرانی، داشبورد نظارت و ویرایش سردبیر تحت Next.js و دیسپچر انتشار خودکار به کانال رسمی `@NetVibe_VPN`. --- ## 🏗️ معماری سیستم و ایجنت‌ها ``` ┌────────────────────────────────────────────────────────┐ │ Telegram Public Web │ │ (Channels: VPN, Proxy, Bypass, AI Tools) │ └───────────────────────────┬────────────────────────────┘ │ ▼ ┌───────────────────────────┐ │ Agent A: Web Scraper │ (httpx + BeautifulSoup) │ (No Bot / No Ban Risk) │ └─────────────┬─────────────┘ │ Saves to raw_posts ▼ ┌───────────────────────────┐ │ PostgreSQL / SQLAlchemy │ (Persistent storage & DDL) └─────────────┬─────────────┘ │ ▼ ┌───────────────────────────┐ │ Agent B: LLM Curator │ (Persian Copywriting + Active Learning) │ (GPT-4o + Few-shot Diff) │ └─────────────┬─────────────┘ │ Generates content_drafts ▼ ┌───────────────────────────┐ │ Next.js Curation Panel │ (Review, Edit, Inline Diff, Tooltips) │ (Editor / Human Gate) │ └─────────────┬─────────────┘ │ Approves into publish_queue ▼ ┌───────────────────────────┐ │ Agent C: Auto Publisher │ (python-telegram-bot / Telegram Bot API) │ (Scheduled Worker) │ └─────────────┬─────────────┘ │ ▼ ┌───────────────────────────┐ │ Official Telegram Channel │ │ @NetVibe_VPN │ └───────────────────────────┘ ``` --- ## 🌟 ویژگی‌های کلیدی 1. **Agent A (اسکرپر عمومی تلگرام)**: - بدون نیاز به اکانت تلگرام یا سشن MTProto (حذف کامل ریسک بن شدن). - استخراج عنوان، متن پیام، عکس/ویدیو، تعداد بازدید، واکنش‌ها و تاریخ پیام از `https://t.me/s/{channel}`. - جلوگیری از ذخیره پست‌های تکراری با کلید یکتای ترکیبی `(channel_id, message_id)`. 2. **Agent B (موتور سنتز و یادگیری فعال)**: - نگارش با لحن خودمانی، عامیانه، رفاقتی و به شدت روان فارسی متناسب با برند NetVibe. - استخراج تفاوت‌ها (Diff Tracking) بین خروجی اولیه هوش مصنوعی و ویرایش‌های نهایی سردبیر با الگوریتم توالی‌یابی کاراکتری. - تزریق خودکار تجربیات و خط‌قرمزهای سردبیر به عنوان نمونه‌های پرامپت (Active Few-shot In-context Learning). 3. **Agent C (دیسپچر انتشار خودکار)**: - پایش مداوم صف انتشار در دیتابیس (`publish_queue`). - ارسال مستقیم به کانال `@NetVibe_VPN` به همراه مدیا (عکس/ویدیو) و کپشن با فرمت Markdown. - ثبت شناسه پیام منتشرشده (`telegram_msg_id`) و مدیریت خطاها با امکان تلاش مجدد. 4. **پنل مدیریت Next.js (App Router + Tailwind CSS)**: - صندوق بررسی و ویرایش پیش‌نویس‌ها با ادیتور متنی زنده. - رعایت دقیق استاندارد Enterprise: **تمامی کارت‌ها، ستون‌های جداول و دکمه‌ها دارای آیکون راهنما (i) (Info Tooltip) با توضیح کامل هستند.** - مانیتورینگ وضعیت کانال‌ها و صف انتشار زمان‌بندی‌شده. --- ## 🗄️ ساختار جداول دیتابیس (PostgreSQL) فایل مایگریشن در مسیر `backend/migrations/001_initial_schema.sql` قرار دارد: - `channels`: ثبت کانال‌های تحت نظر، عنوان، حوزه و وضعیت رصد. - `raw_posts`: پست‌های خام استخراج‌شده همراه با بازدید، مدیا و لینک اصلی. - `content_drafts`: پیش‌نویس‌های تولیدشده توسط هوش مصنوعی با وضعیت‌های `pending`, `approved`, `edited`, `rejected`, `published`. - `feedback_logs`: سوابق دیف‌های ویراستار انسانی، درصد شباهت، دسته‌بندی تغییرات و دلایل رد. - `publish_queue`: صف زمان‌بندی‌شده انتشار با وضعیت‌های `queued`, `publishing`, `success`, `failed`. --- ## 🚀 راهنمای راه‌اندازی سریع ### روش ۱: اجرا با Docker Compose (پیشنهادی) ```bash cd /workspace/personal/VPN_chanel cp .env.example .env # مقادیر TELEGRAM_BOT_TOKEN و OPENAI_API_KEY را در .env تکمیل کنید docker compose up -d ``` - بک‌اند: `http://localhost:8000/docs` - فرانت‌اند: `http://localhost:3000` --- ### روش ۲: راه‌اندازی محلی (Development) #### راه‌اندازی بک‌اند: ```bash cd /workspace/personal/VPN_chanel/backend python3 -m venv venv source venv/bin/activate pip install -r requirements.txt # اجرای سرور API uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload ``` #### راه‌اندازی فرانت‌اند: ```bash cd /workspace/personal/VPN_chanel/frontend npm install npm run dev ``` --- ## 📡 مسیرهای اصلی API | متد | مسیر | توضیحات | | :--- | :--- | :--- | | `GET` | `/api/v1/channels` | دریافت لیست کانال‌های تحت پایش | | `POST` | `/api/v1/channels` | افزودن کانال جدید به لیست رصد | | `POST` | `/api/v1/pipeline/scrape-and-curate` | اجرای آنی فرآیند اسکرپ و تولید پیش‌نویس | | `GET` | `/api/v1/drafts?status=pending` | دریافت پیش‌نویس‌ها جهت بررسی | | `POST` | `/api/v1/drafts/{id}/action` | تایید، ویرایش یا رد پیش‌نویس | | `GET` | `/api/v1/queue` | مشاهده صف زمان‌بندی انتشار | | `POST` | `/api/v1/pipeline/dispatch-now` | ارسال فوری پست‌های صف به تلگرام | | `GET` | `/api/v1/feedback-logs` | مشاهده تاریخچه ویرایش‌ها و یادگیری هوش مصنوعی |