رفتن به محتوای اصلی
← بازگشت به پروژه‌ها
تصویر واقعی صفحه اصلی فروشگاه GlobalCart 07 / POOYA LABS
PROJECT / 07شبیه‌ساز مارکت‌پلیس

GlobalCart

در حال توسعه · ۰٫۲٫۳-dev / M09.6

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

Next.jsReactTypeScriptPlaywright
UI /تصاویر واقعی رابط کاربری
تصویر رابط کاربری صفحه اصلی GlobalCart در اندازه موبایل
نمای واقعی فروشگاه روی موبایل
01 /مسئله

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

02 /راهکار و رویکرد

یک marketplace simulation با Next.js و React ساخته شده که از snapshot محلی کاتالوگ، تصاویر self-host شده و منطق قیمت‌گذاری دقیق استفاده می‌کند. رابط فارسی RTL و انگلیسی LTR دارد.

03 /نقش و انتساب

README، پویا را Owner و Product Engineer معرفی می‌کند.

04 /معماری فنی

Frontend Next.js 15/React 19/TypeScript روی Pages به‌صورت static منتشر می‌شود. دو جریان کاتالوگ جدا هستند: snapshot محلی ۱۰۰۰ محصول ABO با گالری WebP self-hosted، و discovery زمان‌اجرا از Shopify Global Catalog از مسیر Worker محدود و no-store که نتیجه/تصویر را ذخیره نمی‌کند. Go REST/OpenAPI و PostgreSQL 17 با migration و sqlc برای local development/CI است، نه backend production میزبانی‌شده.

دو منبع کاتالوگ و سبد آزمایشی
snapshot محلی و discovery زمان‌اجرا جدا هستند؛ Shopify cache نمی‌شود و cart نمایشی است
05 /جزئیات پیاده‌سازی
  • 01Category mega-menu، search، filter، sort، quick view، favorites، recently viewed و مقایسه تا چهار کالا.
  • 02صفحات static جزئیات محصول و gallery چندتصویری با thumbnail و کنترل قبلی/بعدی.
  • 03در ABO، sale price/rating/stock که منبع فراهم نمی‌کند unavailable می‌ماند؛ مقدار ساختگی درج نمی‌شود.
  • 04در Shopify، نام فروشنده، listing URL و price/availability ارائه‌شده توسط فروشنده حفظ می‌شوند.
  • 05cart، checkout، order و return/refund صرفاً شبیه‌سازی یا local هستند.
  • 06قیمت‌گذاری decimal-safe و نرخ USD منبع TGJU با تبدیل Rial به Toman و برچسب freshness.
  • 07Backend محلی با Go، PostgreSQL، ۲۷ جدول، OpenAPI و sqlc؛ APIهای عمومی موجود read-only هستند.
06 /تصمیم‌های مهندسی
  • 01این نسخه پرداخت، سفارش، رزرو موجودی یا fulfillment واقعی ندارد؛ cart و checkout صرفاً نمایشی‌اند.
  • 02snapshot ABO با attribution و مجوز CC BY 4.0 ارائه می‌شود؛ فیلدهای غایب جعل نمی‌شوند.
  • 03Shopify runtime discovery با سیاست no-cache/no-rehost کار می‌کند؛ seller identity و listing link پنهان نمی‌شود.
  • 04translation خودکار paused است؛ feed جدید نیازمند بررسی حقوق، terms، quality و freshness است.
  • 05Go/PostgreSQL هنوز local/CI است و hosted production API ادعا نمی‌شود.
07 /تست و شواهد اعتبارسنجی
  • 01README وضعیت 0.2.3-dev و مرحله M09.6 را نشان می‌دهد؛ 1.0.0 تا تأیید و QA دستی ممنوع است.
  • 02Lighthouse lab run 42054988939 و Shopify Catalog Smoke run 42054988648 روی HEAD فعلی موفق بودند؛ Lighthouse نتایج lab است نه Core Web Vitals میدانی.
  • 03Browser E2E run 42054626880 روی commit پیشین هنگام بررسی هنوز در حال اجرا بود؛ Pages run 42054627186 همان commit پیشین را منتشر کرد.
  • 04manual screen reader، دستگاه فیزیکی، RTL/LTR انسانی و شبکه/field QA همچنان release gate هستند.
09 /قابلیت‌ها و نکات فنی
  • 01کاتالوگ محلی ۱۰۰۰ محصول و صفحات جزئیات static
  • 02گالری چندتصویری با thumbnail و کنترل قبلی/بعدی
  • 03جست‌وجو، فیلتر، مرتب‌سازی، مقایسه و favorites
  • 04بارگذاری مستقل پوسته فروشگاه از تصاویر و lazy loading
  • 05Case study دو‌زبانه همراه با معماری و ERD
10 /محدوده و محدودیت‌ها

این پروژه شبیه‌ساز مارکت‌پلیس است، نه فروشگاه زنده. پرداخت، موجودی واقعی، رزرو کالا، ارسال، تسویه فروشنده و بازپرداخت پول انجام نمی‌شود؛ نسخه ۰٫۲٫۳ هنوز نیازمند QA دستی پیش از انتشار ۱٫۰ است.