masoodafar-web
408 lines
14 KiB
Markdown
408 lines
14 KiB
Markdown
# 🔴 TODO: کدهای کامنت شده که باید تکمیل شوند
|
|
|
|
> تاریخ: ۱۴ آذر ۱۴۰۴
|
|
>
|
|
> این فایل لیست کامل کدهایی است که برای Build موفق، موقتا کامنت شدهاند.
|
|
|
|
---
|
|
|
|
## ❌ مشکل اصلی: Protobuf ناقص در FrontOffice.BFF
|
|
|
|
تمام مشکلات زیر به دلیل **عدم وجود Protobuf packages** برای ماژولهای جدید است.
|
|
|
|
---
|
|
|
|
## 1️⃣ WalletService.cs (4 متد کامنت شده)
|
|
|
|
📁 مسیر: `/FrontOffice/src/FrontOffice.Main/Utilities/WalletService.cs`
|
|
|
|
### متد 1: GetBalancesAsync() - خط 27
|
|
```csharp
|
|
// TODO: DiscountBalance will be added in BFF protobuf later
|
|
return new WalletBalances(response.Balance, 0 /* response.DiscountBalance */, response.NetworkBalance);
|
|
```
|
|
|
|
**مشکل**: `GetUserWalletResponse` در protobuf فعلی `DiscountBalance` ندارد
|
|
|
|
**راه حل**:
|
|
```
|
|
1. به FrontOffice.BFF.UserWallet.Protobuf بروید
|
|
2. فایل userwallet.proto را باز کنید
|
|
3. به message GetUserWalletResponse اضافه کنید:
|
|
int64 discount_balance = 3;
|
|
4. Protobuf را rebuild و publish کنید
|
|
5. در WalletService uncomment کنید
|
|
```
|
|
|
|
---
|
|
|
|
### متد 2: GetTransactionsAsync() - خط 42-75
|
|
```csharp
|
|
// TODO: Implement when BFF protobuf has GetAllUserWalletChangeLog
|
|
await Task.CompletedTask;
|
|
return new List<WalletTransaction>();
|
|
/*
|
|
var request = new GetAllUserWalletChangeLogRequest();
|
|
// ... کد کامل کامنت شده
|
|
*/
|
|
```
|
|
|
|
**مشکل**: متد `GetAllUserWalletChangeLog` در `UserWalletContract` وجود ندارد
|
|
|
|
**راه حل**:
|
|
```
|
|
1. به FrontOffice.BFF.Application/UserWalletCQ بروید
|
|
2. Query جدید بسازید: GetAllUserWalletChangeLog
|
|
- Request: ReferenceId?, IsIncrease?
|
|
- Response: List<WalletChangeLogDto>
|
|
3. به userwallet.proto اضافه کنید:
|
|
rpc GetAllUserWalletChangeLog(GetAllUserWalletChangeLogRequest) returns (GetAllUserWalletChangeLogResponse);
|
|
4. Handler را پیاده کنید با فراخوانی CMS
|
|
5. Protobuf را rebuild/publish کنید
|
|
6. در WalletService uncomment کنید
|
|
```
|
|
|
|
---
|
|
|
|
### متد 3: RequestWithdrawalAsync() - خط 107-127
|
|
```csharp
|
|
public async Task<bool> RequestWithdrawalAsync(long payoutId, WithdrawalMethodClient method, string? iban)
|
|
{
|
|
// TODO: Implement when BFF protobuf has WithdrawBalance
|
|
await Task.CompletedTask;
|
|
return false;
|
|
/*
|
|
var request = new WithdrawBalanceRequest { ... };
|
|
await _client.WithdrawBalanceAsync(request);
|
|
*/
|
|
}
|
|
```
|
|
|
|
**مشکل**: متد `WithdrawBalance` در `UserWalletContract` وجود ندارد
|
|
|
|
**راه حل**:
|
|
```
|
|
1. به FrontOffice.BFF.Application/UserWalletCQ بروید
|
|
2. Command جدید بسازید: WithdrawBalance
|
|
- Request: PayoutId, WithdrawalMethod, IbanNumber?
|
|
- Response: Success, Message
|
|
3. به userwallet.proto اضافه کنید:
|
|
rpc WithdrawBalance(WithdrawBalanceRequest) returns (WithdrawBalanceResponse);
|
|
4. Handler را پیاده کنید با فراخوانی CMS.WithdrawCommissionBalance
|
|
5. Protobuf را rebuild/publish کنید
|
|
6. در WalletService uncomment کنید
|
|
```
|
|
|
|
---
|
|
|
|
### متد 4: GetWithdrawalsAsync() - خط 136-160
|
|
```csharp
|
|
// TODO: Implement when BFF protobuf has GetUserWithdrawals
|
|
await Task.CompletedTask;
|
|
return new List<WalletWithdrawal>();
|
|
/*
|
|
var request = new GetUserWithdrawalsRequest();
|
|
var response = await _client.GetUserWithdrawalsAsync(request);
|
|
*/
|
|
```
|
|
|
|
**مشکل**: متد `GetUserWithdrawals` در `UserWalletContract` وجود ندارد
|
|
|
|
**راه حل**:
|
|
```
|
|
1. به FrontOffice.BFF.Application/UserWalletCQ بروید
|
|
2. Query جدید بسازید: GetUserWithdrawals
|
|
- Request: Status?
|
|
- Response: List<WithdrawalDto>
|
|
3. به userwallet.proto اضافه کنید:
|
|
rpc GetUserWithdrawals(GetUserWithdrawalsRequest) returns (GetUserWithdrawalsResponse);
|
|
4. Handler را پیاده کنید با فراخوانی CMS
|
|
5. Protobuf را rebuild/publish کنید
|
|
6. در WalletService uncomment کنید
|
|
```
|
|
|
|
---
|
|
|
|
### متد 5: GetWithdrawalSettingsAsync() - خط 163-170
|
|
```csharp
|
|
// TODO: Implement when BFF protobuf has GetWithdrawalSettings
|
|
await Task.CompletedTask;
|
|
return new WithdrawalSettings(1_000_000);
|
|
// var response = await _client.GetWithdrawalSettingsAsync(new Empty());
|
|
```
|
|
|
|
**مشکل**: متد `GetWithdrawalSettings` در `UserWalletContract` وجود ندارد
|
|
|
|
**راه حل**:
|
|
```
|
|
1. به FrontOffice.BFF.Application/UserWalletCQ بروید
|
|
2. Query جدید بسازید: GetWithdrawalSettings
|
|
- Request: Empty
|
|
- Response: MinWithdrawalAmount
|
|
3. به userwallet.proto اضافه کنید:
|
|
rpc GetWithdrawalSettings(google.protobuf.Empty) returns (GetWithdrawalSettingsResponse);
|
|
4. Handler را پیاده کنید با فراخوانی CMS settings
|
|
5. Protobuf را rebuild/publish کنید
|
|
6. در WalletService uncomment کنید
|
|
```
|
|
|
|
---
|
|
|
|
## 2️⃣ ClubMembershipService.cs (Mock Data)
|
|
|
|
📁 مسیر: `/FrontOffice/src/FrontOffice.Main/Utilities/ClubMembershipService.cs`
|
|
|
|
### تمام متدها Mock هستند - خط 14-68
|
|
|
|
```csharp
|
|
// TODO: Replace with actual gRPC call to BFF
|
|
// var request = new GetMyClubMembershipRequest();
|
|
// var response = await _client.GetMyClubMembershipAsync(request);
|
|
```
|
|
|
|
**مشکل**: هیچ gRPC client وجود ندارد
|
|
|
|
**راه حل**:
|
|
```
|
|
1. FrontOffice.BFF.ClubMembership.Protobuf ساخته شود
|
|
2. به ConfigureServices.cs اضافه شود:
|
|
services.AddScoped(CreateAuthenticatedClient<ClubMembershipContract.ClubMembershipContractClient>);
|
|
3. در ClubMembershipService inject شود:
|
|
private readonly ClubMembershipContract.ClubMembershipContractClient _client;
|
|
4. متدهای Mock جایگزین شوند با gRPC calls
|
|
```
|
|
|
|
---
|
|
|
|
## 3️⃣ NetworkMembershipService.cs (Mock Data)
|
|
|
|
📁 مسیر: `/FrontOffice/src/FrontOffice.Main/Utilities/NetworkMembershipService.cs`
|
|
|
|
### تمام متدها Mock هستند - خط 14-105
|
|
|
|
```csharp
|
|
// TODO: Replace with actual gRPC call to BFF
|
|
// var request = new GetMyNetworkTreeRequest { MaxDepth = maxDepth };
|
|
// var response = await _client.GetMyNetworkTreeAsync(request);
|
|
```
|
|
|
|
**مشکل**: هیچ gRPC client وجود ندارد
|
|
|
|
**راه حل**:
|
|
```
|
|
1. FrontOffice.BFF.NetworkMembership.Protobuf ساخته شود
|
|
2. به ConfigureServices.cs اضافه شود:
|
|
services.AddScoped(CreateAuthenticatedClient<NetworkMembershipContract.NetworkMembershipContractClient>);
|
|
3. در NetworkMembershipService inject شود
|
|
4. متدهای Mock جایگزین شوند با gRPC calls
|
|
```
|
|
|
|
---
|
|
|
|
## 4️⃣ CommissionService.cs (Mock Data)
|
|
|
|
📁 مسیر: `/FrontOffice/src/FrontOffice.Main/Utilities/CommissionService.cs`
|
|
|
|
### تمام متدها Mock هستند - خط 14-119
|
|
|
|
```csharp
|
|
// TODO: Replace with actual gRPC call to BFF
|
|
// var request = new GetMyCommissionPayoutsRequest { ... };
|
|
// var response = await _client.GetMyCommissionPayoutsAsync(request);
|
|
```
|
|
|
|
**مشکل**: هیچ gRPC client وجود ندارد
|
|
|
|
**راه حل**:
|
|
```
|
|
1. FrontOffice.BFF.Commission.Protobuf ساخته شود
|
|
2. به ConfigureServices.cs اضافه شود:
|
|
services.AddScoped(CreateAuthenticatedClient<CommissionContract.CommissionContractClient>);
|
|
3. در CommissionService inject شود
|
|
4. متدهای Mock جایگزین شوند با gRPC calls
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 اولویتبندی کارها
|
|
|
|
### فاز 1: UserWalletCQ (بالاترین اولویت) ⚡
|
|
این ماژول قبلا شروع شده ولی ناقص است:
|
|
|
|
1. ✅ `GetUserWallet` موجود است
|
|
2. ❌ `DiscountBalance` در Response نیست → **اضافه شود**
|
|
3. ❌ `GetAllUserWalletChangeLog` وجود ندارد → **بساز**
|
|
4. ❌ `WithdrawBalance` وجود ندارد → **بساز**
|
|
5. ❌ `GetUserWithdrawals` وجود ندارد → **بساز**
|
|
6. ❌ `GetWithdrawalSettings` وجود ندارد → **بساز**
|
|
|
|
**زمان تخمینی**: 4-6 ساعت
|
|
|
|
---
|
|
|
|
### فاز 2: Protobuf Packages برای ماژولهای جدید
|
|
|
|
#### A. ClubMembershipCQ ✨
|
|
```
|
|
پوشه: FrontOffice.BFF/src/FrontOffice.BFF.ClubMembership.Protobuf/
|
|
فایل: clubmembership.proto
|
|
|
|
Messages:
|
|
- GetMyClubMembershipRequest (empty)
|
|
- GetMyClubMembershipResponse (UserId, IsActive, Status, DaysRemaining)
|
|
- ActivateMyClubMembershipRequest (PackageId, ActivationCode, DurationMonths)
|
|
- ActivateMyClubMembershipResponse (Success, Message, ActivationDate, AmountPaid)
|
|
|
|
Service:
|
|
service ClubMembershipContract {
|
|
rpc GetMyClubMembership(GetMyClubMembershipRequest) returns (GetMyClubMembershipResponse);
|
|
rpc ActivateMyClubMembership(ActivateMyClubMembershipRequest) returns (ActivateMyClubMembershipResponse);
|
|
}
|
|
```
|
|
|
|
**Handler Location**: `FrontOffice.BFF.Application/ClubMembershipCQ/`
|
|
- ✅ Queries/GetMyClubMembership (موجود است)
|
|
- ✅ Commands/ActivateMyClubMembership (موجود است)
|
|
|
|
**زمان تخمینی**: 2 ساعت (فقط Protobuf + publish)
|
|
|
|
---
|
|
|
|
#### B. NetworkMembershipCQ 🌳
|
|
```
|
|
پوشه: FrontOffice.BFF/src/FrontOffice.BFF.NetworkMembership.Protobuf/
|
|
فایل: networkmembership.proto
|
|
|
|
Messages:
|
|
- GetMyNetworkTreeRequest (MaxDepth)
|
|
- NetworkNodeDto (UserId, FullName, Mobile, Avatar, Position, LeftChild, RightChild, Level)
|
|
- GetMyNetworkTreeResponse (RootNode, TotalMembers, CurrentDepth)
|
|
- GetMyNetworkStatisticsRequest (empty)
|
|
- GetMyNetworkStatisticsResponse (LeftLegCount, RightLegCount, TotalMembers, TreeDepth, WeakerLeg, LastMember)
|
|
|
|
Service:
|
|
service NetworkMembershipContract {
|
|
rpc GetMyNetworkTree(GetMyNetworkTreeRequest) returns (GetMyNetworkTreeResponse);
|
|
rpc GetMyNetworkStatistics(GetMyNetworkStatisticsRequest) returns (GetMyNetworkStatisticsResponse);
|
|
}
|
|
```
|
|
|
|
**Handler Location**: `FrontOffice.BFF.Application/NetworkMembershipCQ/`
|
|
- ✅ Queries/GetMyNetworkTree (موجود است)
|
|
- ✅ Queries/GetMyNetworkStatistics (موجود است)
|
|
|
|
**زمان تخمینی**: 2-3 ساعت (Protobuf + publish)
|
|
|
|
---
|
|
|
|
#### C. CommissionCQ 💰
|
|
```
|
|
پوشه: FrontOffice.BFF/src/FrontOffice.BFF.Commission.Protobuf/
|
|
فایل: commission.proto
|
|
|
|
Messages:
|
|
- GetMyCommissionPayoutsRequest (WeekNumber?, Status?, PageNumber, PageSize)
|
|
- CommissionPayoutDto (Id, WeekNumber, WeekLabel, BalancesEarned, TotalAmount, AmountFormatted, Status, StatusBadgeColor, DatePersian)
|
|
- GetMyCommissionPayoutsResponse (Payouts[], TotalCount, PageNumber, PageSize)
|
|
- GetMyWeeklyBalancesRequest (WeekNumber?)
|
|
- GetMyWeeklyBalancesResponse (WeekNumber, WeekLabel, LeftBalance, RightBalance, MinBalance, BalanceCount, CalculatedCommission, LeftCarryover, RightCarryover, StartDate, EndDate)
|
|
|
|
Service:
|
|
service CommissionContract {
|
|
rpc GetMyCommissionPayouts(GetMyCommissionPayoutsRequest) returns (GetMyCommissionPayoutsResponse);
|
|
rpc GetMyWeeklyBalances(GetMyWeeklyBalancesRequest) returns (GetMyWeeklyBalancesResponse);
|
|
}
|
|
```
|
|
|
|
**Handler Location**: `FrontOffice.BFF.Application/CommissionCQ/`
|
|
- ✅ Queries/GetMyCommissionPayouts (موجود است)
|
|
- ✅ Queries/GetMyWeeklyBalances (موجود است)
|
|
|
|
**زمان تخمینی**: 3 ساعت (Protobuf + publish)
|
|
|
|
---
|
|
|
|
## 🔧 دستورات لازم برای هر Protobuf Package
|
|
|
|
### ساخت Package:
|
|
```bash
|
|
cd FrontOffice.BFF/src/FrontOffice.BFF.ClubMembership.Protobuf
|
|
dotnet pack -c Release
|
|
```
|
|
|
|
### Publish به NuGet/Local:
|
|
```bash
|
|
# اگر NuGet Server دارید:
|
|
dotnet nuget push bin/Release/Foursat.FrontOffice.BFF.ClubMembership.Protobuf.0.0.1.nupkg -s http://your-nuget-server
|
|
|
|
# یا اضافه به Local Source:
|
|
dotnet nuget add source /path/to/packages --name LocalPackages
|
|
```
|
|
|
|
### استفاده در FrontOffice.Main:
|
|
```xml
|
|
<PackageReference Include="Foursat.FrontOffice.BFF.ClubMembership.Protobuf" Version="0.0.1" />
|
|
<PackageReference Include="Foursat.FrontOffice.BFF.NetworkMembership.Protobuf" Version="0.0.1" />
|
|
<PackageReference Include="Foursat.FrontOffice.BFF.Commission.Protobuf" Version="0.0.1" />
|
|
```
|
|
|
|
---
|
|
|
|
## ⏱️ تخمین زمان کلی
|
|
|
|
| مرحله | زمان | اولویت |
|
|
|-------|------|--------|
|
|
| UserWalletCQ تکمیل | 4-6 ساعت | 🔴 بالا |
|
|
| ClubMembership Protobuf | 2 ساعت | 🟡 متوسط |
|
|
| NetworkMembership Protobuf | 2-3 ساعت | 🟡 متوسط |
|
|
| Commission Protobuf | 3 ساعت | 🟡 متوسط |
|
|
| FrontOffice integration | 2 ساعت | 🟢 پایین |
|
|
| **جمع کل** | **13-16 ساعت** | |
|
|
|
|
---
|
|
|
|
## 📝 نکات مهم
|
|
|
|
1. **همه Handler ها در BFF آماده هستند** - فقط Protobuf لازم است
|
|
2. **WalletService اولویت دارد** - زیرا صفحه Wallet قبلا موجود بود
|
|
3. **Mock Data فعلا کافی است** - برای Test UI
|
|
4. **بعد از Protobuf Publish**، فقط uncomment کافی است
|
|
|
|
---
|
|
|
|
## ✅ Checklist اجرایی
|
|
|
|
### مرحله 1: UserWalletCQ
|
|
- [ ] DiscountBalance به GetUserWalletResponse اضافه شود
|
|
- [ ] Query: GetAllUserWalletChangeLog ساخته شود
|
|
- [ ] Command: WithdrawBalance ساخته شود
|
|
- [ ] Query: GetUserWithdrawals ساخته شود
|
|
- [ ] Query: GetWithdrawalSettings ساخته شود
|
|
- [ ] Protobuf rebuild/publish شود
|
|
- [ ] WalletService uncomment شود
|
|
|
|
### مرحله 2: ClubMembership Protobuf
|
|
- [ ] پوشه Protobuf ساخته شود
|
|
- [ ] clubmembership.proto نوشته شود
|
|
- [ ] csproj تنظیم شود
|
|
- [ ] Build و publish شود
|
|
- [ ] به FrontOffice.Main اضافه شود
|
|
- [ ] ClubMembershipService uncomment شود
|
|
|
|
### مرحله 3: NetworkMembership Protobuf
|
|
- [ ] پوشه Protobuf ساخته شود
|
|
- [ ] networkmembership.proto نوشته شود
|
|
- [ ] Build و publish شود
|
|
- [ ] NetworkMembershipService uncomment شود
|
|
|
|
### مرحله 4: Commission Protobuf
|
|
- [ ] پوشه Protobuf ساخته شود
|
|
- [ ] commission.proto نوشته شود
|
|
- [ ] Build و publish شود
|
|
- [ ] CommissionService uncomment شود
|
|
|
|
---
|
|
|
|
**📅 آخرین بروزرسانی**: ۱۴ آذر ۱۴۰۴
|
|
**👤 توسط**: GitHub Copilot (Claude Sonnet 4.5)
|