Saavo

DB

主要業務資料庫的全部資料表和欄位。

DB 是預設範本的業務資料庫，初始資料表結構由 schema/db-init.sql 定義。這裡依資料表介紹帳號、驗證、OAuth 2.0、權限、付款、客服案件、通知、聯盟行銷和 Reaction 資料，包含欄位型別、是否允許空值、預設值和資料庫約束。

時間與布林值

時間欄位使用 Unix 毫秒。布林狀態使用 SQLite INTEGER 儲存，通常以 1 表示是、0 表示否。

ticket

儲存客服案件的檢索欄位和狀態。案件內文儲存在 MAIN_KV，透過 kv_id 關聯。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
requester_idINTEGER否——提交客服案件的使用者 ID，小於或等於 0 時表示匿名提交人。
assignee_idINTEGER是——負責處理客服案件的後台使用者 ID。
kv_idTEXT否——案件內文在 MAIN_KV 中使用的唯一 Key。
statusTEXT否'open'—目前狀態。
priorityINTEGER否0—優先順序，數值越大表示優先順序越高。
ticket_typeTEXT是——客服案件類型。
productTEXT是——客服案件關聯的產品。
titleTEXT是——標題。
nameTEXT是——名稱。
emailTEXT是——電子郵件地址。
requester_unreadINTEGER否0—請求者是否有未讀回覆，1 表示有，0 表示沒有。
closed_atINTEGER是——客服案件關閉時間，Unix 毫秒。
resolved_atINTEGER是——客服案件解決時間，Unix 毫秒。
deleted_atINTEGER否0—虛刪除時間，0 表示未刪除。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。
updated_atINTEGER否目前的 Unix 毫秒時間—最後更新時間，Unix 毫秒。

newsletter_subscriber

儲存電子郵件訂閱地址、語言和訂閱時間。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
emailTEXT否——電子郵件地址。
localeTEXT否——語言代碼。
subscribed_atINTEGER否目前的 Unix 毫秒時間—訂閱郵件清單的時間，Unix 毫秒。

saas_user

儲存使用者帳號、登入服務供應商、雙重驗證和聯盟行銷相關狀態。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
emailTEXT是——電子郵件地址。
email_hashTEXT否——正規化電子郵件地址的摘要，用於判斷唯一性和安全查詢。
email_verifiedINTEGER否0—電子郵件地址是否已驗證，1 表示已驗證。
user_nameTEXT否——使用者名稱。
display_nameTEXT是——顯示名稱。
password_hashTEXT是——密碼摘要，使用第三方登入且未設定密碼時為空值。
account_idTEXT是——登入服務供應商傳回的帳號 ID。
image_urlTEXT是——個人頭像網址。
blog_urlTEXT是——使用者首頁或部落格網址。
providerTEXT否'email'—帳號登入服務供應商。
two_factor_enabledINTEGER否0—是否啟用雙重驗證，1 表示啟用。
totp_keyBLOB是——加密儲存的 TOTP 金鑰。
recovery_codesJSON否'[]'—復原碼摘要陣列。
recovery_codes_generated_atINTEGER否0—最近一次產生復原碼的時間，Unix 毫秒。
deleted_atINTEGER否0—虛刪除時間，0 表示未刪除。
deleted_reasonTEXT是——虛刪除原因。
disabled_atINTEGER否0—停用時間，0 表示未停用。
disabled_reasonTEXT是——停用原因。
disabled_expires_atINTEGER否0—暫時停用的結束時間，0 表示未設定結束時間。
invited_by_idINTEGER是——邀請這位使用者的推廣者使用者 ID。
own_referral_codeTEXT否——指派給這位使用者的唯一推廣碼。
affiliate_enabled_atINTEGER否0—啟用聯盟行銷資格的時間，0 表示未啟用。
affiliate_disabled_atINTEGER否0—停用聯盟行銷資格的時間，0 表示未停用。
affiliate_disabled_reasonTEXT是——停用聯盟行銷資格的原因。
affiliate_disabled_by_idINTEGER是——執行停用操作的後台使用者 ID。
referral_statusTEXT是——推薦關係資格狀態。
referral_status_reasonTEXT是——推薦關係資格狀態變更的原因。
referral_status_changed_atINTEGER否0—推薦關係資格狀態最近一次變更的時間，0 表示尚未記錄。
referral_status_changed_by_idINTEGER是——修改推薦關係資格狀態的後台使用者 ID。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。
updated_atINTEGER否目前的 Unix 毫秒時間—最後更新時間，Unix 毫秒。

notification

