admin/CMS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
665106329739793c12240441fd7430dcee25f367
CMS/docs/implementation-progress.md
masoodafar-web 6651063297 docs: Update progress for Phase 6 completion 
Added Phase 6 (gRPC API Integration) documentation:
- 4 Protobuf files with complete RPC definitions
- 4 gRPC Service classes with MediatR integration
- 26 RPC endpoints (Configuration: 5, ClubMembership: 6, NetworkMembership: 6, Commission: 9)
- HTTP transcoding support
- Auto-registration mechanism
- Updated overall project statistics

Total project stats:
- 145+ files created
- ~10,830 lines of code
- 12 successful commits
- 6 phases completed
2025-11-29 04:49:21 +03:30

44 KiB
Raw Blame History

پیشرفت پیاده‌سازی سیستم شبکه-باشگاه مشتریان

آخرین به‌روزرسانی: 2025-11-29 - روز ۹ فاز ۶

📊 وضعیت کلی

  • فاز فعلی: فاز ۶ - API Integration (gRPC) ✅ تکمیل شد
  • پیشرفت کلی:
    • ✅ فاز ۱: 100% تکمیل شد (Domain Layer)
    • ✅ فاز ۲ - ConfigurationCQ: 100% تکمیل شد
    • ✅ فاز ۳ - ClubMembershipCQ: 100% تکمیل شد
    • ✅ فاز ۴ - NetworkMembershipCQ: 100% تکمیل شد
    • ✅ فاز ۵ - CommissionCQ: 100% تکمیل شد
    • ✅ فاز ۶ - API Integration: 100% تکمیل شد

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

روز ۱: آماده‌سازی و Enums (✅ کامل)

1. ✅ آماده‌سازی پروژه

  • ایجاد Branch: feature/network-club-system
  • ایجاد ساختار پوشه‌ها در Domain:
    • Entities/Club/
    • Entities/Network/
    • Entities/Commission/
    • Entities/Configuration/
    • Entities/History/
    • Enums/

Commit: Initial structure setup

2. ✅ پیاده‌سازی Enums (7 فایل)

  • CommissionPayoutStatus.cs - وضعیت پرداخت کمیسیون
    • Pending, Paid, WithdrawRequested, Withdrawn, Cancelled
  • WithdrawalMethod.cs - روش برداشت
    • Cash, Diamond
  • NetworkLeg.cs - موقعیت در شبکه
    • Left, Right
  • ClubMembershipAction.cs - عملیات عضویت (History)
    • Activated, Deactivated, Updated, ManualFix
  • NetworkMembershipAction.cs - عملیات شبکه (History)
    • Join, Move, Remove
  • CommissionPayoutAction.cs - عملیات کمیسیون (History)
    • Created, Paid, WithdrawRequested, Withdrawn, Cancelled, ManualFix
  • ConfigurationScope.cs - محدوده تنظیمات
    • System, Network, Club, Commission
  • به‌روزرسانی TransactionType.cs:
    • NetworkCommission
    • ClubActivation
    • DiscountWalletCharge

Commit: 462ae5d - feat: Add enums for network-club system

روز ۲-۳: Core Entities (✅ کامل)

3. ✅ پیاده‌سازی Core Entities (7 فایل)

Configuration:

  • SystemConfiguration.cs - تنظیمات پویای سیستم
    • Scope, Key, Value, DataType, Description, IsActive

Club Management:

  • ClubMembership.cs - عضویت باشگاه
    • UserId, IsActive, ActivatedAt, InitialContribution, TotalEarned
  • ClubFeature.cs - فیچرهای باشگاه
    • Title, Description, IsActive, RequiredPoints, SortOrder
  • UserClubFeature.cs - جدول واسط کاربر-فیچر
    • UserId, ClubMembershipId, ClubFeatureId, GrantedAt, Notes

Network:

  • NetworkWeeklyBalance.cs - تعادل‌های هفتگی
    • UserId, WeekNumber, LeftLegBalances, RightLegBalances, TotalBalances
    • WeeklyPoolContribution, CalculatedAt, IsExpired

Commission:

  • WeeklyCommissionPool.cs - استخر کارمزد هفتگی
    • WeekNumber, TotalPoolAmount, TotalBalances, ValuePerBalance
    • IsCalculated, CalculatedAt
  • UserCommissionPayout.cs - پرداخت کمیسیون
    • UserId, WeekNumber, WeeklyPoolId, BalancesEarned, ValuePerBalance
    • TotalAmount, Status, PaidAt, WithdrawalMethod, IbanNumber, WithdrawnAt

4. ✅ پیاده‌سازی History Entities (4 فایل)

  • ClubMembershipHistory.cs - تاریخچه عضویت
    • ClubMembershipId, UserId, OldIsActive, NewIsActive
    • OldInitialContribution, NewInitialContribution
    • Action, Reason, PerformedBy
  • NetworkMembershipHistory.cs - تاریخچه شبکه
    • UserId, OldParentId, NewParentId, OldLegPosition, NewLegPosition
    • Action, Reason, PerformedBy
  • CommissionPayoutHistory.cs - تاریخچه کمیسیون
    • UserCommissionPayoutId, UserId, WeekNumber
    • AmountBefore, AmountAfter, OldStatus, NewStatus
    • Action, PerformedBy, Reason
  • SystemConfigurationHistory.cs - تاریخچه تنظیمات
    • ConfigurationId, Scope, Key, OldValue, NewValue
    • Reason, PerformedBy

5. ✅ به‌روزرسانی Entity های موجود

  • User.cs:

    • ✅ افزودن NetworkParentId (شناسه والد در شبکه)
    • ✅ افزودن NetworkParent Navigation Property
    • ✅ افزودن LegPosition (NetworkLeg enum)
    • ✅ افزودن Navigation Properties:
      • NetworkChildren - فرزندان در شبکه
      • ClubMembership - عضویت باشگاه
      • UserClubFeatures - فیچرهای کاربر
      • NetworkWeeklyBalances - تعادل‌های هفتگی
      • CommissionPayouts - پرداخت‌های کمیسیون

  • UserWallet.cs:

    • ✅ افزودن NetworkBalance - کیف پول طلایی (کارمزد)
    • ✅ افزودن DiscountBalance - کیف پول تخفیف (فقط برای باشگاه)
    • ✅ به‌روزرسانی کامنت‌ها

  • Products.cs:

    • ✅ افزودن IsClubExclusive - محصولات اختصاصی باشگاه
    • ✅ افزودن ClubDiscountPercent - درصد تخفیف (0-100)

  • GlobalUsings.cs:

    • ✅ افزودن namespace های جدید:
      • CMSMicroservice.Domain.Entities.Club
      • CMSMicroservice.Domain.Entities.Network
      • CMSMicroservice.Domain.Entities.Commission
      • CMSMicroservice.Domain.Entities.Configuration
      • CMSMicroservice.Domain.Entities.History
      • CMSMicroservice.Domain.Enums

