admin/docs

Files

T

masoodafar-web b861b66cda docs: fix Regular Store payment — wallet-only, no IPG/ZarinPal

- Regular Store: Balance deduction only (SubmitShopBuyOrderCommandHandler)
  NO ZarinPal redirect, NO payment gateway
- Discount Store: DiscountBalance + ZarinPal IPG for remainder
  Added gatewayAmount=0 edge case (discount covers 100%)
- VAT: Both stores use 9% (ShopVAT=0.1 is stale/unused constant)
- Added ZarinPal usage scope note (only: Discount Store, Wallet Top-up, Package Purchase)
- Fixed BUSINESS-02: sections 2, 5.2, 5.3, 7
- Fixed BUSINESS-03: store comparison chart
- Fixed OVERVIEW-01: user journey + both store flowcharts
- Fixed OVERVIEW-03: timeline entry

2026-02-18 23:52:35 +03:30

8.6 KiB

Raw Blame History

📜 تاریخچه کارهای انجام‌شده

همه فعالیت‌های پروژه به صورت بولت با توضیح یک‌خطی و درصد تکمیل
آخرین بروزرسانی: اسفند ۱۴۰۴

خلاصه کلی

حوزه	تعداد آیتم	تکمیل‌شده	درصد کل
BackOffice	58	57	98%
FrontOffice	35	32	91%
CMS Core	45	42	93%
Deployment	20	18	90%
Migration	15	15	100%
مجموع	173	164	95%

۱. BackOffice — فازها (98% کامل)

Phase 1-3: پایه و ساختار

✅ ارتقا به MudBlazor v8 — تغییر تمام کامپوننت‌ها به API جدید
✅ پیاده‌سازی MainLayout با Drawer و AppBar — RTL support
✅ ایجاد NavMenu با آیکون‌ها و گروه‌بندی — دسته‌بندی منطقی
✅ پیاده‌سازی الگوی Code-behind — جدا کردن logic از markup
✅ اضافه کردن Theme سفارشی — رنگ‌ها و فونت Vazirmatn

Phase 4-6: محصولات و فروشگاه

✅ صفحه لیست محصولات — MudDataGrid با pagination
✅ فرم ایجاد/ویرایش محصول — MudForm با FluentValidation
✅ آپلود تصویر محصول — Drag & drop با preview
✅ مدیریت دسته‌بندی‌ها — CRUD درختی
✅ AppImage کامپوننت — تصاویر مربعی ۱:۱ همه‌جا

Phase 7-9: سفارشات و مالی

✅ لیست سفارشات — فیلتر وضعیت، تاریخ، مبلغ
✅ جزئیات سفارش — آیتم‌ها + تراکنش‌ها
✅ تغییر وضعیت سفارش — با تأیید دیالوگ
✅ گزارش مالی — خلاصه تراکنش‌ها

Phase 10-12: کاربران و باشگاه

✅ لیست کاربران — جستجو + فیلتر نقش
✅ مدیریت عضویت باشگاه — فعال/غیرفعال
✅ نمای درخت شبکه — نمایش باینری با سطوح
✅ مدیریت کمیسیون — مشاهده Pool هفتگی

Phase 13-15: محتوا و تنظیمات

✅ مدیریت بلاگ — CRUD پست‌ها با ادیتور HTML
✅ مدیریت صفحات سایت — Shopify-style typed editors
✅ HomePageEditor — ویرایش Hero, Featured, Promotion
✅ AboutPageEditor — ویرایش متن درباره‌ما
✅ ContactPageEditor — اطلاعات تماس
✅ LicensesPageEditor — مجوزها
✅ ادیتور SystemConstants — تنظیمات key-value

Phase 16-17: موجودی و نهایی‌سازی

✅ صفحه موجودی — با MudAutocomplete برای انتخاب محصول
✅ ایجاد خودکار رکورد موجودی — هنگام ساخت محصول
✅ Hangfire InventorySync — ایجاد رکوردهای گمشده
⬜ Dark Mode — طراحی نشده (Phase آینده)

۲. FrontOffice — فازها (91% کامل)

UI Modernization Phase 1-3

✅ ارتقا به MudBlazor v8 — همه کامپوننت‌ها
✅ MainLayout جدید — Header + Footer + RTL
✅ AuthLayout — صفحات Login/Register
✅ Landing Page — Hero + Features + Counter + CTA
✅ اصلاح انیمیشن Counter — linear interpolation

فروشگاه (Phase 4-5)

✅ Regular Store — لیست محصولات با Lazy Load (12/page)
✅ Discount Store — لیست با Lazy Load + hybrid payment
✅ ProductCard مشترک — تصویر مربعی + قیمت + دکمه
✅ CategoryFilter — فیلتر دسته‌بندی sidebar
✅ ProductDetail — جزئیات + تصویر بزرگ + سبد
✅ سبد خرید — Regular + Discount جداگانه
✅ Checkout — پرداخت ZarinPal + ترکیبی

باشگاه (Phase 6)

✅ داشبورد باشگاه — ۳ کیف‌پول + آمار
✅ نمای درخت شبکه — باینری بصری
✅ امضای قرارداد — OTP + scroll-to-bottom
✅ صفحه Chatika — چت AI

محتوا و ناوبری

✅ بلاگ — لیست + جزئیات + pagination
✅ صفحات سایت — About, Contact, FAQ, Terms, Privacy, Licenses
✅ ناوبری Auth-Aware — مسیردهی بر اساس نقش
✅ Home → Club Dashboard / Store بر اساس وضعیت
⬜ Mobile Responsive — Phase 7 (برنامه‌ریزی‌شده)
⬜ PWA — نیاز به Service Worker
⬜ Bottom Navigation (موبایل) — طراحی نشده

