# Admin Main؛ کنترل‌گر شبکه پلانک

قابلیت‌های کنترل شبکه، ابزارهای تشخیص، مدیریت قرارداد و تفاوت Admin Main با پنل مدیر مارکت‌پلیس.

وضعیت: پیاده‌سازی‌شده | مخاطب: اپراتور شبکه و مدیر فنی
بازبینی مستندات: ۲۰۲۶/۰۹/۲۴ · ۲ مهر ۱۴۰۵

## محصول و ساختار فنی

نسخه بررسی‌شده admin-main-new با شناسه نسخه 0.18.7-production.2 یک محصول مستقل با رابط React و TypeScript، ساخت Vite و سرویس Python/FastAPI است. لایه بلاک‌چین از Web3 و ابزارهای امضای اتریوم استفاده می‌کند. فایل‌های قرارداد Solidity و خروجی ABI نیز در همین محصول وجود دارند.

پنل مدیر مارکت‌پلیس وظایفی مانند محتوا و تنظیم ارائه‌دهندگان داده دارد؛ Admin Main با نود، Genesis، رأی QBFT و عملیات قرارداد سروکار دارد. استفاده از واژه «مدیر» در هر دو برنامه نباید به معنای اشتراک نشست، حساب یا اختیار آن‌ها تعبیر شود.

## عملیات موجود در سورس

سرویس‌های شبکه برای ساخت تنظیمات، کار با Docker، بازیابی نصب شناخته‌شده، نصب و تشخیص اعتبارسنج راه‌دور و پیگیری عملیات طولانی وجود دارند. زیرسامانه‌های خواندن بلاک، تراکنش، انتقال توکن، اطلاعات قرارداد و شاخص‌های امضاکنندگان از RPC استفاده می‌کنند.

ابزار تشخیص، سلامت فرایند، RPC واقعی، ارتباط همتا، همگام‌سازی، هویت زنجیره و عضویت اجماع را جدا می‌سنجد. تست وضعیت یک مسیر خواندنی است؛ بازیابی یا راه‌اندازی مجدد، عملیات جدا و صریح اپراتور است.

## نقش سازمانی و گردش قرارداد

کنترل‌گر شامل رجیستری سازمان، سیاست تأیید پروژه، تأیید نهایی، کنترل ضرب، توکن فعال، اوراکل، قیمت و درخواست عرضه عمومی است. این مدل مراحل پروژه را ثبت می‌کند، اما صرف تغییر وضعیت محلی معادل انجام یک تراکنش موفق روی زنجیره نیست.

در محیط تولید، ساخت خودکار نقش‌های آزمایشی و امضای شبیه‌سازی‌شده سازمان‌ها غیرفعال می‌شود. تصمیم واقعی باید از مرجع مجاز و مسیر امضای واقعی برسد؛ فعال‌کردن گزینه تولید، اتصال کامل Station و امضاکننده را خودکار ایجاد نمی‌کند.

## پیش‌شرط‌های تولید

محافظ آغاز به کار تولیدی، مسیر داده پایدار، اتصال محدود به loopback، مبدأ عمومی HTTPS، RPC مرجع، Chain ID معتبر، هش Genesis و مبدأهای مجاز مشخص را بررسی می‌کند. توکن برنامه نیز باید پیکربندی شود. CORS با مقدار wildcard برای این حالت پذیرفته نیست.

پروب canonical سپس اتصال، Chain ID، هش بلاک صفر و مجموعه اعتبارسنج‌ها را می‌خواند. خطای این مرحله نباید با داده نمایشی جبران شود. دسترسی بیرونی باید از درگاه مصوب عبور کند و RPC مدیریتی برای کاربران عمومی منتشر نشود.

## آنچه بسته و گزارش اثبات می‌کنند

گزارش پایه تولیدی از موفقیت ۱۴۴ آزمون و ساخت رابط و قراردادها سخن می‌گوید و استقرار سرور را انجام‌نشده اعلام می‌کند. یادداشت 0.18.7-production.2 موفقیت ۱۴۸ آزمون و ساخت را ثبت کرده و نشان می‌دهد healthy بودن کانتینر، موفقیت RPC را تضمین نمی‌کند. این اعداد گزارش تاریخی همان نسخه‌اند؛ در این بررسی دوباره اجرا نشده‌اند.

کد Electron قدیمی در درخت سورس باقی است و به backend اجرایی ویندوز اشاره می‌کند؛ اما package.json نسخه جاری مسیر ساخت و اجرای سروری دارد. حضور آن فایل‌ها مدرک انتشار نصب‌کننده دسکتاپ امضاشده برای نسخه جاری نیست.

## مراجع پیاده‌سازی

- admin-main-new/package.json
- admin-main-new/backend/app/main.py
- admin-main-new/backend/app/services/control_plane_service.py
- admin-main-new/backend/app/production.py
- admin-main-new/electron/main.ts
- admin-main-new/VERIFICATION_NEW_FA.md
- admin-main-new/RELEASE_NOTES_v0.18.7-production.2_FA.md