Commit: d20dc86 - feat: Add core entities and history tables for network-club system

روز ۴-۵: EF Configurations و Migration (✅ کامل)

6. ✅ پیاده‌سازی EF Core Configurations (11 فایل)

Core Configurations:

  • SystemConfigurationConfiguration.cs
    • Composite Index: (Scope, Key) - Unique
    • Index: IsActive
  • ClubMembershipConfiguration.cs
    • رابطه یک‌به‌یک با User
    • Index Unique: UserId
    • Index: IsActive
  • ClubFeatureConfiguration.cs
    • Composite Index: (IsActive, SortOrder)
  • UserClubFeatureConfiguration.cs
    • روابط: User, ClubMembership, ClubFeature
    • Composite Index Unique: (UserId, ClubFeatureId)
    • Index: ClubMembershipId
  • NetworkWeeklyBalanceConfiguration.cs
    • رابطه با User
    • Composite Index Unique: (UserId, WeekNumber)
    • Index: WeekNumber, IsExpired
  • WeeklyCommissionPoolConfiguration.cs
    • Index Unique: WeekNumber
    • Index: IsCalculated
  • UserCommissionPayoutConfiguration.cs
    • روابط: User, WeeklyCommissionPool
    • Composite Index Unique: (UserId, WeekNumber)
    • Index: WeeklyPoolId, Status, WeekNumber

History Configurations:

  • ClubMembershipHistoryConfiguration.cs
    • رابطه با ClubMembership
    • Composite Index: (UserId, Created)
    • Index: ClubMembershipId, Action
  • NetworkMembershipHistoryConfiguration.cs
    • Composite Index: (UserId, Created)
    • Index: Action
  • CommissionPayoutHistoryConfiguration.cs
    • رابطه با UserCommissionPayout
    • Composite Index: (UserId, Created)
    • Index: UserCommissionPayoutId, WeekNumber, Action
  • SystemConfigurationHistoryConfiguration.cs
    • رابطه با SystemConfiguration
    • Composite Index: (ConfigurationId, Created)
    • Index: (Scope, Key)

7. ✅ به‌روزرسانی Configuration های موجود

  • UserConfiguration.cs:

    • ✅ افزودن NetworkParentId configuration
    • ✅ افزودن رابطه با NetworkParent و NetworkChildren
    • ✅ Index: NetworkParentId
    • ✅ Index: LegPosition
    • ✅ OnDelete: Restrict (جلوگیری از Cascade Delete)

  • UserWalletConfiguration.cs:

    • ✅ افزودن DiscountBalance field

  • ProductsConfiguration.cs:

    • ✅ افزودن IsClubExclusive field
    • ✅ افزودن ClubDiscountPercent field
    • ✅ Index: IsClubExclusive

8. ✅ به‌روزرسانی Infrastructure

  • ApplicationDbContext.cs:

    • ✅ افزودن 11 DbSet جدید:
      • SystemConfigurations, SystemConfigurationHistories
      • ClubMemberships, ClubFeatures, UserClubFeatures, ClubMembershipHistories
      • NetworkWeeklyBalances, NetworkMembershipHistories
      • WeeklyCommissionPools, UserCommissionPayouts, CommissionPayoutHistories
    • ✅ دسته‌بندی با کامنت‌های واضح

  • GlobalUsings.cs (Infrastructure):

    • ✅ افزودن Domain.Entities namespace ها
    • ✅ افزودن Domain.Enums

9. ✅ Migration

  • حذف Migration قبلی (AddNetworkClubSystem)
  • ایجاد Migration جدید: AddNetworkClubSystemV2
  • بررسی Migration Script (4267+ خط تغییر)
  • Migration شامل:
    • 11 جدول جدید با تمام Index ها
    • به‌روزرسانی 3 جدول موجود (User, UserWallet, Products)
    • Foreign Key ها با OnDelete Restrict
    • Unique Constraints

Commit: 04bc593 - feat: Add EF configurations and migration for network-club system

📈 آماری

فایل‌های ایجاد شده

  • Enums: 7 فایل + 1 به‌روزرسانی
  • Core Entities: 7 فایل
  • History Entities: 4 فایل
  • Entity Updates: 3 فایل (User, UserWallet, Products)
  • EF Configurations: 11 فایل جدید + 3 به‌روزرسانی
  • Infrastructure: 2 فایل به‌روزرسانی (DbContext, GlobalUsings)
  • Migration: 2 فایل (Migration + Designer)
  • جمع کل: 40 فایل ایجاد/به‌روزرسانی شده

خطوط کد اضافه شده

  • Domain Layer: ~650 خط کد C#
  • Infrastructure Layer: ~1,400 خط Configuration
  • Migration: ~4,267 خط SQL/C#
  • جمع کل: ~6,300+ خط کد

Commits انجام شده

  1. 462ae5d - Add enums for network-club system (8 files)
  2. d20dc86 - Add core entities and history tables (15 files)
  3. 04bc593 - Add EF configurations and migration (19 files)

🎯 اهداف فاز ۱

✅ انجام شده (60%)

  • ✅ Enums (100%)
  • ✅ Core Entities (100%)
  • ✅ History Entities (100%)
  • ✅ Entity Updates (100%)

🔄 در حال انجام (0%)

  • ⏳ EF Configurations (0%)
  • ⏳ Migration (0%)

⏳ باقیمانده (40%)

  • EF Configurations
  • Index ها
  • Migration
  • Test Migration

📝 نکات مهم

تصمیمات معماری

  1. ✅ استفاده از BaseAuditableEntity برای تمام جداول جدید
  2. ✅ جدا کردن History tables برای Audit Trail کامل
  3. ✅ استفاده از ConfigurationScope enum برای دسته‌بندی تنظیمات
  4. ✅ Navigation Properties دوطرفه برای روابط

