mmagym
    Preparing search index...

    Class SystemPreferences

    系統參數設定。

    此類別定義整個系統的可調整參數,影響會籍、退費、發票等邏輯。

    Index

    Properties

    ADMINISTRATOR_ROLES: string[] = ...

    管理員角色

    此數值用於限制管理員角色,預設為 ["HR_MANAGER", "HR_DEPUTY_MANAGER", "HR_TECH"]

    CASH_HANDOVER_INVOICE_STATUS: InvoiceStatus[] = ...

    可列入結帳交班的發票狀態。

    僅符合此設定的發票,才會出現在收銀機台管理中的銷售日記與銷售報表。

    • 銷售日記:顯示尚未交班的發票。
    • 銷售報表:顯示已交班的發票。

    預設為 ['ISSUED', 'ALLOWANCED', 'VOIDED']。

    COMPANY_EXTENDED_NAME: string

    公司延伸名稱(僅作顯示用)

    此數值僅用於顯示於前台,例如:「成吉思汗健身俱樂部進化綜合格鬥中心」。 系統在處理時不會使用此數值。

    COMPANY_FORMAL_NAME: string

    公司正式名稱(僅作顯示用)

    此數值僅用於顯示於前台,例如:「成吉思汗健身俱樂部」。 系統在處理時不會使用此數值。

    COMPANY_LOGO_FILE_KEY: string

    公司 LOGO 圖檔位置

    此數值僅用於顯示於前台,例如:「mmagym-logo.jpg」。 系統在處理時不會使用此數值。

    COMPANY_NAME: string

    公司中文名稱(僅作顯示用)

    此數值僅用於顯示於前台,例如:「成吉思汗」。 系統在處理時不會使用此數值。

    COMPANY_NAME_ENGLISH: string

    公司英文名稱(僅作顯示用)

    此數值僅用於顯示於前台,例如:「Cenghis Khan Jiansheng Hall Ltd.」。 系統在處理時不會使用此數值。

    CONTRACT_ADDITIONAL_PDF_ENABLED: boolean = false

    是否啟用「合約 PDF 附件」的功能。

    啟用後,在訂單簽約時可上傳額外的 PDF 附件。

    COURSE_CHECK_IN_AFTER_MINUTES: number = 30

    課程開始後多少分鐘仍可簽到。

    例如設定為 30,表示課程若 16:20 開始,學員與教練可以在 16:50 前完成簽到。

    COURSE_CHECK_IN_BEFORE_MINUTES: number = 10

    課程開始前多少分鐘可以簽到。

    例如設定為 10,表示課程若 16:20 開始,學員與教練可以從 16:10 起簽到。

    COURSE_EXECUTION_SHOW_PRICE: boolean = false

    課程執行顯示金額

    用於控制在顯示課程執行紀錄時,是否需要呈現金額資訊。
    設為 true 時會顯示金額,false 則隱藏金額。
    預設為 false。

    COURSE_SCHEDULE_DISPLAY_END_TIME_MODE: CourseScheduleEndTimeDisplayMode = CourseScheduleEndTimeDisplayMode.PRECISE

    課程結束時間顯示模式。

    PRECISE 精確顯示結束時間。例如:16:00 上課 20 分鐘 → 16:19:59.999
    ROUND_TO_MINUTES 四捨五入顯示結束時間。例如:16:00 上課 20 分鐘 → 16:20

    COURSE_TRAINER_GROUP_CLASS_ROLES: string[] = ...

    團體課教練角色

    用於限制可擔任團體課教練的員工角色。
    擁有此角色的員工在開設或更換團體課教練時可被指定為教練。
    預設為「有氧部」底下的角色。

    COURSE_TRAINER_PERSONAL_TRAINER_ROLES: string[] = ...

    個人教練角色

    用於限制可擔任私人教練的員工角色。
    擁有此角色的員工在簽署私人教練合約或更換教練時可被指定為教練。
    預設為「教練」及「教育訓練部門」底下的角色。

    CUSTOMER_ADDITIONAL_FIELDS: CustomerAdditionalField[] = []

    顧客額外欄位

    當顧客額外欄位被啟用時,可以在顧客詳細頁中看到該欄位,並且可以進行編輯修改,預設為 []。

    INSTALLMENT_PAUSE_DURING_SUSPENSION_WITH_PROOF: boolean = false

    是否在有請假證明的會員暫停期間,停止分期付款扣款。

    啟用後,當會員於請假期間提供有效的請假證明時,系統將暫停該期間的分期付款扣款。
    若未啟用,則即使會員提供請假證明,系統仍會依原排程持續進行扣款。

    INSTALLMENT_PERIODS: number[] = ...

    可供選擇的分期付款期數,用於付款流程中分期選項的顯示與限制。 範例:[3, 6, 12]

    INVOICE_CHECKOUT_EMAIL_VALIDATION_ENABLED: boolean

    結帳時是否驗證信箱

    若啟用,結帳時會強制驗證發票信箱進行過驗證信檢查

    INVOICE_GATEWAY_TYPE: InvoiceGatewayType = InvoiceGatewayType.ECPAY

    發票閘道類型

    此數值用於決定發票閘道的類型,預設為 ECPAY。 ECPAY 綠界發票閘道 BANK_PRO 金財通發票閘道

    INVOICE_NO_CARRIER_TAX_INFO_REQUIRED: boolean = false

    是否在使用「無載具」(例如 POS 機開立發票)時,強制檢查公司統一編號與發票抬頭名稱。

    啟用時:當選擇「無載具」作為發票載具類型,系統將強制檢查是否填寫了發票抬頭名稱與統一編號。
    未啟用時:即使選擇「無載具」,系統也不會檢查這兩項欄位是否填寫。

    INVOICE_SUPPORT_MOBILE_BARCODE_NOTIFY_EMAIL: boolean = false

    是否啟用「手機條碼」的發票通知信箱功能。

    啟用後,當選擇「手機條碼」作為發票載具時,將會顯示「發票通知信箱」輸入欄位,
    且此欄位為必填,若未填寫將顯示錯誤訊息。
    發票開立成功後,系統會透過此信箱發送發票通知信。

    INVOICE_SUPPORT_NO_CARRIER_TYPE: boolean = false

    是否啟用發票支援無載具(POS 機開發票)。

    若啟用,在選擇發票的載具類型時,會新增「無載具」選項。
    發票開立時,會使用 POS 機開紙本發票

    INVOICE_VALIDATOR_TYPE: InvoiceValidatorType = InvoiceValidatorType.FORMAT

    發票格式驗證類型

    FORMAT 僅檢查格式是否符合規則 ECPAY 使用綠界 API 進行驗證

    IS_MIXED_PAYMENT_ENABLED: boolean = false

    是否啟用混合支付

    此數值用於啟用混合支付,預設為 false。

    MEMBER_MANUAL_ENTRY_TYPE

    MEMBER_MANUAL_ENTRY_TYPE: GateAccessLogType = GateAccessLogType.MANUAL

    會員手動入場方式

    MANUAL 手動入場 BARCODE 條碼入場

    MEMBERSHIP_DATE_RANGE_TO_YEAR: boolean = false

    是否支援會籍日期自動延伸至年底。

    若啟用,合約模板將可選擇「至年底」的日期選項,
    並在簽約時自動計算會籍日期範圍。例如:2025/07/16 簽約時,
    合約會籍期間將為 2025/07/01 ~ 2025/12/31。

    MEMBERSHIP_MAX_GIFT_MONTHS: number = 24

    會籍最大贈送月數

    此數值用於限制會籍合約的贈送月數,預設為 24 個月。

    MEMBERSHIP_MAX_INSTALLMENT_MAX_PERIODS: number = 24

    會籍分期最大期數

    此數值用於限制會籍合約的分期最大期數,預設為 24 期。

    MEMBERSHIP_MAX_MONTHS: number = 36

    會籍最大月數限制

    當限制模式為 'MAX_LIMIT' 時,使用者可選擇 1 到此數值之間的任意月數 預設為 36 個月

    MEMBERSHIP_MONTHS_CONSTRAINT_MODE: MembershipMonthsConstraintMode = MembershipMonthsConstraintMode.MAX_LIMIT

    會籍月份限制模式

    定義會籍合約月份的限制方式:

    • 'FIXED_OPTIONS': 只能選擇預定義的月份選項
    • 'MAX_LIMIT': 可選擇任意月份,但不超過最大值

    預設為 'FIXED_OPTIONS'

    MEMBERSHIP_MONTHS_OPTIONS: number[] = ...

    會籍月份選項清單

    當限制模式為 'FIXED_OPTIONS' 時,使用者只能從此清單中選擇月數 例如: [1, 6, 12, 24] 表示只能選 1、6、12 或 24 個月

    MEMBERSHIP_REFUND_PAST_FROZEN_CONTRACT_ROLES: string[] = []

    擁有處理過去已凍結之會籍合約退款作業權限的角色 ID 清單。

    範例:['HR_MANAGER', 'HR_DEPUTY_MANAGER', 'HR_TECH']

    MEMBERSHIP_SUPPORT_REGIONAL_ACCESS_PASS: boolean = false

    是否啟用會籍合約的區域通館功能。

    若啟用,會籍合約模板中將出現「是否通館」的選項,
    並可於簽約時選擇通館的區域館別,例如:全台通館、北區通館、中區通館、南區通館。
    完成簽約後,該會籍合約即具備通館功能。

    MEMBERSHIP_SUSPENSION_EXPIRY_NOTICE_DAYS: number = 7

    會籍請假到期前的通知天數。

    系統會在請假到期前指定天數發送提醒通知給會員。
    預設為 7(即到期前七天提醒)。

    MEMBERSHIP_SUSPENSION_START_DATE_UNLIMITED_ROLES: string[]

    會籍暫停不對開始日期限制的角色

    此數值用於限制會籍暫停不對開始日期限制的角色,預設為 []。

    MEMBERSHIP_SUSPENSION_WITHOUT_PROOF_MAX_MONTHS: number = 12

    會籍暫停無證明最大月數

    此數值用於限制會籍暫停無證明最大月數,預設為 12 個月。

    ORDER_ALLOW_OPTIONAL_CUSTOMER: boolean = true

    是否允許訂單選擇性填寫客戶資訊。

    若啟用,建立商品訂單時,客戶資訊欄位將變為選填。
    若關閉,強制要求先建立好客戶資料,才能進行訂單建立。

    PAYMENT_GATEWAY_TYPE: PaymentGatewayType = PaymentGatewayType.ECPAY

    金流閘道類型

    此數值用於決定金流閘道的類型,預設為 ECPAY。 ECPAY 綠界金流閘道 CTBC 中國信託金流閘道

    PERSONAL_TRAINER_GROUP_COURSE_MIN_ATTENDEES: number = 2

    小班制開課的最小簽到人數。

    表示小班制合約必須至少有兩位學員(不含教練)簽到,該堂課才視為開課成功。

    REFUND_ALLOWANCE_EXIST_INVOICES: boolean

    退費合約成立是否需要折讓原發票

    若啟用,當退費成功時,被退費合約上的發票將會被折讓

    TRANSFER_FEE: number = 30

    電匯手續費(僅作顯示用)

    此數值僅用於顯示於退費流程中,讓消費者知悉電匯手續費金額。 系統在退費金額計算或實際處理時不會使用此數值。