first commit

2026-09-28 11:44:26 +05:30
parent 721743ae6b
commit bffc9b1686
424 changed files with 46474 additions and 0 deletions
@@ -0,0 +1,53 @@
+using Fitness_core_BE.Models;
+
+namespace Fitness_core_BE.Interfaces
+{
+    public interface ICustomerSubscriptionRepository
+    {
+        Task AddCustomerSubscriptionAsync(
+            CustomerSubscription subscription,
+            CustomerSubItem initialSubItem,
+            SubscriptionMember primaryMember,
+            IReadOnlyCollection<SubscriptionInstallment> installments,
+            CancellationToken ct = default);
+        Task<CustomerPlan?> GetPlanByIdAsync(Guid customerPlanId, CancellationToken ct = default);
+        Task<bool> IsActiveCustomerAsync(Guid customerId, CancellationToken ct = default);
+        Task<List<CustomerSubItem>> GetSubItemsAsync(
+            Guid subscriptionId,
+            bool activeOnly,
+            bool newestFirst,
+            CancellationToken ct = default);
+        Task AddSubItemAsync(CustomerSubItem subItem, CancellationToken ct = default);
+        Task<CustomerInvoice?> GetLatestInvoiceAsync(Guid subscriptionId, CancellationToken ct = default);
+        Task<decimal> GetApprovedPaymentTotalAsync(Guid invoiceId, CancellationToken ct = default);
+        Task<CustomerCards?> GetCardByIdAsync(Guid cardId, CancellationToken ct = default);
+        Task<CustomerSubscription?> GetCustomerSubscriptionById(Guid subscriptionId);
+        Task<List<CustomerSubscription>> GetCustomerSubscriptionsByCustomerId(Guid customerId);
+        Task<CustomerSubscription?> GetActiveSubscriptionByCustomerId(Guid customerId);
+
+        // Whether this customer is currently an active member (primary OR secondary/group) of
+        // ANY subscription at this gym. GetActiveSubscriptionByCustomerId only sees subscriptions
+        // where they're the primary -- this also catches a group co-member, so "one customer, one
+        // plan at a time" can be enforced everywhere a plan gets assigned, not just the primary
+        // path.
+        Task<bool> HasAnyActiveSubscriptionAsync(Guid customerId, CancellationToken ct = default);
+
+        Task<SubscriptionMember> AddSubscriptionMemberAsync(SubscriptionMember member);
+        Task<int> GetActiveMemberCountAsync(Guid subscriptionId);
+        Task<SubscriptionMember?> GetSubscriptionMemberAsync(Guid subscriptionMemberId);
+        Task<SubscriptionMember?> GetActiveSubscriptionMemberByCustomerAsync(Guid subscriptionId, Guid customerId);
+        Task<List<CustomerSubscription>> GetSubscriptionsForCustomerAsync(Guid customerId);
+        Task<List<SubscriptionInstallment>> GetInstallmentsAsync(Guid subscriptionId);
+
+        // Renewal-approval workflow (SubscriptionRenewalApprovalService.ApproveAsync): advances
+        // RenewalDate only -- ExpiryDate is never touched again after creation.
+        Task AdvanceRenewalDateAsync(Guid subscriptionId, DateTime newRenewalDate, CancellationToken ct = default);
+
+        // Removes the subscription's current-cycle installment rows before a fresh schedule is
+        // added for the newly-approved cycle. Hard delete, not soft-deactivate: a unique index on
+        // (FKSubscriptionId, InstallmentNo) means a soft-deactivated row would still collide with
+        // the new cycle's schedule restarting at InstallmentNo 1 on the same subscription.
+        Task DeactivatePriorInstallmentsAsync(Guid subscriptionId, CancellationToken ct = default);
+        Task AddInstallmentsAsync(IReadOnlyCollection<SubscriptionInstallment> installments, CancellationToken ct = default);
+    }
+}