feat(contract): 支持月卡到期补差升级次卡条款

docs/membership-contract.md

@@ -18,16 +18,30 @@
 
 ## 合同条款要点
 
-条款由 `server/src/contract/contract-template.ts` 按卡种动态生成，模板版本 `2026-10-v1`。依据《消费者权益保护法实施条例》第 22 条及《最高人民法院关于审理预付式消费民事纠纷案件适用法律若干问题的解释》（2025-05-01 施行）：
+条款由 `server/src/contract/contract-template.ts` 按卡种动态生成，模板版本 `2026-10-v2`。依据《消费者权益保护法实施条例》第 22 条及《最高人民法院关于审理预付式消费民事纠纷案件适用法律若干问题的解释》（2025-05-01 施行）：
 
 - 付款 7 日内且未上课，全额退款（续费同样适用）。
 - 学员原因退费：实付 − 已用课时 × 单节标准课价，结果小于零按零，不收手续费；不限次卡按剩余天数比例退。
 - 场馆原因退费：按本卡实付单价折算已用课时，并依法计息。
 - 允许整体转让、免费延期 1 次（≤ 30 天）、伤病孕期可暂停；停业或迁址提前 30 日公告。
+- 月卡到期后可联系馆主补差升级同类课程多次卡：按本期月卡实付且未退还的金额抵扣，已用课时计入目标次卡已用课时，新有效期从补款及双方书面确认均完成之日起算；升级不影响依法退费的权利。
 - 删除了模板中「最终解释权归场馆」「到期不退任何费用」「转卡收 10%」等可能被认定无效的格式条款；与学员重大利害相关的条款加粗提示。
 
 单节标准课价在「合同签署设置」中配置，未配置时取在售单次卡价格。
 
+## 月卡到期补差升级（2026-10-29）
+
+- 第二条新增月卡专属条款，并在到期、合同终止条款中保留升级及依法结算的权利，不再使用「到期一律不退费」表述。
+- 目标为升级时在售的同类课程多次卡，以办理时公示售价计算差价，售价不低于可抵扣金额、总课时多于原月卡已用课时；不另收升级手续费，同一期月卡金额不得重复抵扣。
+- 示例：月卡实付 1,000 元、已用 3 节，升级售价 2,000 元的 10 次卡，补款 1,000 元，剩余 7 节。不是另赠一张完整的 10 次卡。
+- 办理前须书面确认原月卡/合同、目标次卡、抵扣与补款金额、已用及剩余课时、有效期起止；原月卡权益并入次卡，不重复使用。本次只更新合同文本，不新增自动补款、改卡或合同补充协议功能；馆主实际办理时应留存双方书面确认及收款凭证。
+
+### 仅更新本次条款的发布范围
+
+- 合同功能已上线时，只需构建并发布 server；无 shared 类型、接口、小程序界面及数据库变更，无需为本次条款重新发布小程序。首次上线合同功能仍需完成下方原有迁移和小程序发布步骤。
+- 购卡范本、新合同及已有待签合同再次加载时使用新版正文；若用户停留在旧正文，签署时的 SHA-256 校验会拒绝提交，需重新加载阅读后签署。
+- 签署时同步保存实际正文的模板版本，避免旧待签记录仍标记 v1、正文却为 v2。已签合同的正文、版本、摘要及 PDF 保持签署时快照，不自动追加条款；如需适用于已签合同，双方另行书面确认补充约定。
+
 ## 配置与发布
 
 1. 应用迁移 `20261028090000_membership_contracts`（仅新增表与 `orders.contract_accepted_at` 列），生成 Prisma Client，再发布 shared/server。
@@ -57,3 +71,9 @@
 - 服务端全量测试通过：38 个套件、605 项测试；新增合同模板、合同服务及预约拦截用例。
 - shared/server 构建、小程序类型检查与微信小程序生产构建通过；本地生成样例 PDF 并逐页检查排版。
 - 未在本地连接数据库做端到端验证（本地 `.env` 指向生产库），需在部署后按上述流程真机验收。
+
+## 条款更新验证（2026-10-29）
+
+- 服务端 38 个测试套件、610 项测试通过，服务端构建通过。
+- 覆盖有限次/不限次月卡升级条款、到期权利保留、旧待签合同签署时保存新版版本，以及已签旧版正文和 PDF 不受模板更新影响。
+- 本次未连接数据库或部署；发布后检查月卡合同预览与待签正文，已签合同应仍展示原文。