diff --git a/docs/justsolutionsWebV2/plan-plus-api分析.html b/docs/justsolutionsWebV2/plan-plus-api分析.html index 0334689..07ca7aa 100644 --- a/docs/justsolutionsWebV2/plan-plus-api分析.html +++ b/docs/justsolutionsWebV2/plan-plus-api分析.html @@ -384,7 +384,7 @@ POST /payments/create body = { orderId, amount, currency:'HKD', company, email } TenantAdminEmailemail必填;後端再校驗未註冊 Jurisdictionjurisdiction必填 OrganizationReferenceedition(Guid)必填;校驗 edition 存在 - OrganizationBR / OrganizationCIbr / —BR 或 CI 至少一個(OrderService.cs:154);plans-plus 僅收 BR 且標可選 ⇒ 缺口 + OrganizationBR / OrganizationCIbr / —已改 後端已去除「BR 或 CI 至少一個」必填校驗(OrderService.cs:154,190 注釋),可不填;唯一性校驗保留,僅在實際填寫時生效 EffectiveStartTimestartDate ContactPersoncontact CompanyAddressaddress可選 @@ -394,6 +394,10 @@ POST /payments/create body = { orderId, amount, currency:'HKD', company, email } IsOfflinePayment/IsAgentBehalf—固定 false +
+

BR/CI 已放開(2026-06):後端 CreateOrder 原有兩處「BR 或 CI 至少一個」必填校驗(OrderService.cs:154:190)已注釋去除,plans-plus 可不填 BR/CI 直接下單。保留緊隨其後的唯一性校驗 ExistsByOrganizationBRCIOrderService.cs:191)——兩者皆空時返回 false 放行,填寫時仍攔重複。DB 列可空(nvarchar(max)),無需遷移。

+

影響:① 改動為全局,旧站共用 CreateOrder 同樣放開(旧站前端仍自填 BR,行為不變);② 空 BR 不再參與去重,原「同公司只能註冊一次」對空 BR 失效;③ 下游 TenantInfoOrderService.cs:791)、偵測報告(ReportService.cs:276)僅透傳展示、可容忍空值,但合規/STR 報告該欄會留白,需業務確認可接受。續費/加購走 TenantRenewal,BR 繼承自上期訂單,不受影響。

+

② type='renew' → TenantRenewal

@@ -478,7 +482,7 @@ if (addons.jquotaPackageId) - +
6去掉管理員密碼步驟後端已忽略 AdminPassword,發重置郵件無影響
7bestValue / 賣點 note(方案卡片標記與文案)後端 Plan 無此字段,BFF 配置或後端補BFF/後端
8edition 多語言名稱(中/日)後端只有 displayName,BFF 補映射BFF
9BR 標為可選(UI)後端要求 BR 或 CI 至少一個;需 UI 補 CI 或設必填需對齊
9BR 標為可選(UI)後端已去除 BR/CI 必填校驗(OrderService.cs:154,190),可不填即下單;唯一性校驗保留、僅在填寫時生效已改
10支付 create 端點化(前端拿 redirectUrl)QFPay 簽名邏輯移到 BFF 服務端BFF
@@ -528,7 +532,7 @@ if (addons.jquotaPackageId)
  1. 租戶查詢:後端能否新增「按管理員郵箱查可續費租戶」?返回是否能直接帶 currentSubscription(planId / 上期價 / 已購加值項)?
  2. topup:純加購走 TenantRenewal(PlanList 僅加值項)後端是否接受、語義是否「只疊配額不延期」?還是需新端點?
  3. -
  4. BR/CI:plans-plus 把 BR 標為可選,但後端要求 BR 或 CI 至少一個——UI 是否補 CI 字段,或把 BR 設為必填?
  5. +
  6. BR/CI:已解決 後端已去除「BR 或 CI 至少一個」必填校驗(OrderService.cs:154,190 注釋,2026-06),plans-plus 可不填 BR/CI 直接下單;唯一性(去重)校驗保留,僅在填寫時生效。待業務確認:① 改動為全局,旧站共用 CreateOrder 是否接受同樣放開;② 空 BR 不再去重、合規/STR 報告該欄留白是否可接受。
  7. bestValue / note / edition 多語言:由 BFF 配置維護,還是後端在數據上補字段?
  8. QFPay:V2 是否沿用旧站同一 appcode/api_key/收銀台域名?簽名算法是否一致(sha256 排序串 + key)?
  9. 0 元 / P2G:免支付分支的判定(paymentStatus===200txamt===0)是否照搬?