feat: Enhance network membership and withdrawal processing with user tracking and logging

src/CMSMicroservice.Domain/Entities/Network/NetworkWeeklyBalance.cs

@@ -21,20 +21,62 @@ public class NetworkWeeklyBalance : BaseAuditableEntity
     public string WeekNumber { get; set; }
 
     /// <summary>
-    /// تعداد تعادل شاخه چپ در این هفته
+    /// تعداد اعضای جدید شاخه چپ در این هفته
     /// </summary>
+    public int LeftLegNewMembers { get; set; }
+
+    /// <summary>
+    /// تعداد اعضای جدید شاخه راست در این هفته
+    /// </summary>
+    public int RightLegNewMembers { get; set; }
+
+    /// <summary>
+    /// باقیمانده شاخه چپ از هفته قبل (Carryover)
+    /// </summary>
+    public int LeftLegCarryover { get; set; }
+
+    /// <summary>
+    /// باقیمانده شاخه راست از هفته قبل (Carryover)
+    /// </summary>
+    public int RightLegCarryover { get; set; }
+
+    /// <summary>
+    /// مجموع شاخه چپ: LeftLegNewMembers + LeftLegCarryover
+    /// </summary>
+    public int LeftLegTotal { get; set; }
+
+    /// <summary>
+    /// مجموع شاخه راست: RightLegNewMembers + RightLegCarryover
+    /// </summary>
+    public int RightLegTotal { get; set; }
+
+    /// <summary>
+    /// تعداد تعادل (امتیاز): MIN(LeftLegTotal, RightLegTotal)
+    /// </summary>
+    public int TotalBalances { get; set; }
+
+    /// <summary>
+    /// باقیمانده شاخه چپ برای هفته بعد
+    /// </summary>
+    public int LeftLegRemainder { get; set; }
+
+    /// <summary>
+    /// باقیمانده شاخه راست برای هفته بعد
+    /// </summary>
+    public int RightLegRemainder { get; set; }
+
+    /// <summary>
+    /// [DEPRECATED] تعداد تعادل شاخه چپ - استفاده نشود
+    /// </summary>
+    [Obsolete("Use LeftLegTotal instead")]
     public int LeftLegBalances { get; set; }
 
     /// <summary>
-    /// تعداد تعادل شاخه راست در این هفته
+    /// [DEPRECATED] تعداد تعادل شاخه راست - استفاده نشود
     /// </summary>
+    [Obsolete("Use RightLegTotal instead")]
     public int RightLegBalances { get; set; }
 
-    /// <summary>
-    /// امتیاز کاربر: MIN(LeftLegBalances, RightLegBalances)
-    /// </summary>
-    public int TotalBalances { get; set; }
-
     /// <summary>
     /// مبلغی که از این کاربر به استخر هفتگی اضافه شد (ریال)
     /// </summary>