From 77a30169a56a23cf4c42f5caae0b8660e3b89394 Mon Sep 17 00:00:00 2001
From: fengruixiang <474182370@qq.com>
Date: Wed, 24 Jun 2026 23:32:08 +0800
Subject: [PATCH] docs(justsolutions): update plans-plus API documentation to
 reflect changes in BR/CI validation requirements

---
 docs/justsolutionsWebV2/plan-plus-api分析.html | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

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 }
       <tr><td><code>TenantAdminEmail</code></td><td><code>email</code></td><td>必填；後端再校驗未註冊</td></tr>
       <tr><td><code>Jurisdiction</code></td><td><code>jurisdiction</code></td><td>必填</td></tr>
       <tr><td><code>OrganizationReference</code></td><td><code>edition</code>（Guid）</td><td>必填；校驗 edition 存在</td></tr>
-      <tr><td><code>OrganizationBR</code> / <code>OrganizationCI</code></td><td><code>br</code> / —</td><td><b>BR 或 CI 至少一個</b>（OrderService.cs:154）；plans-plus 僅收 BR 且標可選 ⇒ 缺口</td></tr>
+      <tr><td><code>OrganizationBR</code> / <code>OrganizationCI</code></td><td><code>br</code> / —</td><td><span class="pill done">已改</span> 後端已去除「BR 或 CI 至少一個」必填校驗（<code>OrderService.cs:154,190</code> 注釋），可不填；唯一性校驗保留，僅在實際填寫時生效</td></tr>
       <tr><td><code>EffectiveStartTime</code></td><td><code>startDate</code></td><td></td></tr>
       <tr><td><code>ContactPerson</code></td><td><code>contact</code></td><td></td></tr>
       <tr><td><code>CompanyAddress</code></td><td><code>address</code></td><td>可選</td></tr>
@@ -394,6 +394,10 @@ POST /payments/create body = { orderId, amount, currency:'HKD', company, email }
       <tr><td><code>IsOfflinePayment</code>/<code>IsAgentBehalf</code></td><td>—</td><td>固定 <code>false</code></td></tr>
     </tbody>
   </table>
+  <div class="callout ok">
+    <p><span class="lbl">BR/CI 已放開（2026-06）：</span>後端 <code>CreateOrder</code> 原有兩處「BR 或 CI 至少一個」必填校驗（<code>OrderService.cs:154</code> 與 <code>:190</code>）已注釋去除，plans-plus 可不填 BR/CI 直接下單。<b>保留</b>緊隨其後的唯一性校驗 <code>ExistsByOrganizationBRCI</code>（<code>OrderService.cs:191</code>）——兩者皆空時返回 <code>false</code> 放行，填寫時仍攔重複。DB 列可空（<code>nvarchar(max)</code>），無需遷移。</p>
+    <p><span class="lbl">影響：</span>① 改動為<b>全局</b>，旧站共用 <code>CreateOrder</code> 同樣放開（旧站前端仍自填 BR，行為不變）；② 空 BR 不再參與去重，原「同公司只能註冊一次」對空 BR 失效；③ 下游 <code>TenantInfo</code>（<code>OrderService.cs:791</code>）、偵測報告（<code>ReportService.cs:276</code>）僅透傳展示、可容忍空值，但合規/STR 報告該欄會留白，需業務確認可接受。<b>續費/加購走 <code>TenantRenewal</code>，BR 繼承自上期訂單，不受影響。</b></p>
+  </div>
 
   <h4>② type='renew' → TenantRenewal</h4>
   <table>
@@ -478,7 +482,7 @@ if (addons.jquotaPackageId)
       <tr><td>6</td><td><b>去掉管理員密碼步驟</b></td><td>後端已忽略 AdminPassword，發重置郵件</td><td><span class="pill done">無影響</span></td></tr>
       <tr><td>7</td><td><b>bestValue / 賣點 note</b>（方案卡片標記與文案）</td><td>後端 Plan 無此字段，BFF 配置或後端補</td><td><span class="pill partial">BFF/後端</span></td></tr>
       <tr><td>8</td><td><b>edition 多語言名稱</b>（中/日）</td><td>後端只有 displayName，BFF 補映射</td><td><span class="pill partial">BFF</span></td></tr>
-      <tr><td>9</td><td><b>BR 標為可選</b>（UI）</td><td>後端要求 BR 或 CI 至少一個；需 UI 補 CI 或設必填</td><td><span class="pill todo">需對齊</span></td></tr>
+      <tr><td>9</td><td><b>BR 標為可選</b>（UI）</td><td>後端已去除 BR/CI 必填校驗（<code>OrderService.cs:154,190</code>），可不填即下單；唯一性校驗保留、僅在填寫時生效</td><td><span class="pill done">已改</span></td></tr>
       <tr><td>10</td><td><b>支付 create 端點化</b>（前端拿 redirectUrl）</td><td>QFPay 簽名邏輯移到 BFF 服務端</td><td><span class="pill todo">BFF</span></td></tr>
     </tbody>
   </table>
@@ -528,7 +532,7 @@ if (addons.jquotaPackageId)
   <ol class="tight" style="padding-left:20px">
     <li><b>租戶查詢：</b>後端能否新增「按管理員郵箱查可續費租戶」？返回是否能直接帶 currentSubscription（planId / 上期價 / 已購加值項）？</li>
     <li><b>topup：</b>純加購走 TenantRenewal（PlanList 僅加值項）後端是否接受、語義是否「只疊配額不延期」？還是需新端點？</li>
-    <li><b>BR/CI：</b>plans-plus 把 BR 標為可選，但後端要求 BR 或 CI 至少一個——UI 是否補 CI 字段，或把 BR 設為必填？</li>
+    <li><b>BR/CI：</b><span class="pill done">已解決</span> 後端已去除「BR 或 CI 至少一個」必填校驗（<code>OrderService.cs:154,190</code> 注釋，2026-06），plans-plus 可不填 BR/CI 直接下單；唯一性（去重）校驗保留，僅在填寫時生效。<b>待業務確認</b>：① 改動為全局，旧站共用 <code>CreateOrder</code> 是否接受同樣放開；② 空 BR 不再去重、合規/STR 報告該欄留白是否可接受。</li>
     <li><b>bestValue / note / edition 多語言：</b>由 BFF 配置維護，還是後端在數據上補字段？</li>
     <li><b>QFPay：</b>V2 是否沿用旧站同一 <code>appcode</code>/<code>api_key</code>/收銀台域名？簽名算法是否一致（sha256 排序串 + key）？</li>
     <li><b>0 元 / P2G：</b>免支付分支的判定（<code>paymentStatus===200</code> 或 <code>txamt===0</code>）是否照搬？</li>