plans-plus · KYC 訂閱欄位與租用邏輯分析

一、結論速覽

二、欄位資料鏈路（前端 → 後端）

plans-plus 續費頁「上次訂閱資訊」卡片的「已購增值 / Add-ons」列，經由這條鏈路取得 KYC 標記：

三、EnableKYC 何時被賦值為 true

EnableKYC 全庫僅有 3 種寫入來源（其餘皆為 EF 遷移快照），沒有任何「按功能開關」的入口：

判定函式只看方案的 Tag1：

// OrderService.cs:2694-2697
private bool checkHasEnableKYCInPlan(List<PlanDetail> purchasePlanDetailList)
{
    return purchasePlanDetailList
        .Where(a => a.Plan.Tag1Code == PlanTag1Enums.KYC.ToString()).Any();
}

四、租設備是否影響「使用 KYC 功能」

4.1 前端：只擋「機器掃描」按鈕

AML_Frontend 的 KYC section 讀取當前租戶的 enableKYC：

// kyc-section.component.ts:147-148
this.amlTenant.getCurrentTenantProperty$().subscribe(res => {
  this.enableKYC = res?.enableKYC ?? false
})

而它只作用在「ID Scan（機器讀卡掃描）」這一個按鈕上（switchType === 1）：

4.2 後端：無任何門檻

後端 KYCService / KYCController 從不讀取 EnableKYC。全庫對該欄位的非遷移讀取僅有兩處：續費沿用（OrderService.cs:872）與續費查詢上報（OrderService.cs:2460）。因此它純粹是前端那顆掃描按鈕的顯隱旗標，不構成服務端鑑權。

五、是否每個租戶預設開啟

• 一般業務租戶：EnableKYC 預設 false，僅當下單方案含 KYC 設備加購才為 true；續費時沿用上一份的值（OrderService.cs:872）。
• Host 宿主租戶：是唯一被 seeder 預設 true 的（TenantPropertyDataSeeder.cs:63-79，currentTenant.Id == null），並非每個業務租戶。
• 但「使用 KYC 功能」廣義上仍預設可用：因前端只擋掃描按鈕，所有租戶預設可走「上傳 / 錄入」完成 KYC。

六、本次文案修正

原本 plans-plus「上次訂閱資訊」把 KYC 加購項顯示為含糊的「KYC/KYB」（易被誤解成一種核查功能）。已改為與加購項一致的「KYC 設備租用」表述，以準確反映「是否租用 KYC 設備」。後端無改動。

改用的 i18n 鍵 ppx_addon_kyc_label 三語皆已是租用表述：繁中「KYC 身份讀取設備租用」／ EN「KYC ID Reader Rental」／ 日「KYC IDリーダー機器レンタル」，故翻譯本體無需改動。訂單摘要 ppx_sum_kyc 的翻譯值原本就已是租用表述，本次僅同步修正其過期的 HTML 靜態回退文字。

七、關鍵代碼位置索引