مشکلات حل شده

  1. ✅ Build Error: Missing using directives
    • راه‌حل: به‌روزرسانی GlobalUsings.cs با namespace های جدید (Domain)
  2. ✅ Build Error: Missing using directives in Infrastructure
    • راه‌حل: به‌روزرسانی GlobalUsings.cs در Infrastructure با Domain namespaces
  3. ✅ Migration Conflict: Migration با نام مشابه وجود داشت
    • راه‌حل: حذف Migration قبلی و ایجاد با نام جدید (V2)

یادداشت‌ها

  • تمام Entity ها با XML Documentation کامنت‌گذاری شده‌اند
  • تمام فیلدهای nullable به درستی تعریف شده‌اند
  • Navigation Properties با virtual برای Lazy Loading
  • تمام Configuration ها با Index های بهینه
  • Foreign Key ها با OnDelete: Restrict برای جلوگیری از Cascade Delete
  • Composite Index ها برای Query های پرکاربرد

روز ۶: فاز ۲ - ConfigurationCQ (✅ کامل)

1. ✅ ساختار پوشه‌ها

  • ایجاد ConfigurationCQ/Commands/SetConfigurationValue/
  • ایجاد ConfigurationCQ/Commands/DeactivateConfiguration/
  • ایجاد ConfigurationCQ/Queries/GetConfigurationByKey/
  • ایجاد ConfigurationCQ/Queries/GetAllConfigurations/
  • ایجاد ConfigurationCQ/Queries/GetConfigurationHistory/

2. ✅ Commands (6 فایل)

SetConfigurationValueCommand:

  • SetConfigurationValueCommand.cs - Create/Update configuration
    • Properties: Scope, Key, Value, Description, ChangeReason
    • Returns: ConfigurationId
  • SetConfigurationValueCommandValidator.cs
    • Scope: IsInEnum
    • Key: NotEmpty, MaxLength(100), Regex pattern
    • Value: NotEmpty, MaxLength(2000)
  • SetConfigurationValueCommandHandler.cs
    • Upsert logic (Insert or Update)
    • History recording to SystemConfigurationHistory
    • SaveChanges twice (entity + history)

DeactivateConfigurationCommand:

  • DeactivateConfigurationCommand.cs - Deactivate configuration
    • Properties: ConfigurationId, Reason
  • DeactivateConfigurationCommandValidator.cs
    • ConfigurationId: GreaterThan(0)
    • Reason: MaxLength(500) when provided
  • DeactivateConfigurationCommandHandler.cs
    • Set IsActive = false
    • History recording
    • Idempotent (no error if already inactive)

3. ✅ Queries (13 فایل)

GetConfigurationByKeyQuery:

  • GetConfigurationByKeyQuery.cs
    • Parameters: Scope, Key
    • Returns: ConfigurationDto (nullable)
  • GetConfigurationByKeyQueryValidator.cs
  • GetConfigurationByKeyQueryHandler.cs
    • AsNoTracking for read-only
    • Returns null if not found
  • ConfigurationDto.cs
    • 8 properties با Timestamps

GetAllConfigurationsQuery:

  • GetAllConfigurationsQuery.cs
    • Filter: Scope, KeyContains, IsActive
    • Pagination + Sorting
  • GetAllConfigurationsQueryValidator.cs
  • GetAllConfigurationsQueryHandler.cs
    • Dynamic filtering
    • Pagination با MetaData
  • GetAllConfigurationsResponseDto.cs

GetConfigurationHistoryQuery:

  • GetConfigurationHistoryQuery.cs
    • Parameters: ConfigurationId
    • Pagination + Sorting (default: -Created)
  • GetConfigurationHistoryQueryValidator.cs
  • GetConfigurationHistoryQueryHandler.cs
    • Check configuration exists (NotFoundException)
    • Order by Created DESC
    • Maps Reason → ChangeReason, PerformedBy → ChangedBy
  • GetConfigurationHistoryResponseDto.cs

4. ✅ Infrastructure Updates

  • به‌روزرسانی IApplicationDbContext.cs:

    • اضافه شدن 11 DbSet جدید:
      • SystemConfigurations
      • SystemConfigurationHistories
      • ClubMemberships
      • ClubMembershipHistories
      • ClubFeatures
      • UserClubFeatures
      • NetworkWeeklyBalances
      • NetworkMembershipHistories
      • WeeklyCommissionPools
      • UserCommissionPayouts
      • CommissionPayoutHistories

  • به‌روزرسانی Application/GlobalUsings.cs:

    • CMSMicroservice.Domain.Entities.Club
    • CMSMicroservice.Domain.Entities.Network
    • CMSMicroservice.Domain.Entities.Commission
    • CMSMicroservice.Domain.Entities.Configuration
    • CMSMicroservice.Domain.Entities.History
    • CMSMicroservice.Domain.Enums

5. ✅ Features پیاده‌سازی شده

  • ✅ CQRS Pattern کامل
  • ✅ FluentValidation برای تمام Commands و Queries
  • ✅ History Tracking اتوماتیک
  • ✅ Pagination و Sorting
  • ✅ Filtering پویا
  • ✅ Null-safe implementations
  • ✅ DTO Pattern برای Data Transfer
  • ✅ Idempotent Commands
  • ✅ Proper exception handling

Commit: f6fa070 - feat: Add ConfigurationCQ - Phase 2 Application Layer

آمار:

  • 20 فایل جدید/تغییریافته
  • 612+ خط کد اضافه شده
  • 2 Command + 3 Query + 4 DTO
  • Build: ✅ موفق (0 error, 184 warnings در Legacy code)

روز ۷: فاز ۳ - ClubMembershipCQ (✅ کامل)

1. ✅ ساختار پوشه‌ها

  • ایجاد ClubMembershipCQ/Commands/ActivateClubMembership/
  • ایجاد ClubMembershipCQ/Commands/DeactivateClubMembership/
  • ایجاد ClubMembershipCQ/Commands/AssignClubFeature/
  • ایجاد ClubMembershipCQ/Queries/GetClubMembership/
  • ایجاد ClubMembershipCQ/Queries/GetAllClubMemberships/
  • ایجاد ClubMembershipCQ/Queries/GetClubMembershipHistory/

2. ✅ Commands (9 فایل)