۳. CMS Core (93% کامل)

ساختار و معماری

✅ CQRS با MediatR — Commands + Queries + Handlers
✅ gRPC Services — ۱۱ سرویس اصلی
✅ EF Core 9 — Migrations + Seeding
✅ Hangfire — ۴ Background Job
✅ JWT Authentication — Claims-based
✅ ICurrentUserService — جداسازی Admin/Customer

محصولات و فروشگاه

✅ Product CRUD — با auto-inventory
✅ Category CRUD — درختی
✅ Inventory management — auto-create + sync job
✅ GetProductsPaged — با PaginationState
✅ File upload/download — streaming gRPC

مالی و پرداخت

✅ ZarinPal Integration — IPG + Verify
✅ PYMS Service — سرویس مرکزی پرداخت
✅ ۳ Wallet System — Balance, Network, Discount
✅ Transaction logging — همه تراکنش‌ها

باشگاه

✅ Binary Tree — SP_GetNetworkTree
✅ Weekly Balance Calculation — sp_CalculateWeeklyBalances
✅ Commission Pool — sp_CalculateWeeklyCommissionPool
✅ Contract System — OTP + acceptance
✅ Club Features — activate/deactivate
✅ DayaLoan Integration — Hangfire + Polly

محتوا

✅ Blog CRUD — با pagination
✅ SitePage Settings — JSON typed
✅ SystemConfigurations — key-value
⬜ Product Bundle — طراحی‌شده، پیاده‌سازی نشده
⬜ Manual Payment — طراحی‌شده، پیاده‌سازی نشده
⬜ API Rate Limiting — برنامه‌ریزی‌شده

۴. Deployment و زیرساخت (90% کامل)

✅ Docker Compose — تمام سرویس‌ها
✅ Dockerfile (CMS) — multi-stage build
✅ K8s Manifests — Deployment + Service + Ingress
✅ CI/CD Pipeline — Gitea Actions
✅ Nexus Repository — NuGet + Docker proxy
✅ Offline Deployment — کامل با اسکریپت‌ها
✅ Proto Package — NuGet packaging + distribution
✅ Health Check scripts — K8s + service
✅ Mirror Configuration — Docker + NuGet
✅ Base Image Caching — pull + save + load
⬜ Monitoring (Prometheus/Grafana) — برنامه‌ریزی‌شده
⬜ Log Aggregation (ELK/Seq) — برنامه‌ریزی‌شده

۵. Migration (100% کامل)

✅ FrontOffice REST → gRPC — همه سرویس‌ها migrate شدند
✅ BackOffice REST → gRPC — همه سرویس‌ها migrate شدند
✅ BFF حذف — یک لایه کمتر در deployment
✅ API Gateway (Ocelot) حذف — K8s Ingress جایگزین
✅ Data Migration — Users, Products, Orders, Club
✅ Geography Seeder — ۳۱ استان + ۱۲۰۰ شهر
✅ SQL Scripts — ۱۴ اسکریپت مهاجرت اجرا شدند
✅ Proto Package Unification — یک package مشترک
✅ Binary Tree Reconstruction — از سیستم قدیم

۶. مستندات (100% کامل)

✅ ایجاد totalDoc repository — مخزن مرکزی docs
✅ جمع‌آوری ۵۳ فایل از ۵ مخزن مختلف
✅ تجمیع به ۱۵ فایل ساختارمند — Business + Technical + Overview
✅ Index و Cross-reference — نقشه ارتباطات
✅ واژه‌نامه و استانداردها
✅ نقشه راه آینده

۷. Timeline (جدول زمانی)

زمان	رویداد	درصد پروژه
مهر ۱۴۰۳	شروع پروژه، معماری CMS	10%
آبان ۱۴۰۳	CQRS + gRPC + EF Core	20%
آذر ۱۴۰۳	باشگاه + درخت باینری + کمیسیون	35%
دی ۱۴۰۳	فروشگاه عادی + پرداخت از کیف‌پول	45%
بهمن ۱۴۰۳	فروشگاه تخفیفی + وام دایا	55%
اسفند ۱۴۰۳ (هفته ۱)	UI Modernization Phase 1-3	65%
اسفند ۱۴۰۳ (هفته ۲)	Site Pages + BackOffice audit	75%
اسفند ۱۴۰۳ (هفته ۳)	Inventory + Lazy Load + Images	85%
اسفند ۱۴۰۳ (هفته ۴)	مستندات + نهایی‌سازی	95%

8.6 KiB Raw Blame History Unescape Escape

📜 تاریخچه کارهای انجام‌شده

خلاصه کلی

۱. BackOffice — فازها (98% کامل)

Phase 1-3: پایه و ساختار

Phase 4-6: محصولات و فروشگاه

Phase 7-9: سفارشات و مالی

Phase 10-12: کاربران و باشگاه

Phase 13-15: محتوا و تنظیمات

Phase 16-17: موجودی و نهایی‌سازی

۲. FrontOffice — فازها (91% کامل)

UI Modernization Phase 1-3

فروشگاه (Phase 4-5)

باشگاه (Phase 6)

محتوا و ناوبری

۳. CMS Core (93% کامل)

ساختار و معماری

محصولات و فروشگاه

مالی و پرداخت

باشگاه

محتوا

۴. Deployment و زیرساخت (90% کامل)

۵. Migration (100% کامل)

۶. مستندات (100% کامل)

۷. Timeline (جدول زمانی)

8.6 KiB

Raw Blame History