儲存站內通知內容、對象範圍、發布狀態和統計數量。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
audience_typeTEXT否——通知對象類型：全部使用者或指定使用者。
recipient_countINTEGER否0—通知目標使用者人數。
read_countINTEGER否0—已讀使用者人數。
titleTEXT否——標題。
summaryTEXT否——摘要。
messageJSON否——結構化通知內容。
statusTEXT否——目前狀態。
created_by_user_idINTEGER是——建立這筆紀錄的後台使用者 ID。
published_atINTEGER是——通知發布時間，Unix 毫秒。
expires_atINTEGER是——到期時間，Unix 毫秒。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

user_notification

儲存使用者對通知的已讀和關閉狀態，以及更新已讀人數時使用的並行控制標記。

欄位型別可為空值預設值索引鍵含義
user_idINTEGER否—PK（複合）使用者 ID。
notification_idTEXT否—PK（複合）通知 ID。
read_atINTEGER是——使用者讀取通知的時間，Unix 毫秒。
dismissed_atINTEGER是——使用者關閉通知的時間，Unix 毫秒。
read_claim_idTEXT是——並行更新已讀人數時使用的唯一識別碼。

affiliate_payout_profiles

加密儲存推廣者的收款資料。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
user_idINTEGER否——使用者 ID。
payment_methodTEXT否——收款方式。
encrypted_detailsBLOB否——加密後的收款資料。
payment_account_fingerprintTEXT否——收款帳號指紋，用於判斷資料是否重複。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。

affiliate_commissions

儲存每筆推廣佣金的來源、計算快照和有效狀態。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
affiliate_user_idINTEGER否——取得佣金或結算款的推廣者使用者 ID。
referred_user_idINTEGER否——透過推廣關係註冊或購買的使用者 ID。
product_idTEXT否——產品 Key，對應 config/products.ts。
plan_idTEXT否——方案 Key，對應 config/products.ts。
providerTEXT否——產生佣金的付款服務供應商。
connection_idTEXT否——付款連線 ID，對應 config/payment.ts。
transaction_idTEXT否——交易 ID。
transaction_item_idTEXT否——交易明細 ID。
provider_line_item_idTEXT否——付款服務供應商中的明細 ID。
provider_price_idTEXT是——付款服務供應商中的 Price ID。
transaction_statusTEXT否——產生佣金時記錄的交易狀態。
payment_kindTEXT否——付款類型：一次性付款或訂閱付款。
subscription_idTEXT是——訂閱 ID。
quantityINTEGER是——數量。
unit_amount_minorINTEGER是——單價，使用貨幣最小單位。
unit_amount_decimalTEXT是——付款服務供應商傳回的高精度單價字串。
subtotal_minorINTEGER是——折扣和稅費前的小計，使用貨幣最小單位。
discount_minorINTEGER是——折扣金額，使用貨幣最小單位。
tax_minorINTEGER是——稅額，使用貨幣最小單位。
total_minorINTEGER否——總金額，使用貨幣最小單位。
currencyTEXT否——幣別代碼。
calculation_typeTEXT否——佣金計算方式：固定金額或依比例計算。
percentage_basis_pointsINTEGER是——佣金比例，單位為基點，10000 表示 100%。
percentage_baseTEXT是——依比例計算佣金時採用的金額基準。
fixed_amount_minorINTEGER是——固定佣金金額，使用貨幣最小單位。
fixed_currencyTEXT是——固定佣金使用的幣別。
statusTEXT否'valid'—目前狀態。
status_reason_codeTEXT是——佣金失效或退款原因代碼。
status_reasonTEXT是——使用自訂原因代碼時填寫的原因。
status_internal_noteTEXT是——僅供後台查看的狀態備註。
status_changed_atINTEGER否0—狀態最近一次變更的時間，0 表示尚未記錄。
status_changed_by_idINTEGER是——修改狀態的後台使用者 ID。
earned_atINTEGER是——佣金確認時間，Unix 毫秒。
available_atINTEGER是——佣金進入可結算狀態的時間，Unix 毫秒。
deleted_atINTEGER否0—虛刪除時間，0 表示未刪除。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。

affiliate_monthly_payouts

