# معماری محصولات و جریان داده

مرز مسئولیت مارکت‌پلیس، مدیریت وب، منابع داده و شبکهٔ پلانک.

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

## لایه‌های مستقل سامانه

| لایه | مسئولیت | مرز دسترسی |
| --- | --- | --- |
| رابط عمومی | نمایش پروژه‌های منتشرشده، جستجو و ابزارهای مقایسه | فقط اطلاعات عمومی |
| API مارکت‌پلیس | کاتالوگ، نشست مشتری، دادهٔ حساب و بازار | کنترل دسترسی متناسب با مسیر |
| مدیریت وب | ویرایش محتوا و دارایی، مدیریت اتصال و بازبینی | نشست مدیر، MFA و نقش |
| Supabase / PostgreSQL | دادهٔ ساختاریافته، Auth، Storage و سیاست‌های RLS | سیاست پایگاه داده و توابع محدود |
| ارائه‌دهندهٔ بیرونی | قیمت، هویت، بانک یا پیامک | فراخوانی سرور به سرور در اتصال مربوط |
| شبکه و ابزار نود | عملیات Besu، مشاهدهٔ سلامت و نقش ولیدیتور | پیکربندی و مجوز شبکه؛ مستقل از حساب وب |

## از پنل تا نمایش عمومی

پروژه‌ها از وضعیت پیش‌نویس تا انتشار در مدیریت کنترل می‌شوند. نمایش عمومی باید به رکوردهای مجاز محدود بماند؛ برچسب نمونه، وضعیت انتشار، اسناد و ریسک‌ها جزئی از معرفی دارایی‌اند. قیمت و ظرفیت معتبر باید در عملیات مالی سمت سرور دوباره بررسی شوند؛ محاسبهٔ مرورگر جای آن را نمی‌گیرد.

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

## قیمت بازار و نرخ تبدیل

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

واحد ریال، تومان، دلار و نماد توکن را همواره همراه عدد نگه دارید. فارسی‌سازی و جداکردن هزارگان برای نمایش است و نباید دقت مقدار یا واحد حسابداری را تغییر دهد.

## مرز هویت مشتری و هویت شبکه

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

## مرز کد، انتشار و عملیات

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

> اتصال انتهابه‌انتها: صدور دارایی، تسویه، اجرای واقعی کپی‌ترید و یکپارچگی کامل چرخهٔ مالی به تکمیل سرویس‌ها و تأیید عملیاتی نیاز دارند؛ در نقشهٔ راه جداگانه آمده‌اند.

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

- planck-marketplace/lib/server.ts
- planck-marketplace/lib/wallex-server.ts
- planck-marketplace/lib/storefront.ts
- planck-admin/README.md