GUIDES = {
    "dns": {
        "title": "راهنمای DNS",
        "summary": "تنظیم DNS از طریق systemd-resolved",
        "content": """
<h5>DNS چیست؟</h5>
<p>DNS آدرس دامنه‌ها (مثل github.com) را به IP تبدیل می‌کند. در ایران برای دسترسی به سرویس‌های فیلترشده از DNSهای داخلی استفاده می‌شود.</p>

<h5>چه کاری انجام می‌دهد؟</h5>
<ul>
<li>یک فایل drop-in در <code>/etc/systemd/resolved.conf.d/mirror-manager.conf</code> ایجاد می‌کند</li>
<li>سرویس <code>systemd-resolved</code> را restart می‌کند</li>
<li>فایل SSH دست‌نخورده می‌ماند</li>
</ul>

<h5>DNSهای پیش‌فرض</h5>
<ul>
<li><strong>Shecan:</strong> 178.22.122.100, 185.51.200.2</li>
<li><strong>403.online:</strong> 10.202.10.202, 10.202.10.102</li>
<li><strong>Begzar:</strong> 185.55.226.26, 185.55.227.27</li>
</ul>

<h5>نکات مهم</h5>
<ul>
<li>اگر با IP به SSH وصل می‌شوید، تغییر DNS معمولاً SSH را قطع نمی‌کند</li>
<li>قبل از apply، backup خودکار گرفته می‌شود</li>
<li>پنجره rollback به شما اجازه تست می‌دهد</li>
</ul>
""",
    },
    "apt": {
        "title": "راهنمای APT",
        "summary": "تنظیم مخزن Ubuntu برای apt update/install",
        "content": """
<h5>APT چیست؟</h5>
<p>مدیر بسته Ubuntu. برای نصب و آپدیت پکیج‌های سیستم از مخزن (mirror) استفاده می‌کند.</p>

<h5>چه کاری انجام می‌دهد؟</h5>
<ul>
<li>فایل <code>/etc/apt/sources.list</code> را با میرور انتخابی جایگزین می‌کند</li>
<li>codename سیستم (noble/jammy/bionic) را خودکار تشخیص می‌دهد</li>
<li>دستور <code>apt-get update</code> را برای تست اجرا می‌کند</li>
</ul>

<h5>میرورهای پیش‌فرض</h5>
<ul>
<li><strong>Arvan:</strong> mirror.arvancloud.ir/ubuntu</li>
<li><strong>Shatel:</strong> mirror.shatel.ir/ubuntu</li>
</ul>

<h5>نسخه‌های Ubuntu</h5>
<ul>
<li>24.04 → noble (فوکوس اصلی)</li>
<li>22.04 → jammy</li>
<li>18.04 → bionic</li>
</ul>
""",
    },
    "docker": {
        "title": "راهنمای Docker Registry",
        "summary": "تنظیم registry-mirrors برای pull ایمیج",
        "content": """
<h5>Registry Mirror چیست؟</h5>
<p>وقتی <code>docker pull</code> می‌زنید، درخواست از mirror ایرانی عبور می‌کند و سرعت بیشتر و قطعی کمتر می‌شود.</p>

<h5>چه کاری انجام می‌دهد؟</h5>
<ul>
<li>فایل <code>/etc/docker/daemon.json</code> را ویرایش می‌کند</li>
<li>کلید <code>registry-mirrors</code> را تنظیم می‌کند</li>
<li>سرویس Docker را restart می‌کند</li>
</ul>

<h5>هشدار</h5>
<p>با restart Docker، containerها (از جمله Dokploy) چند ثانیه قطع می‌شوند. همیشه ابتدا «تست موقت» را بزنید.</p>
<p>فقط کلیدهای رسمی Docker در <code>daemon.json</code> نوشته می‌شوند — کلیدهای نامعتبر باعث crash شدن Docker نمی‌شوند.</p>

<h5>میرور پیش‌فرض</h5>
<ul>
<li><strong>Arvan:</strong> docker.arvancloud.ir</li>
</ul>
""",
    },
    "github": {
        "title": "راهنمای GitHub",
        "summary": "تنظیم git برای clone/pull از GitHub",
        "content": """
<h5>مشکل GitHub</h5>
<p>معمولاً <code>git pull</code> و <code>git clone</code> از GitHub کند یا timeout می‌شود.</p>

<h5>چه کاری انجام می‌دهد؟</h5>
<ul>
<li>در <code>~/.gitconfig</code> یک rule از نوع <code>insteadOf</code> اضافه می‌کند</li>
<li>آدرس github.com به mirror انتخابی redirect می‌شود</li>
<li>SSH clone (git@github.com) هم به HTTPS mirror تبدیل می‌شود</li>
</ul>

<h5>تست</h5>
<p>بعد از apply، دستور <code>git ls-remote</code> روی repo نمونه اجرا می‌شود.</p>

<h5>میرورهای پیش‌فرض</h5>
<ul>
<li><strong>GitClone:</strong> gitclone.com/github.com</li>
<li><strong>GHProxy:</strong> mirror.ghproxy.com</li>
</ul>
""",
    },
    "pip": {
        "title": "راهنمای pip",
        "summary": "تنظیم index-url برای pip install",
        "content": """
<h5>pip چیست؟</h5>
<p>مدیر بسته Python. فایل <code>/etc/pip.conf</code> برای تنظیم سراسری استفاده می‌شود.</p>

<h5>میرور پیش‌فرض</h5>
<ul>
<li><strong>Arvan PyPI:</strong> mirror.arvancloud.ir/pypi/simple</li>
</ul>
""",
    },
    "npm": {
        "title": "راهنمای npm",
        "summary": "تنظیم registry برای npm install",
        "content": """
<h5>npm چیست؟</h5>
<p>مدیر بسته Node.js. فایل <code>/root/.npmrc</code> برای تنظیم registry سراسری استفاده می‌شود.</p>
""",
    },
    "profiles": {
        "title": "راهنمای پروفایل‌ها",
        "summary": "ترکیب چند تنظیم در یک کلیک",
        "content": """
<h5>پروفایل چیست؟</h5>
<p>مجموعه‌ای از میرورها برای DNS، APT، Docker، GitHub و... که با یک کلیک apply می‌شوند.</p>

<h5>اعمال امن (توصیه‌شده)</h5>
<ol>
<li><strong>تست موقت (۲ دقیقه):</strong> پروفایل اعمال می‌شود. اگر تأیید نکنید، خودکار rollback.</li>
<li>سرویس‌ها (Dokploy، mirror، deploy) را تست کنید.</li>
<li><strong>اعمال نهایی:</strong> از صفحه وضعیت تست، دکمه «نگه‌داشتن تغییرات» را بزنید.</li>
</ol>

<h5>بازگردانی فوری</h5>
<p>اگر دسترسی قطع شد: <code>mirror-manager emergency-restore</code> از SSH — یا دکمه «بازگردانی فوری» در بخش Restore.</p>

<h5>پروفایل‌های پیش‌فرض</h5>
<ul>
<li><strong>آروان کامل:</strong> Shecan + Arvan APT/Docker + GitClone</li>
<li><strong>403 + Shatel:</strong> DNS 403 + Shatel APT</li>
<li><strong>حداقلی:</strong> فقط DNS + Docker</li>
</ul>

<h5>Rollback</h5>
<p>تست موقت پیش‌فرض ۲ دقیقه است. اعمال نهایی بدون پنجره rollback — فقط بعد از تست موفق.</p>
""",
    },
    "settings": {
        "title": "راهنمای تنظیمات",
        "summary": "Auto-switch و rollback",
        "content": """
<h5>Auto-switch</h5>
<p>اگر فعال باشد، برنامه به صورت دوره‌ای میرور فعال هر بخش را تست می‌کند. در صورت fail، به بهترین میرور جایگزین switch می‌کند.</p>

<h5>Rollback خودکار</h5>
<p>بعد از apply، تا پایان پنجره زمانی می‌توانید تأیید کنید. در غیر این صورت backup قبلی restore می‌شود.</p>

<h5>محدودیت switch</h5>
<p>حداکثر تعداد switch خودکار در روز قابل تنظیم است (پیش‌فرض: ۳).</p>
""",
    },
    "restore": {
        "title": "راهنمای بازگردانی",
        "summary": "Restore backup اولیه یا backupهای قبلی",
        "content": """
<h5>Backup اولیه</h5>
<p>در اولین اجرا، snapshot از تنظیمات فعلی سیستم گرفته می‌شود.</p>

<h5>بازگردانی فوری (Emergency)</h5>
<p>یک دستور / یک دکمه — برگشت به آخرین backup قبل از apply (DNS، APT، Docker، ...).</p>

<h5>بازگردانی</h5>
<ul>
<li><strong>emergency-restore:</strong> آخرین backup قبل از apply — سریع‌ترین راه</li>
<li><strong>تنظیمات اولیه:</strong> برگشت به وضعیت قبل از نصب Mirror Manager</li>
<li><strong>backup apply:</strong> برگشت به backup مشخص</li>
</ul>

<h5>از SSH</h5>
<pre>mirror-manager emergency-restore
mirror-manager restore --initial
mirror-manager restore --last
mirror-manager disable
mirror-manager enable</pre>
""",
    },
    "dashboard": {
        "title": "راهنمای داشبورد",
        "summary": "نمای کلی وضعیت سیستم",
        "content": """
<h5>داشبورد</h5>
<p>وضعیت فعلی DNS، APT، Docker و GitHub را نشان می‌دهد. آخرین apply و rollback pending هم نمایش داده می‌شود.</p>
""",
    },
}