Discount Module — Admin

{
  "data": <payload>,
  "message": "Success",
  "statusCode": 200,
  "metadata": { /* optional, e.g. pagination */ }
}

type DiscountType         = "FIXED" | "PERCENTAGE";
type Platform             = "APP" | "WEB" | "BOTH";
type CustomerScope        = "ALL" | "INCLUDE" | "EXCLUDE";
type PurchaseHistoryMode  = "DISABLED" | "FIRST_ORDER" | "MIN_ORDERS";
type DiscountFilterMode   = "INCLUDE" | "EXCLUDE";

type DiscountFilterEntry = {
  id: string;
  mode: DiscountFilterMode;
};

type DiscountResponse = {
  id: string;
  name: string;                              // human-readable label
  code: string;                              // uppercase alnum + `-_`, 2..50
  isActive: boolean;
  archivedAt: string | null;                 // ISO
  platform: Platform;

  discountType: DiscountType;
  value: number;                             // subunits (FIXED) or whole-percent 1..100 (PERCENTAGE)

  minOrderAmount: number | null;             // subunits; null = no floor
  maxOrderAmount: number | null;             // subunits; null = no cap

  freeShipping: boolean;
  requireCustomerLogin: boolean;
  showOnCart: boolean;                       // suggest on cart page

  totalUsageLimit: number | null;            // platform-wide redemption cap
  usageLimitPerCustomer: number | null;
  startsAt: string | null;                   // ISO
  endsAt: string | null;                     // ISO
  individualUsageOnly: boolean;              // cannot stack with other coupons
  excludeSaleItems: boolean;
  excludeSaleItemsOverPercent: number | null; // 1..100

  purchaseHistoryMode: PurchaseHistoryMode;
  minOrderCount: number | null;              // required when MIN_ORDERS

  customerScope: CustomerScope;
  customerUserIds: string[];                 // applicable user ids when scope != ALL

  variants:    DiscountFilterEntry[];
  categories:  DiscountFilterEntry[];
  brands:      DiscountFilterEntry[];
  tags:        DiscountFilterEntry[];
  ingredients: DiscountFilterEntry[];
  vendors:     DiscountFilterEntry[];

  createdAt: string;
  updatedAt: string;
  deletedAt: string | null;
};

{
  "name": "Welcome 10%",
  "code": "WELCOME10",
  "isActive": true,
  "platform": "BOTH",

  "discountType": "PERCENTAGE",
  "value": 10,                            // 1..100 for PERCENTAGE; >= 1 subunits for FIXED

  "minOrderAmount": 50000,                // subunits; null/optional
  "maxOrderAmount": null,

  "freeShipping": false,
  "requireCustomerLogin": false,
  "showOnCart": true,

  "totalUsageLimit": null,
  "usageLimitPerCustomer": 1,
  "startsAt": "2026-05-01T00:00:00.000Z",
  "endsAt":   "2026-06-01T00:00:00.000Z",
  "individualUsageOnly": false,
  "excludeSaleItems": false,
  "excludeSaleItemsOverPercent": null,

  "purchaseHistoryMode": "FIRST_ORDER",
  "minOrderCount": null,

  "customerScope": "ALL",
  "customerUserIds": [],

  "variants":    [{ "id": "01J9...", "mode": "EXCLUDE" }],
  "categories":  [],
  "brands":      [{ "id": "01J9...", "mode": "INCLUDE" }],
  "tags":        [],
  "ingredients": [],
  "vendors":     []
}