ActivateClubMembershipCommand:

  • ActivateClubMembershipCommand.cs - Activate/Create membership
    • Properties: UserId, ActivationDate (nullable), Reason
    • Returns: ClubMembershipId
    • Idempotent: creates new or reactivates existing
  • ActivateClubMembershipCommandValidator.cs
    • UserId: GreaterThan(0)
    • Reason: MaxLength(500)
  • ActivateClubMembershipCommandHandler.cs
    • Check user exists (NotFoundException)
    • Create new: ActivatedAt = now, InitialContribution = 0
    • Reactivate: Update ActivatedAt only
    • History: OldIsActive, NewIsActive, Action.Activated

DeactivateClubMembershipCommand:

  • DeactivateClubMembershipCommand.cs - Deactivate membership
    • Properties: UserId, Reason
  • DeactivateClubMembershipCommandValidator.cs
    • UserId: GreaterThan(0)
    • Reason: MaxLength(500)
  • DeactivateClubMembershipCommandHandler.cs
    • Set IsActive = false (no DeactivationDate field in entity)
    • Idempotent: return if already inactive
    • History: OldIsActive=true, NewIsActive=false

AssignClubFeatureCommand:

  • AssignClubFeatureCommand.cs - Assign feature to user
    • Properties: UserId, FeatureId, GrantedAt (nullable), Notes
    • Returns: UserClubFeatureId
  • AssignClubFeatureCommandValidator.cs
    • UserId: GreaterThan(0)
    • FeatureId: GreaterThan(0)
    • Notes: MaxLength(500)
  • AssignClubFeatureCommandHandler.cs
    • Validate active membership exists
    • Validate ClubFeature exists and active
    • Upsert logic: Update Notes if exists, create new otherwise
    • Uses: ClubMembershipId, ClubFeatureId, GrantedAt (DateTime)

3. ✅ Queries (12 فایل)

GetClubMembershipQuery:

  • GetClubMembershipQuery.cs
    • Parameter: UserId
    • Returns: ClubMembershipDto (nullable)
  • GetClubMembershipQueryValidator.cs
    • UserId: GreaterThan(0)
  • GetClubMembershipQueryHandler.cs
    • AsNoTracking read-only
    • Returns null if not found
  • ClubMembershipDto.cs
    • Properties: Id, UserId, IsActive, ActivatedAt (DateTime?), InitialContribution, TotalEarned, Created, LastModified

GetAllClubMembershipsQuery:

  • GetAllClubMembershipsQuery.cs
    • Filter: UserId, IsActive, ActivationDateFrom, ActivationDateTo
    • Pagination + Sorting
  • GetAllClubMembershipsQueryValidator.cs
    • Date validation: From <= To
  • GetAllClubMembershipsQueryHandler.cs
    • Dynamic filtering on ActivatedAt field
    • Pagination with MetaData
  • GetAllClubMembershipsResponseDto.cs
    • ResponseModel: Id, UserId, IsActive, ActivatedAt, InitialContribution, TotalEarned, Created, LastModified

GetClubMembershipHistoryQuery:

  • GetClubMembershipHistoryQuery.cs
    • Parameters: MembershipId (nullable), UserId (nullable)
    • At least one required
    • Pagination + Sorting (default: -Created)
  • GetClubMembershipHistoryQueryValidator.cs
    • Custom validation: at least one ID required
  • GetClubMembershipHistoryQueryHandler.cs
    • Filter by ClubMembershipId OR UserId
    • Order by Created DESC
    • Maps complete history entity
  • GetClubMembershipHistoryResponseDto.cs
    • ResponseModel: ClubMembershipId, UserId, OldIsActive, NewIsActive, OldInitialContribution, NewInitialContribution, Action (enum), Reason, PerformedBy, Created

4. ✅ Property Alignment

Fixed all property name mismatches between Domain entities and Application handlers:

  • ClubMembership:
    • ❌ Handlers: ActivationDate, DeactivationDate, LastActivationDate
    • ✅ Entity: ActivatedAt (DateTime?)
  • UserClubFeature:
    • ❌ Handlers: MembershipId, FeatureId, StartDate, EndDate
    • ✅ Entity: ClubMembershipId, ClubFeatureId, GrantedAt, Notes
  • ClubMembershipHistory:
    • ❌ Handlers: MembershipId, Details
    • ✅ Entity: ClubMembershipId, Reason (+ required: OldIsActive, NewIsActive)

5. ✅ Features پیاده‌سازی شده

  • ✅ CQRS Pattern کامل
  • ✅ FluentValidation برای تمام Commands و Queries
  • ✅ Complete History Tracking با تمام فیلدهای Audit
  • ✅ Pagination و Sorting
  • ✅ Filtering پویا با Date Ranges
  • ✅ Null-safe implementations
  • ✅ Idempotent Commands (Activate, Deactivate)
  • ✅ Upsert pattern (AssignClubFeature)
  • ✅ Proper exception handling (NotFoundException)
  • ✅ Entity validation (active membership, active feature)

Commit: fe66d47 - feat: Add ClubMembershipCQ - Phase 3 Application Layer

آمار:

  • 21 فایل جدید
  • 732 خط کد اضافه شده
  • 3 Command + 3 Query + 4 DTO
  • Build: ✅ موفق (0 error, 193 warnings در Legacy code)

روز ۸: فاز ۴ - NetworkMembershipCQ (✅ کامل)

1. ✅ ساختار پوشه‌ها

  • ایجاد NetworkMembershipCQ/Commands/JoinNetwork/
  • ایجاد NetworkMembershipCQ/Commands/MoveInNetwork/
  • ایجاد NetworkMembershipCQ/Commands/RemoveFromNetwork/
  • ایجاد NetworkMembershipCQ/Queries/GetNetworkTree/
  • ایجاد NetworkMembershipCQ/Queries/GetUserNetworkPosition/
  • ایجاد NetworkMembershipCQ/Queries/GetNetworkMembershipHistory/

2. ✅ Commands (9 فایل)

JoinNetworkCommand:

  • JoinNetworkCommand.cs - Add user to binary network
    • Properties: UserId, ParentId, LegPosition (Left/Right), Reason
    • Returns: Unit
  • JoinNetworkCommandValidator.cs
    • UserId, ParentId: GreaterThan(0)
    • LegPosition: IsInEnum
    • Reason: MaxLength(500)
  • JoinNetworkCommandHandler.cs
    • Check user exists and NOT already in network
    • Check parent exists and IS in network (or Root user)
    • Validate leg position is empty (no duplicate)
    • Set NetworkParentId and LegPosition
    • History: Action.Join with old/new values

