docs: add session log for 2026-05-13 (guest browsing + top-seller landing sections)
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
masoodafar-web
@@ -0,0 +1,303 @@
|
||||
# TECH-08 — لاگ Session 1404/02/23 (2026-05-13)
|
||||
|
||||
> نوع سند: **گزارش کار**
|
||||
> تاریخ: ۱۴۰۵/۰۲/۲۳
|
||||
> مرتبط با: CMS · FrontOffice
|
||||
> کامیت CMS: `683ed37` (branch: `kub-stage`)
|
||||
> کامیت FrontOffice: `231da2c` (branch: `kub-stage`)
|
||||
|
||||
---
|
||||
|
||||
## فهرست مطالب
|
||||
|
||||
1. [هدف و خلاصه](#هدف-و-خلاصه)
|
||||
2. [تغییرات CMS (Backend)](#تغییرات-cms-backend)
|
||||
3. [تغییرات FrontOffice](#تغییرات-frontoffice)
|
||||
4. [معماری GuestActionGate](#معماری-guestactiongate)
|
||||
5. [فلوچارت تجربه کاربر](#فلوچارت-تجربه-کاربر)
|
||||
6. [فایلهای تغییر یافته](#فایلهای-تغییر-یافته)
|
||||
|
||||
---
|
||||
|
||||
## هدف و خلاصه
|
||||
|
||||
هدف این session:
|
||||
|
||||
1. **نمایش ۶ محصول پرفروش معمولی + ۶ محصول پرفروش فروشگاه اعتباری** در لندینگ پیج FrontOffice، زیر هدر اصلی (۳ محصول در هر ردیف، دو section مجزا).
|
||||
2. **دسترسی guest** (کاربر بدون لاگین) به مرور محصولات برای پرزنت به مشتریان بالقوه.
|
||||
3. **Hybrid auth flow**: کاربر guest محصولات را میبیند؛ اگر روی "افزودن به سبد" کلیک کرد، مودال لاگین باز میشود و پس از ورود موفق، عمل به صورت خودکار انجام میشود.
|
||||
|
||||
---
|
||||
|
||||
## تغییرات CMS (Backend)
|
||||
|
||||
### ۱. `discountproduct.proto`
|
||||
|
||||
```proto
|
||||
// اضافه شده به GetDiscountProductsRequest
|
||||
google.protobuf.StringValue sort_by = 9;
|
||||
|
||||
// اضافه شده به DiscountProductDto
|
||||
int32 sale_count = 12;
|
||||
```
|
||||
|
||||
**چرا:** برای واکشی پرفروشترین محصولات فروشگاه اعتباری باید امکان sort بر اساس `sale_count` وجود داشته باشد. قبلاً این فیلد در DTO برگردانده نمیشد.
|
||||
|
||||
### ۲. `CMSMicroservice.Protobuf.csproj`
|
||||
|
||||
نسخه از `0.0.195` به `0.0.196` بالا رفت تا پکیج NuGet جدید publish شود.
|
||||
|
||||
### ۳. `GetDiscountProductsQuery.cs`
|
||||
|
||||
```csharp
|
||||
public string? SortBy { get; set; }
|
||||
```
|
||||
|
||||
### ۴. `GetDiscountProductsQueryHandler.cs`
|
||||
|
||||
```csharp
|
||||
// قبل: همیشه OrderByDescending(p => p.Created)
|
||||
// بعد: dynamic sort با fallback
|
||||
if (!string.IsNullOrEmpty(request.SortBy))
|
||||
query = query.ApplyOrder(request.SortBy);
|
||||
else
|
||||
query = query.OrderByDescending(p => p.Created);
|
||||
|
||||
// و در SELECT:
|
||||
SaleCount = p.SaleCount,
|
||||
```
|
||||
|
||||
از extension method موجود `ApplyOrder` (کتابخانه `System.Linq.Dynamic.Core`) استفاده شد تا نیازی به تغییر جداگانه نباشد.
|
||||
|
||||
### ۵. `DiscountProductProfile.cs` (Mapster)
|
||||
|
||||
```csharp
|
||||
// Request mapping
|
||||
.Map(dest => dest.SortBy, src => string.IsNullOrEmpty(src.SortBy) ? null : src.SortBy)
|
||||
|
||||
// Response mapping
|
||||
SaleCount = p.SaleCount,
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## تغییرات FrontOffice
|
||||
|
||||
### ۱. `GuestActionGate.cs` (فایل جدید)
|
||||
|
||||
```
|
||||
FrontOffice.Main/Utilities/GuestActionGate.cs
|
||||
```
|
||||
|
||||
سرویس utility جدید که هر action نیازمند لاگین را wrap میکند:
|
||||
|
||||
```csharp
|
||||
public async Task<bool> RunAsync(Func<Task> action)
|
||||
{
|
||||
if (await _authService.IsAuthenticatedAsync())
|
||||
{
|
||||
await action();
|
||||
return true;
|
||||
}
|
||||
await _authDialogService.ShowAuthDialogAsync();
|
||||
if (await _authService.IsAuthenticatedAsync())
|
||||
{
|
||||
await action();
|
||||
return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
```
|
||||
|
||||
در `ConfigureServices.cs` به صورت Scoped ثبت شد:
|
||||
|
||||
```csharp
|
||||
services.AddScoped<GuestActionGate>();
|
||||
```
|
||||
|
||||
### ۲. `ProductService.cs`
|
||||
|
||||
```csharp
|
||||
public Task<ProductListResult> GetTopSellingAsync(int count = 6)
|
||||
=> GetProductsPagedAsync(sortBy: "SaleCount desc", page: 1, pageSize: count);
|
||||
```
|
||||
|
||||
### ۳. `DiscountProductService.cs`
|
||||
|
||||
```csharp
|
||||
// پارامتر جدید به GetProductsAsync اضافه شد
|
||||
public async Task<DiscountProductListResult> GetProductsAsync(
|
||||
..., string? sortBy = null)
|
||||
{
|
||||
if (!string.IsNullOrWhiteSpace(sortBy))
|
||||
request.SortBy = sortBy;
|
||||
...
|
||||
}
|
||||
|
||||
public Task<DiscountProductListResult> GetTopSellingAsync(int count = 6)
|
||||
=> GetProductsAsync(page: 1, pageSize: count, sortBy: "SaleCount desc");
|
||||
```
|
||||
|
||||
### ۴. `Index.razor` و `Index.razor.cs`
|
||||
|
||||
دو section جدید در لندینگ پیج زیر hero اضافه شد:
|
||||
|
||||
**Section 1 — محصولات پرفروش معمولی:**
|
||||
- عنوان: "محصولات پرفروش"
|
||||
- ۶ کارت (۳ در هر ردیف با MudGrid)
|
||||
- هر کارت: تصویر، نام، قیمت با VAT، دکمه "افزودن به سبد"
|
||||
- دکمه "بیشتر" → `/products`
|
||||
|
||||
**Section 2 — محصولات پرفروش فروشگاه اعتباری:**
|
||||
- عنوان: "فروشگاه اعتباری"
|
||||
- ۶ کارت (۳ در هر ردیف)
|
||||
- هر کارت: تصویر، نام، قیمت، درصد تخفیف
|
||||
- دکمه "بیشتر" → `/discount-store`
|
||||
|
||||
**Loading state:** در حین بارگذاری یک spinner نشان داده میشود و سپس sectionها fade-in میشوند.
|
||||
|
||||
**Data loading (parallel):**
|
||||
```csharp
|
||||
var topRegTask = ProductService.GetTopSellingAsync(6);
|
||||
var topDiscTask = DiscountProductService.GetTopSellingAsync(6);
|
||||
var featuredPostsTask = BlogPostService.GetFeaturedPostsAsync(2);
|
||||
await Task.WhenAll(topRegTask, topDiscTask, featuredPostsTask);
|
||||
```
|
||||
|
||||
**Cart actions با GuestActionGate:**
|
||||
```csharp
|
||||
private async Task AddRegularToCart(Product p)
|
||||
=> await GuestGate.RunAsync(() => Cart.Add(p, 1));
|
||||
|
||||
private async Task AddDiscountToCart(DiscountProductCard p)
|
||||
=> await GuestGate.RunAsync(() => DiscountCart.AddAsync(p.Id));
|
||||
```
|
||||
|
||||
### ۵. Hybridize کردن صفحات موجود
|
||||
|
||||
#### صفحات لیست و جزئیات محصول (GuestActionGate):
|
||||
|
||||
| فایل | تغییر |
|
||||
|------|-------|
|
||||
| `Store/Products.razor.cs` | `AddToCart` → `GuestGate.RunAsync(...)` |
|
||||
| `Store/ProductDetail.razor.cs` | `AddToCart` و `RemoveFromCart` → `GuestGate.RunAsync(...)` |
|
||||
| `DiscountStore/Products.razor.cs` | `AddToCart` → `GuestGate.RunAsync(...)` |
|
||||
| `DiscountStore/ProductDetail.razor.cs` | `AddToCart` → `GuestGate.RunAsync(...)` |
|
||||
|
||||
#### صفحات Cart و Checkout (Soft Auth Gate):
|
||||
|
||||
```csharp
|
||||
protected override async Task OnInitializedAsync()
|
||||
{
|
||||
if (!await AuthService.IsAuthenticatedAsync())
|
||||
{
|
||||
await AuthDialogService.ShowAuthDialogAsync();
|
||||
}
|
||||
// ادامه بارگذاری...
|
||||
}
|
||||
```
|
||||
|
||||
این pattern روی:
|
||||
- `Store/Cart.razor.cs`
|
||||
- `Store/CheckoutSummary.razor.cs`
|
||||
- `DiscountStore/Cart.razor.cs`
|
||||
- `DiscountStore/Checkout.razor.cs`
|
||||
|
||||
اعمال شد. اگر guest مستقیماً وارد سبد خرید شود، مودال لاگین نشان داده میشود.
|
||||
|
||||
### ۶. `MembershipPage.razor` (fix متنی)
|
||||
|
||||
```diff
|
||||
- شارژ ۵۶ میلیون تومان کیف پول فروشگاه اعتباری
|
||||
+ شارژ برابر ارزش پکیج فعال در کیف پول فروشگاه اعتباری
|
||||
```
|
||||
|
||||
متن hardcodeشده با مقدار دینامیک جایگزین شد.
|
||||
|
||||
---
|
||||
|
||||
## معماری GuestActionGate
|
||||
|
||||
```
|
||||
کاربر کلیک میکند
|
||||
│
|
||||
▼
|
||||
GuestActionGate.RunAsync(action)
|
||||
│
|
||||
├─► آیا لاگین است؟ ──YES──► action() اجرا میشود ✅
|
||||
│
|
||||
NO
|
||||
│
|
||||
▼
|
||||
AuthDialogService.ShowAuthDialogAsync()
|
||||
(مودال OTP باز میشود)
|
||||
│
|
||||
├─► آیا لاگین شد؟ ──YES──► action() اجرا میشود ✅
|
||||
│
|
||||
NO (بستن مودال)
|
||||
│
|
||||
▼
|
||||
return false (هیچ اتفاقی نمیافتد) ❌
|
||||
```
|
||||
|
||||
این pattern **defense-in-depth** است: `CartService.Add` هم به تنهایی چک `IsAuthenticatedAsync` دارد؛ `GuestActionGate` لایه UX روی آن اضافه میکند.
|
||||
|
||||
---
|
||||
|
||||
## فلوچارت تجربه کاربر
|
||||
|
||||
```
|
||||
کاربر وارد لندینگ پیج میشود (بدون لاگین)
|
||||
│
|
||||
├─► ۶ محصول پرفروش معمولی نمایش داده میشود
|
||||
├─► ۶ محصول پرفروش اعتباری نمایش داده میشود
|
||||
│
|
||||
├─► "بیشتر" کلیک → /products یا /discount-store
|
||||
│ (صفحات لیست کامل، بدون لاگین قابل مرور)
|
||||
│
|
||||
├─► روی محصول کلیک → صفحه جزئیات
|
||||
│ (بدون لاگین قابل مشاهده)
|
||||
│
|
||||
└─► "افزودن به سبد" کلیک
|
||||
│
|
||||
▼
|
||||
مودال لاگین (OTP)
|
||||
│
|
||||
├─► ورود موفق → محصول به سبد اضافه میشود ✅
|
||||
└─► بستن مودال → هیچ اتفاقی نمیافتد
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## فایلهای تغییر یافته
|
||||
|
||||
### CMS — کامیت `683ed37`
|
||||
|
||||
```
|
||||
src/CMSMicroservice.Protobuf/Protos/discountproduct.proto (+2)
|
||||
src/CMSMicroservice.Protobuf/CMSMicroservice.Protobuf.csproj (~2)
|
||||
src/CMSMicroservice.Application/DiscountShopCQ/Queries/
|
||||
GetDiscountProducts/GetDiscountProductsQuery.cs (+1)
|
||||
GetDiscountProducts/GetDiscountProductsQueryHandler.cs (+7 -3)
|
||||
src/CMSMicroservice.WebApi/Common/Mappings/DiscountProductProfile.cs (+3)
|
||||
```
|
||||
|
||||
### FrontOffice — کامیت `231da2c`
|
||||
|
||||
```
|
||||
src/FrontOffice.Main/Utilities/GuestActionGate.cs (NEW +42)
|
||||
src/FrontOffice.Main/ConfigureServices.cs (+1)
|
||||
src/FrontOffice.Main/Utilities/ProductService.cs (+3)
|
||||
src/FrontOffice.Main/Utilities/DiscountProductService.cs (+8)
|
||||
src/FrontOffice.Main/Pages/Index.razor (+~180)
|
||||
src/FrontOffice.Main/Pages/Index.razor.cs (+45)
|
||||
src/FrontOffice.Main/Pages/Store/Products.razor.cs (+5)
|
||||
src/FrontOffice.Main/Pages/Store/ProductDetail.razor.cs (+5)
|
||||
src/FrontOffice.Main/Pages/Store/Cart.razor.cs (+8)
|
||||
src/FrontOffice.Main/Pages/Store/CheckoutSummary.razor.cs (+8)
|
||||
src/FrontOffice.Main/Pages/DiscountStore/Products.razor.cs (+5)
|
||||
src/FrontOffice.Main/Pages/DiscountStore/ProductDetail.razor.cs (+5)
|
||||
src/FrontOffice.Main/Pages/DiscountStore/Cart.razor.cs (+8)
|
||||
src/FrontOffice.Main/Pages/DiscountStore/Checkout.razor.cs (+8)
|
||||
src/FrontOffice.Main/Pages/Club/MembershipPage.razor (~1)
|
||||
```
|
||||
Reference in New Issue
Block a user