docs(justsolutions): update plans-plus API documentation to reflect changes in BR/CI validation requirements

main
fengruixiang 2026-06-24 23:32:08 +08:00
parent 4519399cb7
commit 77a30169a5
1 changed files with 7 additions and 3 deletions

View File

@ -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:154plans-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>後端只有 displayNameBFF 補映射</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>後端能否新增「按管理員郵箱查可續費租戶」?返回是否能直接帶 currentSubscriptionplanId / 上期價 / 已購加值項)?</li>
<li><b>topup</b>純加購走 TenantRenewalPlanList 僅加值項)後端是否接受、語義是否「只疊配額不延期」?還是需新端點?</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-06plans-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>