MoveInNetworkCommand:

  • MoveInNetworkCommand.cs - Move user in network
    • Properties: UserId, NewParentId, NewLegPosition, Reason
  • MoveInNetworkCommandValidator.cs
  • MoveInNetworkCommandHandler.cs
    • Check user IS in network
    • Check new parent exists
    • IsDescendant check: Prevent circular dependencies
      • Recursive traversal to ensure newParent is not child of user
    • Validate new leg position is empty
    • Update NetworkParentId and LegPosition
    • History: Track OldParentId → NewParentId, OldLeg → NewLeg

RemoveFromNetworkCommand:

  • RemoveFromNetworkCommand.cs - Remove user from network
    • Properties: UserId, Reason
  • RemoveFromNetworkCommandValidator.cs
  • RemoveFromNetworkCommandHandler.cs
    • Check user IS in network
    • Check user has NO children (must move/remove first)
    • Set NetworkParentId = null, LegPosition = null (soft delete)
    • Idempotent: return if already removed
    • History: Action.Remove

3. ✅ Queries (12 فایل)

GetNetworkTreeQuery:

  • GetNetworkTreeQuery.cs
    • Parameters: UserId (root), MaxDepth (1-10, default: 3)
    • Returns: NetworkTreeDto (recursive binary tree)
  • GetNetworkTreeQueryValidator.cs
    • MaxDepth: InclusiveBetween(1, 10)
  • GetNetworkTreeQueryHandler.cs
    • Recursive BuildTree method
    • Queries Left/Right children at each level
    • Stops at MaxDepth to prevent large trees
    • Returns nested structure with CurrentDepth tracking
  • NetworkTreeDto.cs
    • Properties: UserId, Mobile, FirstName, LastName, LegPosition
    • CurrentDepth, LeftChild, RightChild (recursive)

GetUserNetworkPositionQuery:

  • GetUserNetworkPositionQuery.cs
    • Parameter: UserId
    • Returns: UserNetworkPositionDto
  • GetUserNetworkPositionQueryValidator.cs
  • GetUserNetworkPositionQueryHandler.cs
    • User info: Mobile, Name, NetworkParentId, LegPosition
    • Parent info: ParentMobile
    • Children counts: TotalChildren, LeftChildCount, RightChildCount
    • IsInNetwork flag
  • UserNetworkPositionDto.cs
    • 11 properties including children statistics

GetNetworkMembershipHistoryQuery:

  • GetNetworkMembershipHistoryQuery.cs
    • Parameters: UserId (nullable), SortBy, PaginationState
    • Returns: ResponseDto with pagination
  • GetNetworkMembershipHistoryQueryValidator.cs
  • GetNetworkMembershipHistoryQueryHandler.cs
    • Filter by UserId (optional - shows all if null)
    • Default sort: -Created (newest first)
    • Pagination support
  • GetNetworkMembershipHistoryResponseDto.cs
    • ResponseModel: OldParentId, NewParentId, OldLeg, NewLeg
    • Action (Join/Move/Remove), Reason, PerformedBy

4. ✅ Advanced Features

  • ✅ Binary Tree Validation:

    • Parent-child relationship checks
    • Leg position uniqueness (Left/Right per parent)
    • Prevents duplicate placements

  • ✅ Circular Dependency Prevention:

    • IsDescendant recursive check in MoveInNetwork
    • Prevents moving parent under its own children
    • Maintains tree integrity

  • ✅ Children Protection:

    • RemoveFromNetwork validates no children exist
    • Forces move/remove children first
    • Prevents orphaned nodes

  • ✅ Soft Delete Pattern:

    • NetworkParentId = null (not hard delete)
    • Preserves history and audit trail
    • Allows re-joining network

  • ✅ History Tracking:

    • Complete audit trail: old/new parent, old/new leg
    • Action enum: Join, Move, Remove
    • Reason and PerformedBy fields

Commit: db96a02 - feat: Add NetworkMembershipCQ - Phase 4 Application Layer

آمار:

  • 21 فایل جدید
  • 813 خط کد اضافه شده
  • 3 Command + 3 Query + 4 DTO
  • Build: ✅ موفق (0 error, 320 warnings در Legacy code)

روز ۹: فاز ۵ - CommissionCQ (CQRS) (✅ کامل)

تاریخ: 2025-11-29

پیاده‌سازی CQRS برای Commission System

پیاده‌سازی کامل سیستم محاسبه و توزیع کمیسیون هفتگی برای MLM Binary Plan.

Commands (15 فایل):

  1. ✅ CalculateWeeklyBalancesCommand

    • فایل‌ها: Command.cs + Handler.cs + Validator.cs
    • منطق Handler:
      • دریافت همه کاربران دارای ClubMembership فعال
      • محاسبه بازگشتی Balance هر پا (Left/Right) از طریق Recursive Binary Tree Traversal
      • تابع CalculateLegBalances: شمارش تمام فرزندان در پای مشخص شده
      • فرمول: Balance = 1 (child) + childLeftLeg + childRightLeg
      • TotalBalances = MIN(LeftLegBalances, RightLegBalances)
      • WeeklyPoolContribution = TotalBalances × 10% (0.10)
      • Upsert pattern برای NetworkWeeklyBalance
    • Validator: WeekNumber format (YYYY-Www), ForceRecalculate flag

  2. ✅ CalculateWeeklyCommissionPoolCommand

    • فایل‌ها: Command.cs + Handler.cs + Validator.cs
    • منطق Handler:
      • Check: آیا CalculateWeeklyBalances برای این هفته اجرا شده؟
      • Sum all WeeklyPoolContribution → TotalPoolAmount
      • Sum all TotalBalances
      • فرمول: ValuePerBalance = TotalPoolAmount ÷ TotalBalances (تقسیم صحیح ریال)
      • Upsert pattern برای WeeklyCommissionPool
    • Validator: WeekNumber format
    • Type conversions: long/int/decimal handled correctly

  3. ✅ ProcessUserPayoutsCommand

    • فایل‌ها: Command.cs + Handler.cs + Validator.cs
    • منطق Handler:
      • Check: آیا WeeklyCommissionPool محاسبه شده؟
      • برای هر کاربر با TotalBalances > 0:
        • TotalAmount = BalancesEarned × ValuePerBalance
        • ایجاد UserCommissionPayout با Status = Pending
        • ایجاد CommissionPayoutHistory با Action = Created
      • Idempotent: ForceReprocess = true اجازه بازمحاسبه
    • Validator: WeekNumber format
    • State Machine: Pending (initial state)

  4. ✅ RequestWithdrawalCommand

    • فایل‌ها: Command.cs + Handler.cs + Validator.cs
    • منطق Handler:
      • Validation: Status == CommissionPayoutStatus.Paid
      • Update: Status → WithdrawRequested
      • ذخیره: WithdrawalMethod (Cash/Diamond) + IbanNumber (برای Cash)
      • History: Action = WithdrawRequested
    • Validator:
      • PayoutId exists
      • IBAN format: ^IR\d{24}$ (فقط برای Cash)
      • Method enum validation

  5. ✅ ProcessWithdrawalCommand

    • فایل‌ها: Command.cs + Handler.cs + Validator.cs
    • منطق Handler:
      • If IsApproved = true:
        • Status → Withdrawn
        • If Diamond: اضافه کردن TotalAmount به UserWallet.DiscountBalance
        • If Cash: processed externally (IBAN ذخیره شده)
        • History: Action = Withdrawn
      • If IsApproved = false:
        • Status → Paid (برگشت)
        • Clear: WithdrawalMethod, IbanNumber
        • History: Action = Cancelled
    • Validator:
      • PayoutId exists
      • Status == WithdrawRequested
      • Reason اجباری برای Reject