依推廣者、月份和幣別彙總佣金及付款狀態。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
affiliate_user_idINTEGER否——取得佣金或結算款的推廣者使用者 ID。
period_startINTEGER否——結算月份的開始時間，Unix 毫秒。
currencyTEXT否——幣別代碼。
calculated_referred_user_countINTEGER否0—納入本期結算的受推薦使用者人數。
calculated_commission_countINTEGER否0—本期佣金紀錄總數。
calculated_valid_countINTEGER否0—本期有效佣金紀錄筆數。
calculated_refunded_countINTEGER否0—本期已退款佣金紀錄筆數。
calculated_invalid_countINTEGER否0—本期無效佣金紀錄筆數。
calculated_total_payment_amount_minorINTEGER否0—本期付款總金額，使用貨幣最小單位。
calculated_valid_payment_amount_minorINTEGER否0—產生有效佣金的付款金額，使用貨幣最小單位。
calculated_valid_commission_amount_minorINTEGER否0—本期有效佣金金額，使用貨幣最小單位。
calculated_refunded_commission_amount_minorINTEGER否0—本期已退款佣金金額，使用貨幣最小單位。
calculated_invalid_commission_amount_minorINTEGER否0—本期無效佣金金額，使用貨幣最小單位。
calculation_changed_atINTEGER否0—結算金額最近一次變動的時間。
statusTEXT否'draft'—目前狀態。
requested_atINTEGER否0—提交結算申請的時間，0 表示尚未申請。
actual_paid_amount_minorINTEGER是——實際付款金額，使用貨幣最小單位。
paid_atINTEGER否0—每月結算的實際付款時間，0 表示尚未付款。
paid_by_idINTEGER是——登記付款的後台使用者 ID。
email_content_jsonJSON是——結算通知郵件的內容快照。
send_emailINTEGER否0—是否寄送結算通知郵件，1 表示寄送。
email_sent_atINTEGER否0—結算通知郵件寄送成功的時間，0 表示尚未寄送。
email_failure_reasonTEXT是——結算通知郵件寄送失敗的原因。
manual_updated_atINTEGER否0—後台手動修改結算紀錄的時間，0 表示未修改。
manual_updated_by_idINTEGER是——執行手動修改的後台使用者 ID。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。

affiliate_monthly_payout_records

儲存每月結算的各次實際付款紀錄和收款資料快照。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
monthly_payout_idINTEGER否——每月結算紀錄 ID。
revisionINTEGER否——同一筆每月結算之下的付款紀錄版本號碼。
calculated_amount_minorINTEGER否——記錄付款時算出的應付金額，使用貨幣最小單位。
calculation_changed_atINTEGER否——結算金額最近一次變動的時間。
actual_paid_amount_minorINTEGER否——實際付款金額，使用貨幣最小單位。
difference_reasonTEXT否''—實際付款金額與計算金額不一致的原因。
internal_noteTEXT否''—僅供後台查看的備註。
paid_atINTEGER否——本次付款實際發生的時間，Unix 毫秒。
encrypted_payout_profileBLOB否——付款時使用的加密收款資料快照。
saved_atINTEGER否——付款紀錄儲存時間，Unix 毫秒。
saved_by_idINTEGER否——儲存付款紀錄的後台使用者 ID。

saas_session

儲存使用者登入工作階段、有效期限和最近活動資訊。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
user_idINTEGER否——使用者 ID。
expires_atINTEGER否——到期時間，Unix 毫秒。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。
last_seen_atINTEGER否目前的 Unix 毫秒時間—最近一次活動時間，Unix 毫秒。
ipTEXT是——IP 位址。
user_agentTEXT是——User-Agent。
countryTEXT是——國家或地區代碼。
two_factor_verifiedINTEGER否0—目前流程是否已通過雙重驗證，1 表示已通過。

two_factor_setup_session

儲存雙重驗證設定或更換過程中的暫存金鑰和復原碼。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
user_idINTEGER否—FK → saas_user.id（串聯刪除）使用者 ID。
saas_session_idTEXT否—FK → saas_session.id（串聯刪除）登入工作階段 ID。
purposeTEXT否——這個暫存工作階段的用途。
encrypted_totp_keyBLOB否——設定期間加密儲存的 TOTP 金鑰。
recovery_codesJSON否——復原碼摘要陣列。
encrypted_recovery_codesBLOB否——設定期間加密儲存的復原碼。
attempt_countINTEGER否0—已嘗試驗證的次數。
claimed_atINTEGER否0—取得這筆暫存紀錄處理權的時間，0 表示尚未處理。
consumed_atINTEGER否0—這筆暫存紀錄使用完畢的時間，0 表示尚未使用。
expires_atINTEGER否——到期時間，Unix 毫秒。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。

email_verification_session

儲存電子郵件驗證流程使用的驗證碼和有效期限。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
user_idINTEGER否——使用者 ID。
emailTEXT否——電子郵件地址。
codeTEXT否——驗證碼或授權碼。
typeTEXT否——紀錄類型。
attempt_countINTEGER否0—已嘗試驗證的次數。
expires_atINTEGER否——到期時間，Unix 毫秒。

password_reset_session

