feat(overview): add point-in-time, suspended, OR-group and count-range filters

lib/mv/constants.ex

@@ -44,6 +44,14 @@ defmodule Mv.Constants do
 
   @payment_filter_param "pay_filter"
 
+  @payment_count_min_param "pay_min"
+
+  @payment_count_max_param "pay_max"
+
+  @suspended_param "suspended"
+
+  @stichtag_param "stichtag"
+
   @max_boolean_filters 50
 
   @max_mailto_bulk_recipients 50
@@ -200,6 +208,49 @@ defmodule Mv.Constants do
   """
   def payment_filter_param, do: @payment_filter_param
 
+  @doc """
+  Returns the URL parameter name for the payment open-cycle count lower bound
+  (used with `pay_filter=has_unpaid` for the two-sided count range).
+
+  ## Examples
+
+      iex> Mv.Constants.payment_count_min_param()
+      "pay_min"
+  """
+  def payment_count_min_param, do: @payment_count_min_param
+
+  @doc """
+  Returns the URL parameter name for the payment open-cycle count upper bound.
+
+  ## Examples
+
+      iex> Mv.Constants.payment_count_max_param()
+      "pay_max"
+  """
+  def payment_count_max_param, do: @payment_count_max_param
+
+  @doc """
+  Returns the URL parameter name for the suspended-status filter flag.
+
+  ## Examples
+
+      iex> Mv.Constants.suspended_param()
+      "suspended"
+  """
+  def suspended_param, do: @suspended_param
+
+  @doc """
+  Returns the URL parameter name for the point-in-time membership ("Stichtag")
+  filter: keeps members who were active on the given ISO-8601 date X, i.e.
+  `join_date <= X and (exit_date is nil or exit_date > X)`.
+
+  ## Examples
+
+      iex> Mv.Constants.stichtag_param()
+      "stichtag"
+  """
+  def stichtag_param, do: @stichtag_param
+
   @doc """
   Returns the maximum number of boolean custom field filters allowed per request.