efrilmandClaude Opus 5.5
9ce55e6002
Settles note N4 of docs/prd-point-coin.md: both expiry models are
supported, chosen per currency by the owner, defaulting to one fixed date a
year (PC-501, F12).
New organization keys, per currency (loyalty.point.* / loyalty.coin.*):
- expiry_mode: FIXED_DATE (default) or ROLLING.
- expiry_fixed_dates: the days of the year balances expire on, as sorted
MM-DD values ("12-31" by default, "06-30,12-31" for twice a year). 29 Feb
is refused.
- expiry_grace_months: 0 to 24, default 3. A balance lasts at least this
long before a fixed date takes it.
The existing period, unit and end_of_month keys now belong to ROLLING, and
reminder_days to both.
ComputeExpiry gives the expiry of a balance received at a time: the first
fixed date on or after the day received plus the grace months, or the day
received plus the period (to the end of that month when asked). Days are
the customer's (WIB), a shorter month keeps to its last day, and a lot
lasts to 23:59:59 of its day so the apps group it under that day. Nil when
expiry is off. ActivationExpiry, RefundExpiry and EarlierExpiry hold the
other decided rules and are used by PC-502.
GET and PUT /marketing/loyalty-settings return expiry_preview: when a
balance received now would expire, for the dashboard's "received today
expires on ..." hint, also on a dry run.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
87 lines
3.4 KiB
Go
87 lines
3.4 KiB
Go
package constants
|
|
|
|
// Loyalty setting keys (docs/prd-point-coin.md F1, F2, F12). Outlet keys live in
|
|
// outlet_settings and organization keys in organization_settings. A key that was
|
|
// never set takes the default in the PRD.
|
|
|
|
// Per outlet (F1): what an order earns, and whether EnakPoint can pay.
|
|
const (
|
|
LoyaltyPointEnabledKey = "loyalty.point.enabled"
|
|
LoyaltyPointEarnPerAmountKey = "loyalty.point.earn_per_amount"
|
|
LoyaltyPointEarnValueKey = "loyalty.point.earn_value"
|
|
LoyaltyPointMinOrderAmountKey = "loyalty.point.min_order_amount"
|
|
LoyaltyPointMaxPerOrderKey = "loyalty.point.max_per_order"
|
|
|
|
LoyaltyCoinEnabledKey = "loyalty.coin.enabled"
|
|
LoyaltyCoinEarnPerAmountKey = "loyalty.coin.earn_per_amount"
|
|
LoyaltyCoinEarnValueKey = "loyalty.coin.earn_value"
|
|
LoyaltyCoinMinOrderAmountKey = "loyalty.coin.min_order_amount"
|
|
LoyaltyCoinMaxPerOrderKey = "loyalty.coin.max_per_order"
|
|
|
|
LoyaltyPointAcceptPaymentKey = "loyalty.point.accept_payment"
|
|
LoyaltyPointMinPaymentPointsKey = "loyalty.point.min_payment_points"
|
|
LoyaltyPointMaxPaymentPercentKey = "loyalty.point.max_payment_percent"
|
|
)
|
|
|
|
// Per organization (F2, F12): the value of EnakPoint, the exchange rate, transfers and
|
|
// expiry, which must be the same in every outlet.
|
|
const (
|
|
LoyaltyPointValueKey = "loyalty.point.value"
|
|
|
|
LoyaltyExchangeCoinAmountKey = "loyalty.exchange.coin_amount"
|
|
LoyaltyExchangePointAmountKey = "loyalty.exchange.point_amount"
|
|
|
|
LoyaltyTransferEnabledKey = "loyalty.transfer.enabled"
|
|
LoyaltyTransferMinAmountKey = "loyalty.transfer.min_amount"
|
|
LoyaltyTransferMaxPerTransactionKey = "loyalty.transfer.max_per_transaction"
|
|
LoyaltyTransferDailyLimitKey = "loyalty.transfer.daily_limit"
|
|
|
|
// Suffixes after "loyalty.point." or "loyalty.coin.".
|
|
LoyaltyExpiryEnabledSuffix = "expiry_enabled"
|
|
LoyaltyExpiryPeriodSuffix = "expiry_period"
|
|
LoyaltyExpiryUnitSuffix = "expiry_unit"
|
|
LoyaltyExpiryEndOfMonthSuffix = "expiry_end_of_month"
|
|
LoyaltyExpiryReminderDaysSuffix = "expiry_reminder_days"
|
|
LoyaltyExpiryModeSuffix = "expiry_mode"
|
|
LoyaltyExpiryFixedDatesSuffix = "expiry_fixed_dates"
|
|
LoyaltyExpiryGraceMonthsSuffix = "expiry_grace_months"
|
|
)
|
|
|
|
// Units of loyalty.{point,coin}.expiry_unit.
|
|
const (
|
|
LoyaltyExpiryUnitDay = "DAY"
|
|
LoyaltyExpiryUnitMonth = "MONTH"
|
|
)
|
|
|
|
// Modes of loyalty.{point,coin}.expiry_mode (note N4, decided: both are supported).
|
|
const (
|
|
// Every balance expires on the same fixed dates of the year, such as 31 Dec.
|
|
LoyaltyExpiryModeFixedDate = "FIXED_DATE"
|
|
// Every balance lasts a period from when it was received.
|
|
LoyaltyExpiryModeRolling = "ROLLING"
|
|
)
|
|
|
|
// Defaults from the PRD.
|
|
const (
|
|
LoyaltyPointEarnPerAmountDefault = int64(100)
|
|
LoyaltyCoinEarnPerAmountDefault = int64(25000)
|
|
LoyaltyEarnValueDefault = int64(1)
|
|
|
|
LoyaltyMinPaymentPointsDefault = int64(1)
|
|
LoyaltyMaxPaymentPercentDefault = int64(100)
|
|
|
|
LoyaltyPointValueDefault = int64(1)
|
|
LoyaltyExchangeAmountDefault = int64(1)
|
|
|
|
LoyaltyTransferEnabledDefault = true
|
|
LoyaltyTransferMinAmountDefault = int64(1)
|
|
|
|
LoyaltyExpiryPeriodDefault = int64(12)
|
|
LoyaltyExpiryUnitDefault = LoyaltyExpiryUnitMonth
|
|
LoyaltyExpiryReminderDaysDefault = int64(7)
|
|
LoyaltyExpiryModeDefault = LoyaltyExpiryModeFixedDate
|
|
// Once a year on 31 December, as MM-DD.
|
|
LoyaltyExpiryFixedDatesDefault = "12-31"
|
|
LoyaltyExpiryGraceMonthsDefault = int64(3)
|
|
)
|