儲存密碼重設流程的驗證碼、驗證狀態和有效期限。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
user_idINTEGER否——使用者 ID。
emailTEXT否——電子郵件地址。
codeTEXT否——驗證碼或授權碼。
typeTEXT是——紀錄類型。
attempt_countINTEGER否0—已嘗試驗證的次數。
expires_atINTEGER否——到期時間，Unix 毫秒。
email_verifiedINTEGER否0—電子郵件地址是否已驗證，1 表示已驗證。
two_factor_verifiedINTEGER否0—目前流程是否已通過雙重驗證，1 表示已通過。

oauth_auth_session

儲存 OAuth 2.0 授權請求在使用者確認前的暫存狀態。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
user_idINTEGER是——使用者 ID。
client_idTEXT否——OAuth 2.0 用戶端 ID。
redirect_uriTEXT否——本次授權請求使用的回呼網址。
response_typeTEXT否——OAuth 2.0 Response Type。
scopeTEXT是——本次授權請求的 Scope 字串。
stateTEXT是——OAuth 2.0 State，用於關聯授權請求並防止 CSRF。
code_challengeTEXT是——PKCE Code Challenge。
code_challenge_methodTEXT是——PKCE Code Challenge Method。
approved_atINTEGER是NULL—使用者確認授權的時間。
upgrade_detailsJSON是NULL—授權過程中使用的升級提示資料。
expires_atINTEGER否——到期時間，Unix 毫秒。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。

oauth_client

儲存 OAuth 2.0 用戶端、回呼網址、授權方式和 Scope。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
nameTEXT否——名稱。
secretTEXT是——OAuth 2.0 用戶端 Secret 的摘要，公開用戶端可為空值。
owner_user_idINTEGER是NULL—OAuth 2.0 用戶端擁有者的使用者 ID。
redirect_urisJSON否'[]'—用戶端允許使用的回呼網址陣列。
allowed_grantsJSON否'[]'—用戶端允許使用的授權方式陣列。
scopesJSON否'[]'—Scope 陣列。
logo_uriTEXT是——用戶端 Logo 網址。
homepage_uriTEXT是——用戶端首頁網址。
descriptionTEXT是——說明文字。
privacy_policy_uriTEXT是——隱私權政策網址。
terms_of_service_uriTEXT是——服務條款網址。
disabled_atINTEGER否0—停用時間，0 表示未停用。
deleted_atINTEGER否0—虛刪除時間，0 表示未刪除。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。
updated_atINTEGER否目前的 Unix 毫秒時間—最後更新時間，Unix 毫秒。

oauth_auth_code

儲存 OAuth 2.0 授權碼及 PKCE 資訊。

欄位型別可為空值預設值索引鍵含義
codeTEXT否—PK驗證碼或授權碼。
redirect_uriTEXT是——本次授權請求使用的回呼網址。
code_challengeTEXT是——PKCE Code Challenge。
code_challenge_methodTEXT是'plain'—PKCE Code Challenge Method。
expires_atINTEGER否——到期時間，Unix 毫秒。
user_idINTEGER是NULL—使用者 ID。
client_idTEXT否——OAuth 2.0 用戶端 ID。
scopesJSON否'[]'—Scope 陣列。
revoked_atINTEGER否0—撤銷時間，0 表示未撤銷。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。
updated_atINTEGER否目前的 Unix 毫秒時間—最後更新時間，Unix 毫秒。

oauth_token

儲存 OAuth 2.0 Access Token 和 Refresh Token。

欄位型別可為空值預設值索引鍵含義
access_tokenTEXT否—PKAccess Token，也是這張資料表的主索引鍵。
access_token_expires_atINTEGER否——Access Token 到期時間，Unix 毫秒。
refresh_tokenTEXT是——Refresh Token。
refresh_token_expires_atINTEGER是NULL—Refresh Token 到期時間，Unix 毫秒。
client_idTEXT否——OAuth 2.0 用戶端 ID。
user_idINTEGER是NULL—使用者 ID。
oauth_codeTEXT是NULL—核發這個 Token 時使用的授權碼。
scopesJSON否'[]'—Scope 陣列。
revoked_atINTEGER否0—撤銷時間，0 表示未撤銷。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。
updated_atINTEGER否目前的 Unix 毫秒時間—最後更新時間，Unix 毫秒。

user_role_capability

