# راه‌اندازی و وضعیت عملیاتی پنل

اجزای برنامه، پیش‌نیازها، آزمون‌ها و مرز وضعیت اجرایی.

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

## اجزای برنامه

پنل برنامه‌ای مستقل با React، TypeScript و Vinext است. به Supabase برای هویت کارکنان، داده پروژه و محتوا، سرویس‌های پایگاه داده و رسانه متصل می‌شود. رابط، API، ساخت و کوکی مستقل دارد.

سایت عمومی و پنل باید اتصال درست به پروژه داده موردنظر داشته باشند. نشانی مارکت‌پلیس در راه‌اندازی پنل تعریف می‌شود؛ این مقاله مقدار متغیر محیطی یا شناسه پروژه خصوصی را منتشر نمی‌کند.

## پیش‌نیاز بهره‌برداری

- اتصال پایگاه داده و پیکربندی عمومی مناسب برنامه تنظیم شود.
- مهاجرت‌ها، نقش‌ها، سیاست‌های دسترسی و فضای ذخیره رسانه نصب و بررسی شوند.
- اعضای تیم از مسیر مورد اعتماد تعریف و ورود دومرحله‌ای آن‌ها تکمیل شود.
- ثبت‌خانه، مخزن کلید و اتصال اجرای استعلام‌ها آماده باشد.
- برای Ondo کلید مجاز تهیه شود؛ ذخیره و بررسی دو گام مستقل‌اند.
- پیش از بهره‌برداری عمومی HTTPS، مبدأ و محدودیت درخواست میزبانی تکمیل شود.

## دامنه پیش‌نمایش

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

مدارک واقعی نمایش داده نمی‌شوند و کلیدها، نرخ ارز و پاداش بدون مالک قابل ذخیره نیستند. اتصال پایگاه داده به‌تنهایی ورود موفق کاربر یا اعتبار ارائه‌دهنده را اثبات نمی‌کند.

## آزمون و بررسی

آزمون‌های موجود اعتبارسنجی پروژه و محتوا، ورود و MFA، هویت، دعوت، والکس، نرخ تبدیل و Ondo را پوشش می‌دهند.

آزمون مسیر سرویس از پاسخ کنترل‌شده استفاده می‌کند و موفقیت آن به معنی تماس موفق با ارائه‌دهنده زنده نیست. بررسی واقعی ورود، بارگذاری، انقضا و انتشار به پیکربندی و اعتبارنامه واقعی نیاز دارد.

```sh
npm run typecheck
npm test
npm run build
```

## وضعیت قابل اثبات

گزارش قدیمی راه‌اندازی جای بررسی وضعیت جاری را نمی‌گیرد. برای این مستند هیچ داده عملیاتی، پرونده یا تنظیمی تغییر نکرده است.

| قابلیت | وضعیت |
| --- | --- |
| پروژه و CMS | رابط، اعتبارسنجی و API موجود؛ نوشتن نیازمند اتصال و نقش |
| ورود MFA | جریان پیاده‌سازی شده؛ کاربر باید راه‌اندازی و ورود را کامل کند |
| مدارک و استعلام | رابط و API موجود؛ وابسته به پرونده، مجوز و سرویس |
| والکس و Ondo | ذخیره نسخه‌دار موجود؛ ذخیره تأیید اعتبار کلید نیست |
| سیاست نرخ | فرم مستقل موجود؛ نرخ زنده در مارکت‌پلیس دریافت می‌شود |
| معامله و پرداخت | پنل مسیر اجرای مالی مستقیم ندارد |
| انگلیسی و عربی | ورود ترجمه آماده؛ انتشار رابط این زبان‌ها فعال نیست |

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

- planck-admin/README.md
- planck-admin/package.json
- planck-admin/app/page.tsx
- planck-admin/lib/server.ts
- planck-admin/MFA_SETUP.md
- planck-admin/ONDO_SETUP.md
- planck-admin/tests/admin-auth.test.mjs
- planck-admin/tests/validation.test.mjs
- planck-admin/tests/identity.test.mjs
- planck-admin/tests/referrals.test.mjs
- planck-admin/tests/exchange-rate-settings.test.mjs
- planck-admin/tests/ondo-settings.test.mjs