# دارایی‌ها و پروژه‌های نمونه

شناخت ابزارهای بازار، هویت نمادها و تفاوت آن‌ها با پروژه‌های نمایشی.

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

## پنج دارایی متصل به دادهٔ بازار

| عنوان رابط | نماد توکن | بازار مرجع | توضیح هویت |
| --- | --- | --- | --- |
| تتر | USDT | USDTTMN | تتر در بازار تومان |
| تترگلد | XAUT | XAUTTMN | Tether Gold |
| گواهی نفت دیجیتال | USOON | USOONTMN | United States Oil Fund · Ondo |
| گواهی مس دیجیتال | COPXON | COPXONTMN | Global X Copper Miners · Ondo |
| گواهی نقره دیجیتال | SLVON | SLVONTMN | iShares Silver Trust · Ondo |

## هر نماد چه چیزی را نمایش می‌دهد؟

مبدل بازار، نماد، دارایی پایه و واحد مظنه را به‌صورت دقیق تطبیق می‌دهد. قیمت این پنج بازار به تومان برای هر واحد توکن دریافت می‌شود. عنوان عمومی «نفت»، «مس» یا «نقره» نباید به‌عنوان تعداد بشکه، کیلوگرم یا اونس فیزیکی تفسیر شود؛ ابزارهای USOON، COPXON و SLVON در این اتصال، توکن‌های مرتبط با صندوق هستند.

حجم ۲۴ساعته، حجم معاملات انجام‌شده است. این عدد موجودی فروشنده، کل عرضه یا ظرفیت قطعی قابل خرید نیست. تعداد سفارش‌های دفتر سفارش نیز داده‌ای مستقل از حجم معاملات است.

## نمونه‌های طراحی در مخزن

فایل بذر نمونه، پروژه‌های زیر را با is_demo=true تعریف می‌کند. وجود فایل بذر به معنی نصب آن در هر محیط نیست. بازده‌ها و تصاویر این رکوردها برای نمایش محصول‌اند و نباید در مستندات به‌عنوان سود واقعی بازنشر شوند.

| پروژهٔ نمونه | شناسهٔ مسیر | کاربرد نمایشی |
| --- | --- | --- |
| توسعه نیروگاه خورشیدی | solar-power-revenue | مشارکت مفهومی در جریان درآمد فروش برق؛ نماد نمایشی در بذر بازار eSOL |
| مجتمع فرهنگی تفریحی ایزدشهر | izadshahr-cultural-complex | نمونهٔ توکن املاک و توسعهٔ فرهنگی و تفریحی؛ IZAD |
| اپلیکیشن استور غیرمتمرکز | decentralized-app-store | نمونهٔ استارتاپ و زیرساخت نرم‌افزار؛ DAPP |
| مارکت‌پلیس NFT | nft-marketplace | نمونهٔ بازار آثار و دارایی‌های دیجیتال؛ PNFT |

## تازگی و کیفیت قیمت

در اتصال فعلی، دریافت قیمت روی سرور برای ۲۰ ثانیه همگرا و نگهداری می‌شود؛ صفحات قابل مشاهده هر ۳۰ ثانیه تازه‌سازی می‌شوند. پس از ۹۰ ثانیه، قیمت معتبرِ تازه محسوب نمی‌شود. receivedAt زمان دریافت پاسخ توسط برنامه است، نه زمان آخرین معامله در سامانهٔ ارائه‌دهنده.

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

## نمایش یکپارچه در پلانک

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

دادهٔ کاتالوگ پروژه‌ها و مظنهٔ بازار دو قرارداد جدا دارند. GET /api/catalog پروژه‌ها و محتوای سایت را می‌دهد؛ ابزارهای متصل در رابط با دادهٔ GET /api/markets/wallex ترکیب می‌شوند.

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

- lib/wallex.ts
- lib/wallex-server.ts
- lib/market-assets.ts
- lib/server.ts
- lib/market-preview.ts
- supabase/seeds/20260908_sample_projects.sql
- supabase/seeds/20260908_token_market_samples.sql
- WALLEX_SETUP.md