儲存角色授予後，展開至 Subject 的靜態能力。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
subject_typeTEXT否——Subject 類型。
subject_idTEXT否——Subject ID。
user_idINTEGER是——使用者 ID。
event_idTEXT是——授予這項角色能力的 Reaction Event ID。
command_idTEXT是——授予這項角色能力的 Reaction Command ID。
source_typeTEXT否——角色授予來源的類型。
source_keyTEXT否——角色或權益的來源 Key。
role_keyTEXT否——角色 Key，對應 config/roles.ts。
capability_keyTEXT否——能力 Key，對應 config/capability.ts。
starts_atINTEGER是NULL—生效時間，Unix 毫秒。
ends_atINTEGER是NULL—結束時間，Unix 毫秒。
metadataJSON是——業務中繼資料。
deleted_atINTEGER否0—虛刪除時間，0 表示未刪除。
disabled_atINTEGER否0—停用時間，0 表示未停用。
disabled_reasonTEXT是——停用原因。
disabled_expires_atINTEGER否0—暫時停用的結束時間，0 表示未設定結束時間。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。
updated_atINTEGER否目前的 Unix 毫秒時間—最後更新時間，Unix 毫秒。

user_entitlement_capability

儲存權益授予後，展開至 Subject 的布林能力或額度能力。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
subject_typeTEXT否——Subject 類型。
subject_idTEXT否——Subject ID。
user_idINTEGER是——使用者 ID。
event_idTEXT是——授予這項權益能力的 Reaction Event ID。
command_idTEXT是——授予這項權益能力的 Reaction Command ID。
source_typeTEXT否——權益授予來源的類型。
source_keyTEXT否——角色或權益的來源 Key。
source_quantityINTEGER否1—來源授予的數量。
source_unit_limitINTEGER是NULL—每個來源單位提供的額度。
entitlement_keyTEXT否——權益 Key，對應 config/entitlements.ts。
capability_keyTEXT否——能力 Key，對應 config/capability.ts。
capability_typeTEXT否——能力類型。
priorityINTEGER否0—優先順序，數值越大表示優先順序越高。
rolloverINTEGER否0—週期結束時是否將未使用額度累計至下一個週期，1 表示累計。
quota_limitINTEGER否0—額度上限。
quota_totalINTEGER否0—目前可用額度總量。
quota_usedINTEGER否0—目前已使用額度。
quota_used_reset_modeTEXT否'clear'—重設週期到期時，已用額度的處理方式。
starts_atINTEGER是NULL—生效時間，Unix 毫秒。
ends_atINTEGER是NULL—結束時間，Unix 毫秒。
reset_alignmentTEXT是NULL—額度週期的對齊方式。
reset_intervalTEXT是NULL—額度重設週期單位。
reset_interval_countINTEGER否0—每個額度週期包含的單位數量。
anchor_atINTEGER否——額度週期的錨點時間，Unix 毫秒。
reset_period_countINTEGER是0—已完成的額度週期數量。
anchor_reset_atINTEGER是——根據錨點算出的本週期重設時間。
metadataJSON是——業務中繼資料。
deleted_atINTEGER否0—虛刪除時間，0 表示未刪除。
disabled_atINTEGER否0—停用時間，0 表示未停用。
disabled_reasonTEXT是——停用原因。
disabled_expires_atINTEGER否0—暫時停用的結束時間，0 表示未設定結束時間。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。
updated_atINTEGER否目前的 Unix 毫秒時間—最後更新時間，Unix 毫秒。

capability_quota_event

儲存額度能力的增加、扣減、重設，以及將額度累計至下一個週期的紀錄。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
subject_typeTEXT否——Subject 類型。
subject_idTEXT否——Subject ID。
user_idINTEGER是——使用者 ID。
source_typeTEXT否——產生額度紀錄的來源類型。
source_keyTEXT否——角色或權益的來源 Key。
entitlement_keyTEXT否——權益 Key，對應 config/entitlements.ts。
capability_keyTEXT否——能力 Key，對應 config/capability.ts。
event_typeTEXT否——額度變動類型，例如授予、使用或重設。
deltaINTEGER否——本次額度變動量，正數表示增加，負數表示扣減。
reasonTEXT是——本次額度變動的原因。
metadataTEXT是——業務中繼資料。
created_atINTEGER否目前的 Unix 毫秒時間—建立時間，Unix 毫秒。

event_execution

儲存 Reaction Event 的輸入快照、等冪鍵和執行租用資訊。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
user_idINTEGER是——使用者 ID。
event_typeTEXT否——Reaction Event 類型。
event_versionINTEGER否——Event 定義版本。
idempotency_keyTEXT否——Event 等冪鍵。
continue_on_failureINTEGER否——Command 業務執行失敗後，是否繼續執行後續 Command。
payloadTEXT否——序列化後的輸入資料。
created_atINTEGER否——建立時間，Unix 毫秒。
lease_tokenTEXT是——目前執行租用的 Token。
lease_expires_atINTEGER是——目前執行租用的到期時間。

command_execution

