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 برای فرانتاند جداگانه