feat(billing): cap active users on an owner subscription

Super admin can set a seat limit of 3, 10, 20, or a negotiated number so an owner cannot add users past that cap.

Co-authored-by: Cursor <cursoragent@cursor.com>

packages/shared/src/index.ts

@@ -351,6 +351,18 @@ export interface SetStorageQuotaRequest {
   quotaGb: number | null;
 }
 
+/** سقف‌های آمادهٔ تعداد کاربر. بالاتر از ۲۰ توافقی و با عدد جدا ذخیره می‌شود. */
+export const BILLING_USER_CAPS = [3, 10, 20] as const;
+
+export interface OwnerSeatUsageDto {
+  usedUsers: number;
+  maxUsers: number | null;
+}
+
+export interface SetUserCapRequest {
+  maxUsers: number;
+}
+
 export interface SubscriptionSummaryDto {
   planCode: BillingPlanCode;
   status: BillingAccountStatus;
@@ -369,6 +381,8 @@ export interface BillingAccountDto {
   startsAt: string;
   expiresAt: string;
   maxOrganizations: number;
+  /** null یعنی سقف کاربر هنوز تعیین نشده */
+  maxUsers?: number | null;
   externalPaymentRef?: string | null;
   notes?: string | null;
   daysRemaining: number;