儲存 Event 產生的 Command、執行順序、重試次數和結果。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
event_execution_idTEXT否—FK → event_execution.id（刪除 Event 時串聯刪除）所屬 Event 執行紀錄 ID。
user_idINTEGER是——使用者 ID。
command_keyTEXT否——同一次 Event 中唯一的 Command 步驟名稱。
command_typeTEXT否——Command 類型。
command_versionINTEGER否——Command 定義版本。
modeTEXT否——Command 執行模式：sync 或 async。
max_attemptsINTEGER否——允許自動執行的最大次數。
sequenceINTEGER否——Command 在 Event 中的執行順序。
payloadTEXT否——序列化後的輸入資料。
statusTEXT否——目前狀態。
attempt_countINTEGER否0—已執行的次數。
resultTEXT是——序列化後的 Command 回傳結果。
last_errorTEXT是——最近一次處理失敗的錯誤訊息。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。
completed_atINTEGER是——完成時間，Unix 毫秒。

webhook_events

儲存付款服務供應商 Webhook 的原始請求、處理狀態和失敗資訊。

欄位型別可為空值預設值索引鍵含義
idINTEGER否—PK紀錄主索引鍵。
providerTEXT否——傳送 Webhook 的付款服務供應商。
connection_idTEXT否——付款連線 ID，對應 config/payment.ts。
event_idTEXT否——付款服務供應商提供的 Webhook Event ID。
event_typeTEXT否——付款服務供應商提供的 Webhook Event 類型。
user_idTEXT是——使用者 ID。
occurred_atINTEGER是——付款服務供應商記錄的 Event 發生時間，Unix 毫秒。
raw_bodyTEXT否——Webhook 原始請求本文，用於驗證簽章和重播。
statusTEXT否'processing'—目前狀態。
claim_tokenTEXT是——Webhook 處理租用機制使用的 Token。
last_errorTEXT是——最近一次處理失敗的錯誤訊息。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

payment_customers

儲存站內使用者與付款服務供應商 Customer 的對應關係。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
user_idTEXT否——使用者 ID。
providerTEXT否——Customer 所屬的付款服務供應商。
connection_idTEXT否——付款連線 ID，對應 config/payment.ts。
provider_customer_idTEXT否——付款服務供應商中的 Customer ID。
is_primaryINTEGER否0—是否為這位使用者在此付款連線下的主要 Customer，1 表示是。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

checkout_sessions

儲存站內 Checkout Session 及付款服務供應商傳回的狀態。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
providerTEXT否——Checkout 所屬的付款服務供應商。
connection_idTEXT否——付款連線 ID，對應 config/payment.ts。
provider_checkout_typeTEXT否——付款服務供應商中的 Checkout 類型。
provider_checkout_idTEXT是——付款服務供應商中的 Checkout ID。
customer_idTEXT否—FK → payment_customers.idpayment_customers 紀錄 ID。
modeTEXT否——Checkout 模式：一次性付款或訂閱。
statusTEXT否——目前狀態。
provider_statusTEXT是——付款服務供應商傳回的原始狀態。
payment_statusTEXT否'pending'—付款狀態。
provider_payment_statusTEXT是——付款服務供應商傳回的原始付款狀態。
has_invoice_creationINTEGER否0—是否要求付款服務供應商建立發票，1 表示是。
checkout_requestJSON是——建立 Checkout 時使用的請求快照。
contextJSON是——建立 Checkout 時儲存的業務執行脈絡。
metadataJSON是——業務中繼資料。
currencyTEXT是——幣別代碼。
amount_total_minorINTEGER是——Checkout 總金額，使用貨幣最小單位。
provider_dataJSON是——付款服務供應商傳回的原始資料。
last_errorTEXT是——最近一次處理失敗的錯誤訊息。
provider_updated_atINTEGER是——付款服務供應商中的最後更新時間，Unix 毫秒。
expires_atINTEGER是——到期時間，Unix 毫秒。
completed_atINTEGER是——完成時間，Unix 毫秒。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

purchase_items

儲存 Checkout Session 中的一次性購買項目。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
checkout_session_idTEXT否—FK → checkout_sessions.id（串聯刪除）checkout_sessions 紀錄 ID。
provider_line_item_idTEXT是——付款服務供應商中的明細 ID。
provider_product_idTEXT是——付款服務供應商中的 Product ID。
provider_price_idTEXT是——付款服務供應商中的 Price ID。
provider_variant_idTEXT是——付款服務供應商中的 Variant ID。
descriptionTEXT是——說明文字。
quantityINTEGER是——數量。
metadataJSON是——業務中繼資料。
provider_dataJSON是——付款服務供應商傳回的原始資料。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

subscriptions