Queries (20 فایل):

  1. ✅ GetWeeklyCommissionPoolQuery

    • فایل‌ها: Query.cs + Handler.cs + Validator.cs + Dto.cs
    • Output: TotalPoolAmount, TotalBalances, ValuePerBalance, IsCalculated, CalculatedAt
    • Validator: WeekNumber format

  2. ✅ GetUserCommissionPayoutsQuery

    • فایل‌ها: Query.cs + Handler.cs + Validator.cs + ResponseDto.cs
    • Filters: UserId, Status, WeekNumber
    • Features: Pagination, Sorting by WeekNumber DESC
    • Output: BalancesEarned, ValuePerBalance, TotalAmount, Status, WithdrawalMethod, IbanNumber

  3. ✅ GetCommissionPayoutHistoryQuery

    • فایل‌ها: Query.cs + Handler.cs + Validator.cs + ResponseDto.cs
    • Filters: PayoutId, UserId, WeekNumber
    • Features: Complete audit trail
    • Output: AmountBefore/After, OldStatus/NewStatus, Action, PerformedBy, Reason
    • Sorting: Created DESC (latest first)

  4. ✅ GetUserWeeklyBalancesQuery

    • فایل‌ها: Query.cs + Handler.cs + Validator.cs + ResponseDto.cs
    • Filters: UserId, WeekNumber, OnlyActive (non-expired)
    • Features: Pagination, Sorting by WeekNumber DESC
    • Output: LeftLegBalances, RightLegBalances, TotalBalances, WeeklyPoolContribution, CalculatedAt, IsExpired
ویژگی‌های کلیدی:

  • ✅ Recursive Binary Tree Traversal:

    • CalculateLegBalances method شمارش تمام فرزندان
    • Left/Right leg separation
    • Performance: مناسب برای شبکه‌های بزرگ (cache-able)

  • ✅ Commission Distribution Formula:

    • Binary Plan: MIN(Left, Right) determines earnings
    • 10% of TotalBalances → Weekly Pool Contribution
    • ValuePerBalance = Pool ÷ All Balances (تقسیم عادلانه)
    • User Payout = User Balances × ValuePerBalance

  • ✅ Dual Withdrawal Method:

    • Cash: Direct to bank account (IBAN required)
    • Diamond: Convert to DiscountBalance (instant, UserWallet integration)

  • ✅ State Machine:

    • Pending → Paid → WithdrawRequested → Withdrawn
    • Alternate: WithdrawRequested → Cancelled → Paid (rejected)
    • Complete history tracking at each transition

  • ✅ Idempotent Operations:

    • ForceRecalculate for balances
    • ForceReprocess for payouts
    • Prevents duplicate processing

  • ✅ Type Safety:

    • Entity: int for balance counts, long for Rials
    • DTO alignment: exact type matching
    • Nullable DateTime handling

Commit: 487d1ce - feat: Add CommissionCQ - Phase 5 Application Layer

آمار:

  • 31 فایل جدید (35 واقعی - Git شمارش متفاوت)
  • 1,213 خط کد اضافه شده
  • 5 Command + 4 Query + 4 ResponseDto
  • Build: ✅ موفق (0 error, 201 warnings در Legacy code)

Algorithm Complexity:

  • Recursive Traversal: O(N) per user per leg (N = descendants)
  • Weekly Calculation: O(U × D) where U = users, D = avg descendants
  • Optimizable: Cache results, incremental updates

روز ۹: فاز ۶ - API Integration (gRPC) (✅ کامل)

تاریخ: 2025-11-29

پیاده‌سازی gRPC API Layer برای تمام CQ Layers

ایجاد Protobuf definitions و gRPC services برای expose کردن تمام Commands/Queries.

Protobuf Files (4 فایل):

  1. ✅ configuration.proto

    • Service: ConfigurationContract
    • RPCs: 5 endpoint (2 Command + 3 Query)
    • Messages:
      • Commands: CreateOrUpdateConfiguration, DeactivateConfiguration
      • Queries: GetByKey, GetAll, GetHistory
      • DTOs: ConfigurationModel, ConfigurationHistoryModel
    • HTTP Annotations: REST-style endpoints via google.api.http
    • Pagination: MetaData support for GetAll/GetHistory

  2. ✅ clubmembership.proto

    • Service: ClubMembershipContract
    • RPCs: 6 endpoint (3 Command + 3 Query)
    • Messages:
      • Commands: ActivateClubMembership, DeactivateClubMembership, AssignFeatureToMembership
      • Queries: GetClubMembership (with features), GetAll, GetHistory
      • DTOs: ClubMembershipModel, MembershipFeatureModel, HistoryModel
    • Nested Objects: Features collection in membership response

  3. ✅ networkmembership.proto

    • Service: NetworkMembershipContract
    • RPCs: 6 endpoint (3 Command + 3 Query)
    • Messages:
      • Commands: JoinNetwork, ChangeNetworkParent, RemoveFromNetwork
      • Queries: GetUserNetwork (position + children), GetNetworkTree (hierarchical), GetHistory
      • DTOs: NetworkTreeNodeModel, NetworkMembershipHistoryModel
    • Tree Structure: Recursive node model for tree query

  4. ✅ commission.proto

    • Service: CommissionContract
    • RPCs: 9 endpoint (5 Command + 4 Query)
    • Messages:
      • Commands: CalculateWeeklyBalances, CalculateWeeklyPool, ProcessPayouts, RequestWithdrawal, ProcessWithdrawal
      • Queries: GetWeeklyPool, GetUserPayouts, GetPayoutHistory, GetUserWeeklyBalances
      • DTOs: UserCommissionPayoutModel, CommissionPayoutHistoryModel, UserWeeklyBalanceModel, WeeklyPoolDto
    • Enums: CommissionPayoutStatus, WithdrawalMethod, CommissionPayoutAction
