همه‌ی پروژه‌ها
فروشگاهی (E-Commerce) در حال توسعه

Digichera

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

نقش من
توسعه‌دهنده (Full-Stack)
نوع
پروژه شخصی
لینک‌ها

پروژه دیجی‌چرا (Digichera) با ایده‌ای سرگرم‌کننده برای عرضه عجیب‌ترین و جذاب‌ترین کالاها آغاز شد و به‌تدریج به یک مارکت‌پلیس چندفروشنده حرفه‌ای با الهام از پلتفرم‌هایی نظیر دیجی‌کالا و باسلام تبدیل گردید.

معماری این پروژه به‌جای ساختار یکپارچه (Monolith)، بر پایه اپلیکیشن‌های کوچک، مستقل و ماژولار جنگو طراحی شده است که هر کدام وظیفه مشخصی را بر عهده دارند. کاربران تنها با شماره تلفن ثبت‌نام کرده و نقش خود را (مشتری یا فروشنده) انتخاب می‌کنند.

کارهایی که انجام دادم

  • احراز هویت مبتنی بر شماره تلفن: مدل کاربر سفارشی بدون نیاز به نام‌کاربری یا ایمیل؛ نقش‌های customer و seller هنگام ثبت‌نام توسط کاربر انتخاب می‌شوند و دسترسی staff صرفاً از طریق پنل ادمین جنگو مدیریت می‌گردد.
  • ثبت سفارش چندفروشنده‌ای: تفکیک خودکار یک سبد خرید واحد به سفارش‌های (Order) مجزا برای هر فروشگاه، همراه با آیتم‌های اختصاصی و snapshot از آدرس ارسال پروفایل مشتری.
  • تضمین ایمنی موجودی (Stock-Safe): اجرای کامل چرخه تسویه حساب در بلاک transaction.atomic()، بررسی مجدد موجودی کالا پیش از ساخت سفارش و قفل‌کردن ردیف‌های محصول در دیتابیس PostgreSQL با select_for_update().
  • سبد خرید مهمان و کاربر: مدیریت سبد خرید کاربران مهمان در سشن و ادغام شفاف آن با سبد حساب کاربری پس از ورود یا ثبت‌نام.
  • چرخه حیات سفارش: کنترل وضعیت‌ها از pending → paid → shipped → delivered با محدودسازی دسترسی فروشندگان تنها به سفارش‌های فروشگاه خودشان.
  • مدیریت فروشگاه و تصاویر: ایجاد فروشگاه با slug خودکار و پردازش، فشرده‌سازی و تغییر اندازه لوگو و تصاویر محصولات به کمک کتابخانه Pillow.
  • دسته‌بندی تو در تو: درخت دسته‌بندی خودارجاع با مکانیزم محافظت در برابر حلقه (جلوگیری از والد شدن دسته برای خودش توسط متد clean()) و حذف نرم (Soft-delete) آبشاری.
  • کنترل دسترسی پیشرفته: محافظت از ویوهای مدیریت فروشگاه و محصول با دکوراتورهای سفارشی store_required و store_owner_required.

ساختار پروژه

کد پروژه در قالب اپلیکیشن‌های مستقل جنگو سازمان‌دهی شده است:

  • core — مدل‌های abstract مشترک و دکوراتورهای کنترل دسترسی
  • user — مدل کاربر سفارشی مبتنی بر شماره تلفن و ویوهای احراز هویت
  • account — پروفایل مشتری شامل آدرس، کدپستی و آواتار
  • store — مدیریت فروشگاه‌های فروشندگان
  • product — دسته‌بندی‌ها، محصولات و تصاویر محصول
  • cart — مدیریت سبد خرید مهمان و کاربر
  • order — ثبت سفارش، تفکیک سبد، آیتم‌ها و تغییر وضعیت‌ها
  • page — صفحات عمومی (خانه، درباره ما، تماس و صفحه پرداخت)

تست‌نویسی

توسعه تست‌ها با استفاده از pytest-django و factory-boy انجام شده است. زیرساخت تست شامل تنظیمات ایزوله، فیکسچرهای مشترک و فکتوری‌ها برای تمام اپ‌هاست. تاکنون تست‌های دکوراتورهای دسترسی، مدیریت کاربر، سیگنال‌ها، ویوهای احراز هویت و ادغام سبد خرید پیاده‌سازی شده و تست سایر بخش‌ها در دستور کار قرار دارد.

قدم‌های بعدی

  • اتصال به درگاه پرداخت واقعی (جایگزینی mock فعلی که سفارش را بلافاصله پرداخت‌شده علامت می‌زند)
  • پیاده‌سازی صفحه‌بندی (pagination)، حذف محصول توسط فروشنده و داشبورد اختصاصی فروشنده فراتر از پنل ادمین جنگو
  • کشینگ و محدودسازی نرخ درخواست (rate-limiting) روی اندپوینت‌های احراز هویت و ثبت سفارش
  • راه‌اندازی CI با GitHub Actions، گزارش پوشش تست (coverage) و لایه REST API برای فرانت‌اند جداگانه

تکنولوژی‌ها

  • Python
  • Django 6.0
  • PostgreSQL
  • SQLite
  • Pillow
  • Bootstrap
  • django-localflavor
  • python-decouple
  • pytest-django
  • Factory Boy

پروژه‌های دیگر