儲存付款服務供應商的訂閱，以及計費週期、暫停、取消和金額資訊。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
customer_idTEXT否——payment_customers 紀錄 ID。
checkout_session_idTEXT是——checkout_sessions 紀錄 ID。
providerTEXT否——訂閱所屬的付款服務供應商。
connection_idTEXT否——付款連線 ID，對應 config/payment.ts。
provider_subscription_idTEXT否——付款服務供應商中的 Subscription ID。
statusTEXT否——目前狀態。
provider_statusTEXT是——付款服務供應商傳回的原始狀態。
collection_modeTEXT否'unknown'—訂閱收款方式。
collection_pausedINTEGER否0—訂閱是否暫停收款，1 表示暫停。
collection_pause_resumes_atINTEGER是——預定恢復收款的時間。
collection_pause_detailsJSON是——付款服務供應商傳回的暫停收款詳細資訊。
started_atINTEGER是——訂閱開始時間，Unix 毫秒。
trial_startINTEGER是——試用期開始時間，Unix 毫秒。
trial_endINTEGER是——試用期結束時間，Unix 毫秒。
current_period_startINTEGER是——目前計費週期的開始時間，Unix 毫秒。
current_period_endINTEGER是——目前計費週期的結束時間，Unix 毫秒。
cancel_at_period_endINTEGER否0—是否在目前計費週期結束時取消，1 表示是。
cancel_atINTEGER是——預定取消時間，Unix 毫秒。
canceled_atINTEGER是——取消時間，Unix 毫秒。
paused_atINTEGER是——暫停時間，Unix 毫秒。
ends_atINTEGER是——付款服務供應商提供的訂閱預計結束時間，Unix 毫秒。
ended_atINTEGER是——訂閱結束時間，Unix 毫秒。
scheduled_changeJSON是——付款服務供應商傳回的訂閱預定變更。
scheduled_change_atINTEGER是——預定變更的生效時間。
next_billed_atINTEGER是——下一次扣款時間，Unix 毫秒。
next_amount_minorINTEGER是——下一期應付金額，使用貨幣最小單位。
next_currencyTEXT是——下一期付款幣別。
metadataJSON是——業務中繼資料。
provider_dataJSON是——付款服務供應商傳回的原始資料。
provider_updated_atINTEGER是——付款服務供應商中的最後更新時間，Unix 毫秒。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

subscription_items

儲存訂閱中的產品、Price、數量和計費週期。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
subscription_idTEXT否—FK → subscriptions.id（串聯刪除）訂閱 ID。
provider_subscription_item_idTEXT是——付款服務供應商中的 Subscription Item ID。
provider_product_idTEXT是——付款服務供應商中的 Product ID。
provider_price_idTEXT是——付款服務供應商中的 Price ID。
descriptionTEXT是——說明文字。
quantityINTEGER是——數量。
unit_amount_minorINTEGER是——單價，使用貨幣最小單位。
currencyTEXT是——幣別代碼。
pricing_modelTEXT否'unknown'—計價模式。
billing_intervalTEXT是——計費週期單位。
billing_interval_countINTEGER是——一個計費週期包含的單位數量。
current_period_startINTEGER是——目前計費週期的開始時間，Unix 毫秒。
current_period_endINTEGER是——目前計費週期的結束時間，Unix 毫秒。
metadataJSON是——業務中繼資料。
provider_dataJSON是——付款服務供應商傳回的原始資料。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

transactions