gRPC Service Classes (4 کلاس):

  1. ✅ ConfigurationService.cs

    • Base: ConfigurationContract.ConfigurationContractBase
    • Methods: 5 RPC handlers
    • Integration: IDispatchRequestToCQRS for MediatR dispatch
    • Mapping: Proto Request → CQRS Command/Query → Proto Response

  2. ✅ ClubMembershipService.cs

    • Base: ClubMembershipContract.ClubMembershipContractBase
    • Methods: 6 RPC handlers
    • Commands: Activate, Deactivate, AssignClubFeature
    • Queries: Get, GetAll, GetHistory

  3. ✅ NetworkMembershipService.cs

    • Base: NetworkMembershipContract.NetworkMembershipContractBase
    • Methods: 6 RPC handlers
    • Commands: JoinNetwork, MoveInNetwork, RemoveFromNetwork
    • Queries: GetUserNetworkPosition, GetNetworkTree, GetHistory

  4. ✅ CommissionService.cs

    • Base: CommissionContract.CommissionContractBase
    • Methods: 9 RPC handlers (largest service)
    • Command handlers: 5 methods for commission workflow
    • Query handlers: 4 methods for reporting
تنظیمات و Integration:

  • ✅ CMSMicroservice.Protobuf.csproj:

    • Added 4 new <Protobuf Include> entries
    • GrpcServices="Both" for client+server code gen
    • ProtoRoot="Protos" for imports

  • ✅ Auto-Registration:

    • ConfigureGrpcEndpoints method در Program.cs
    • Auto-discovers all "*Service" classes in Services folder
    • Checks BaseType ends with "ContractBase"
    • Dynamically calls MapGrpcService<T> for each

  • ✅ HTTP Transcoding:

    • All RPCs have google.api.http annotations
    • REST-style URLs (e.g., /Configuration/GetByKey)
    • Support for Swagger/OpenAPI
    • POST for commands, GET for queries
ویژگی‌های کلیدی:

  • ✅ Type Safety:

    • Proto3 syntax with strict typing
    • google.protobuf wrappers for nullable values
    • Enum mapping to Domain enums

  • ✅ Pagination:

    • messages.MetaData from public_messages.proto
    • Consistent across all GetAll/GetHistory endpoints
    • PageIndex, PageSize, TotalCount, HasNext/HasPrevious

  • ✅ Timestamps:

    • google.protobuf.Timestamp for DateTime fields
    • UTC timezone handling
    • Nullable timestamp support

  • ✅ Validation:

    • FluentValidation in Application layer (already implemented)
    • Proto field requirements enforced at compile-time
    • Request validation before dispatch to MediatR

  • ✅ Error Handling:

    • gRPC status codes
    • Detailed error messages in development
    • Exception handling via interceptors

Commit: 2bb8c2a - feat: Add gRPC API Layer - Phase 6 Integration

آمار:

  • 4 فایل Proto (890+ lines)
  • 4 فایل Service (270+ lines)
  • 26 RPC endpoints total
  • Build: ✅ موفق (0 error, 0 warnings در کدهای جدید)

Endpoints Summary:

  • Configuration: 5 RPCs
  • ClubMembership: 6 RPCs
  • NetworkMembership: 6 RPCs
  • Commission: 9 RPCs
  • Total: 26 gRPC endpoints ready for BFF integration

🚀 مراحل بعدی

فاز ۷: Testing & Documentation (روز ۱۰-۱۱) - بعدی:

Priority: MEDIUM

  1. Unit Tests for critical handlers:
    • CalculateWeeklyBalances recursive logic
    • Commission pool distribution formulas
    • State machine transitions
  2. Integration tests for gRPC endpoints
  3. End-to-End workflow test:
    • User → Club Activation → Network Join → Weekly Calculation → Commission Payout → Withdrawal
  4. Performance testing for recursive tree operations
  5. API documentation (Swagger already configured)
  6. Update system documentation with complete architecture

فاز ۸: Migration & Deployment (روز ۱۲)

Priority: LOW

  1. Create and test database migration

  2. Seed test data

  3. Deploy to staging environment

  4. Final system verification

  5. ایجاد پوشه CommissionCQ در Application

  6. پیاده‌سازی Commands:

    • CalculateWeeklyBalancesCommand + Handler + Validator
      • محاسبه تعادل هفتگی هر کاربر (Left/Right leg balances)
      • ذخیره در NetworkWeeklyBalance
    • CalculateWeeklyCommissionPoolCommand + Handler + Validator
      • محاسبه استخر کارمزد هفتگی
      • محاسبه ValuePerBalance = TotalPoolAmount / TotalBalances
    • ProcessUserPayoutsCommand + Handler + Validator
      • توزیع کمیسیون به کاربران بر اساس Balances
      • ایجاد UserCommissionPayout records
    • RequestWithdrawalCommand + Handler + Validator
      • درخواست برداشت (Cash یا Diamond)
    • ProcessWithdrawalCommand + Handler + Validator
      • پردازش برداشت و به‌روزرسانی وضعیت

  7. پیاده‌سازی Queries:

    • GetWeeklyCommissionPoolQuery + Handler
    • GetUserCommissionPayoutsQuery + Handler (با فیلتر Status, Week)
    • GetCommissionPayoutHistoryQuery + Handler
    • GetUserWeeklyBalancesQuery + Handler

  8. ایجاد DTOs

  9. تست Unit

  10. Commit

📞 مسائل و سوالات

سوالات باز

  • هیچ

Blockers

  • هیچ