儲存付款交易、帳單金額、付款人和發票資訊。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
public_reference_idTEXT否——可顯示給使用者的交易參考編號。
providerTEXT否——交易所屬的付款服務供應商。
connection_idTEXT否——付款連線 ID，對應 config/payment.ts。
source_typeTEXT否——付款服務供應商中的原始交易物件類型。
provider_source_idTEXT否——付款服務供應商中的原始交易物件 ID。
customer_idTEXT是——payment_customers 紀錄 ID。
checkout_session_idTEXT是——checkout_sessions 紀錄 ID。
provider_customer_idTEXT是——付款服務供應商中的 Customer ID。
provider_subscription_idTEXT是——付款服務供應商中的 Subscription ID。
kindTEXT否——交易類型，例如一次性付款、訂閱首次付款或訂閱續費。
statusTEXT否——目前狀態。
provider_statusTEXT是——付款服務供應商傳回的原始狀態。
collection_modeTEXT否'unknown'—訂閱收款方式。
subtotal_minorINTEGER是——折扣和稅費前的小計，使用貨幣最小單位。
discount_minorINTEGER是——折扣金額，使用貨幣最小單位。
tax_minorINTEGER是——稅額，使用貨幣最小單位。
total_minorINTEGER否——總金額，使用貨幣最小單位。
amount_due_minorINTEGER是——應付金額，使用貨幣最小單位。
amount_paid_minorINTEGER是——已付金額，使用貨幣最小單位。
amount_remaining_minorINTEGER是——未付金額，使用貨幣最小單位。
currencyTEXT否——幣別代碼。
billing_reasonTEXT是——產生本次交易的計費原因。
payer_emailTEXT是——付款人的電子郵件地址。
payer_nameTEXT是——付款人姓名。
billing_addressJSON是——帳單地址。
tax_identifiersJSON是——稅務識別碼陣列。
invoice_numberTEXT是——發票編號。
document_urlTEXT是——付款服務供應商提供的帳單文件網址。
document_pdf_urlTEXT是——付款服務供應商提供的 PDF 帳單網址。
failure_codeTEXT是——付款服務供應商傳回的失敗代碼。
failure_reasonTEXT是——處理失敗的原因。
metadataJSON是——業務中繼資料。
provider_dataJSON是——付款服務供應商傳回的原始資料。
provider_updated_atINTEGER是——付款服務供應商中的最後更新時間，Unix 毫秒。
issued_atINTEGER是——帳單或交易的開立時間，Unix 毫秒。
due_atINTEGER是——應付款時間，Unix 毫秒。
paid_atINTEGER是——交易完成付款的時間，Unix 毫秒。
occurred_atINTEGER否——交易實際發生時間，Unix 毫秒。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

transaction_items

儲存交易中的產品、Price、計費週期和金額明細。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
transaction_idTEXT否—FK → transactions.id（串聯刪除）交易 ID。
provider_line_item_idTEXT是——付款服務供應商中的明細 ID。
provider_product_idTEXT是——付款服務供應商中的 Product ID。
provider_price_idTEXT是——付款服務供應商中的 Price ID。
provider_variant_idTEXT是——付款服務供應商中的 Variant ID。
provider_subscription_item_idTEXT是——付款服務供應商中的 Subscription Item ID。
descriptionTEXT是——說明文字。
billing_typeTEXT否'unknown'—交易明細的計費類型。
is_prorationINTEGER否0—這筆明細是否為按比例補差額，1 表示是。
billing_intervalTEXT是——計費週期單位。
billing_interval_countINTEGER是——一個計費週期包含的單位數量。
period_startINTEGER是——這筆明細對應的計費週期開始時間，Unix 毫秒。
period_endINTEGER是——這筆明細對應的計費週期結束時間，Unix 毫秒。
quantityINTEGER是——數量。
unit_amount_minorINTEGER是——單價，使用貨幣最小單位。
unit_amount_decimalTEXT是——付款服務供應商傳回的高精度單價字串。
subtotal_minorINTEGER是——折扣和稅費前的小計，使用貨幣最小單位。
discount_minorINTEGER是——折扣金額，使用貨幣最小單位。
tax_minorINTEGER是——稅額，使用貨幣最小單位。
total_minorINTEGER否——總金額，使用貨幣最小單位。
currencyTEXT否——幣別代碼。
metadataJSON是——業務中繼資料。
provider_dataJSON是——付款服務供應商傳回的原始資料。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。

refunds

儲存交易退款及付款服務供應商傳回的退款狀態。

欄位型別可為空值預設值索引鍵含義
idTEXT否—PK紀錄主索引鍵。
transaction_idTEXT否—FK → transactions.id（禁止刪除仍有退款的交易）交易 ID。
providerTEXT否——退款所屬的付款服務供應商。
connection_idTEXT否——付款連線 ID，對應 config/payment.ts。
provider_refund_typeTEXT否——付款服務供應商中的退款類型。
provider_refund_idTEXT否——付款服務供應商中的退款 ID。
provider_parent_typeTEXT是——付款服務供應商中的退款父物件類型。
provider_parent_idTEXT是——付款服務供應商中的退款父物件 ID。
statusTEXT否——目前狀態。
provider_statusTEXT是——付款服務供應商傳回的原始狀態。
amount_minorINTEGER否——金額，使用貨幣最小單位。
tax_amount_minorINTEGER是——退款中的稅額，使用貨幣最小單位。
currencyTEXT否——幣別代碼。
reasonTEXT是——付款服務供應商提供的退款原因。
failure_reasonTEXT是——處理失敗的原因。
metadataJSON是——業務中繼資料。
provider_dataJSON是——付款服務供應商傳回的原始資料。
provider_updated_atINTEGER否——付款服務供應商中的最後更新時間，Unix 毫秒。
occurred_atINTEGER否——退款實際發生時間，Unix 毫秒。
created_atINTEGER否——建立時間，Unix 毫秒。
updated_atINTEGER否——最後更新時間，Unix 毫秒。