وضعیت فعلی: ✅ فاز ۶ - API Integration کامل شد - آماده برای Testing
Build Status: ✅ موفق
آخرین Commit: 2bb8c2a
gRPC Endpoints: 26 RPCs (4 services)
Migration Status: ✅ آماده اجرا
تعداد Warning: 0 (برای کدهای جدید)

🎉 فاز ۱ با موفقیت تکمیل شد!

دستاوردها:

✅ 7 Enum جدید + 1 به‌روزرسانی
✅ 11 Entity جدید (7 Core + 4 History)
✅ 3 Entity موجود به‌روزرسانی شد
✅ 14 Configuration کامل (11 جدید + 3 به‌روزرسانی)
✅ Migration کامل با 11 جدول جدید
✅ بیش از 6,300 خط کد اضافه شده
✅ 4 Commit با پیام‌های واضح

🎉 فاز ۲ - ConfigurationCQ با موفقیت تکمیل شد!

دستاوردها:

✅ 2 Command (Create/Update, Deactivate)
✅ 3 Query (ByKey, GetAll, History)
✅ 6 Validator
✅ 6 Handler
✅ 4 DTO
✅ History Tracking اتوماتیک
✅ 612+ خط کد اضافه شده
✅ 1 Commit با پیام واضح
✅ Build موفق بدون Error

🎉 فاز ۳ - ClubMembershipCQ با موفقیت تکمیل شد!

دستاوردها:

✅ 3 Command (Activate, Deactivate, AssignFeature)
✅ 3 Query (Get, GetAll, History)
✅ 6 Validator
✅ 6 Handler
✅ 4 DTO
✅ Complete History Tracking
✅ Property alignment با Domain entities
✅ Idempotent design patterns
✅ 732 خط کد اضافه شده
✅ 1 Commit با پیام واضح
✅ Build موفق بدون Error

🎉 فاز ۴ - NetworkMembershipCQ با موفقیت تکمیل شد!

دستاوردها:

✅ 3 Command (JoinNetwork, MoveInNetwork, RemoveFromNetwork)
✅ 3 Query (GetNetworkTree, GetUserNetworkPosition, History)
✅ 6 Validator
✅ 6 Handler
✅ 4 DTO
✅ Binary Tree Implementation با Recursive Query
✅ Circular Dependency Prevention (IsDescendant)
✅ Children Protection (no orphan nodes)
✅ Soft Delete Pattern
✅ Complete History Tracking
✅ 813 خط کد اضافه شده
✅ 1 Commit با پیام واضح
✅ Build موفق بدون Error

🎉 فاز ۵ - CommissionCQ با موفقیت تکمیل شد!

دستاوردها:

✅ 5 Command (CalculateBalances, CalculatePool, ProcessPayouts, RequestWithdrawal, ProcessWithdrawal)
✅ 4 Query (GetPool, GetPayouts, GetHistory, GetBalances)
✅ 15 Validator
✅ 15 Handler
✅ 8 DTO/ResponseDto
✅ Recursive Binary Tree Algorithm
✅ Dual Withdrawal Method (Cash/Diamond)
✅ Complete State Machine & History
✅ 1,213+ خط کد اضافه شده
✅ 1 Commit با پیام واضح
✅ Build موفق بدون Error

آماده برای:

🚀 فاز ۶: Integration & Testing (API Controllers, gRPC, End-to-End Tests)

🎉 فاز ۶ - API Integration (gRPC) با موفقیت تکمیل شد!

دستاوردها:

✅ 4 Protobuf files (configuration, clubmembership, networkmembership, commission)
✅ 4 gRPC Service classes با MediatR integration
✅ 26 RPC endpoints (5 + 6 + 6 + 9)
✅ HTTP transcoding support via google.api.http
✅ Auto-registration with ConfigureGrpcEndpoints
✅ MetaData pagination across all queries
✅ Type-safe request/response DTOs
✅ 890+ خط protobuf + 270+ خط C#
✅ 1 Commit با پیام واضح
✅ Build موفق بدون Error

آماده برای:

🚀 فاز ۷: Testing & Documentation (Unit Tests, Integration Tests, API Docs)

📈 آمار کلی پروژه تا کنون

تعداد فایل‌ها:

  • Domain Layer: 11 Entity + 4 History + 8 Enum + 14 Configuration = 37 فایل
  • ConfigurationCQ: 2 Command + 3 Query + 6 Validator + 6 Handler + 4 DTO = 21 فایل
  • ClubMembershipCQ: 3 Command + 3 Query + 6 Validator + 6 Handler + 4 DTO = 22 فایل
  • NetworkMembershipCQ: 3 Command + 3 Query + 6 Validator + 6 Handler + 4 DTO = 22 فایل
  • CommissionCQ: 5 Command + 4 Query + 9 Validator + 9 Handler + 8 DTO = 35 فایل
  • gRPC API Layer: 4 Proto + 4 Service = 8 فایل
  • مجموع: 145+ فایل

تعداد خطوط کد:

  • Phase 1 (Domain): ~6,300 lines
  • Phase 2 (ConfigurationCQ): ~612 lines
  • Phase 3 (ClubMembershipCQ): ~732 lines
  • Phase 4 (NetworkMembershipCQ): ~813 lines
  • Phase 5 (CommissionCQ): ~1,213 lines
  • Phase 6 (gRPC API): ~1,160 lines (890 proto + 270 services)
  • مجموع: ~10,830 lines

تعداد Commits:

  • Phase 1: 4 commits
  • Phase 2: 2 commits (including 1 fix)
  • Phase 3: 2 commits (including 1 fix)
  • Phase 4: 2 commits
  • Phase 5: 1 commit
  • Phase 6: 1 commit
  • مجموع: 12 commits موفق

Build Status:

✅ 0 Errors در کدهای جدید
⚠️ 201 Warnings (تماماً در Legacy code - بی‌خطر)

فاز‌های تکمیل شده:

✅ Phase 1: Domain Layer (11 Entity + 4 History + 8 Enum + 14 Config)
✅ Phase 2: ConfigurationCQ (2 Commands + 3 Queries)
✅ Phase 3: ClubMembershipCQ (3 Commands + 3 Queries)
✅ Phase 4: NetworkMembershipCQ (3 Commands + 3 Queries)
✅ Phase 5: CommissionCQ (5 Commands + 4 Queries)
✅ Phase 6: gRPC API Integration (4 Proto files + 4 Services + 26 RPCs)

آماده برای:

🚀 Phase 7: Testing & Documentation

Reference in New Issue View Git Blame Copy Permalink