咨询宝 2026-08-18 部署说明（发给龚震）

当天总结：每日对齐-2026-08-18

未上线接口总表：待服务端的工作清单

小程序今晚改动已提交 GitHub main，体验版需重新上传。知情同意仍会挡住未绑定预约，请先改接口。默认签署策略和年费判断服务端已提交，部署正式环境后才能用。

1. 请先改：知情同意（挡住主流程）

接口：GET /c/informed-consent、POST /c/informed-consent

现状：查找 / 转发主页未绑定来访勾选确认后，正式环境返回 relationId must be a uuid。

期望：

• 签署记录按「来访 ID × 咨询师 ID」唯一。
• relationId 选填。缺失、null、空字符串都视为未传，不要按 UUID 校验失败。
• 查找 / 转发主页尚未绑定时，只凭 counselorId 能签。
• 已有关系时可以带合法 UUID，但不能要求必须先有关系。
• 响应带上 counselorId，已签时带 signedAt。

规则：docs/product-rules/booking-and-consent.md。

怎么验：

1. 尚未绑定的来访，从查找或转发主页进入预约 → 签知情同意 → 能进入下一步，不要报 UUID。
2. 同一来访再约同一咨询师，不再出同意书。
3. 同一来访约另一位咨询师，要重签。
4. 后台邀请：先签这位咨询师，再确认绑定。

2. 请部署：咨询师默认签署策略（今晚新项）

小程序已接。服务端代码和 SQL 在服务端仓库 main。

• 接口：GET /b/profile、PATCH /b/profile
• 字段：defaultAgreementPolicy = deferred | immediate | waived_offline，缺省 deferred（默认延迟）
• SQL：docs/sql/20260818_default_agreement_policy.sql
• 只出现在咨询师自己的资料，不要进公开主页。

行为：

• 搜索、转发主页自动建档：写入当时的全局默认。
• 邀请建档未单独选时：线下 / 已有次数仍建议立即签署，否则用全局默认。
• 改全局默认不影响已经建好的档案。
• 每个来访档案仍可单独改。

怎么验：

1. 新咨询师 GET /b/profile 为 deferred。
2. PATCH { "defaultAgreementPolicy": "immediate" } 后再 GET 为 immediate；公开主页响应没有该字段。
3. 账户页「搜索来访的默认策略」能改并保存。
4. 默认延迟时，搜索来的新来访第一次单次不自动出合同；改成立即签署后，新的搜索来访会自动发起。

3. 请部署：年费有效期内不要再报未开通

服务端代码今晚一并提交。预约、排期不要再被「需要有效的平台年付订阅」挡住。

• 接口：GET /b/subscription、GET /b/workbench、预约/排期门控 assertActiveSubscription
• 投影在有效期内，或已有履约成功的年费订单覆盖当前时间 → 视为已开通。
• 投影核对中只阻止续费和加购 E 签，不挡预约、排期。
• 巡检：有年费记录但没有订单、或起止时间差 2 秒内，不要打成不一致。

怎么验：乘龙后台已开通年费的咨询师，小程序显示已开通，来访能预约。

4. 请确认：来访资料（8-17 已提）

接口：PUT /c/profile、GET /c/profile 的 initialized

• 必填只有真实姓名、手机号。不填头像也能保存并标为已完善。
• 请求可以不带性别、出生日期。
• initialized 在真名 + 手机号齐全后为 true。

验：新来访只填真名 + 11 位手机号 → 能保存并回到预约。

5. 代码已改、待部署正式环境（老项）

1. 收费方案修订 + displayScopes（需 SQL docs/sql/20260816_plan_display_scopes.sql）
2. 咨询师手动排期允许排在可约时段外
3. 保存长程节奏时同步下场预约

小程序已接、正式路径待确认：

• 结束咨询关系：POST /b/relations/:relationId/end
• 来访档案次数校正：POST /b/visitor-profiles/:profileId/session-adjustments

6. 合同签署报「电子签渠道暂时不可用」

这不是小程序文案。咨询师点「发起签署」时，ESIGN_MODE=live 调 E 签宝失败，被收成 503 ESIGN_PROVIDER_UNAVAILABLE。渠道原文目前没打进日志。

请对照 E 签宝开放平台同一时间的上传 / 转 PDF / 建流程 / 拉签署链调用记录。并在服务端 callProvider 把原始错误打进日志。

小程序今晚提交了什么（不用改接口形状，但 1、2 要先部署）

• 知情同意按咨询师隔离请求和本地缓存（对应第 1 节）
• 账户页可设搜索来访默认签署策略（对应第 2 节）
• 来访档案「添加专属方案」键盘不再挡住按钮

昨晚已在 main：来访资料只填真名手机号；工作台可转发身份选择页。

建议顺序

1. 改知情同意（挡住未绑定预约）。
2. 跑 docs/sql/20260818_default_agreement_policy.sql，部署默认签署策略。
3. 部署年费有效期判断。
4. 核对来访资料 initialized。
5. 体验版对完：未绑定预约能签同意书、账户页能改默认策略、已开通年费能约，再提审正式版。

每日对齐 2026-08-18

发给龚震用这一份：部署-2026-08-18。

今天做成了什么

小程序（已提交 main，体验版需重新上传）：

• 知情同意规则拍板：按「来访 × 咨询师」签一次；换咨询师要重签。查找、转发主页、后台邀请都可以进预约或绑定。没有合法关系 ID 时不再传空的 relationId。
• 咨询师默认签署策略：账户页可设搜索来访的默认策略，未设为默认延迟。邀请建档仍可按人改。
• 档案添加专属方案：键盘不再挡住「添加方案」。
• 开发用卡片版主页预览（不接正式接口，可忽略）。

昨晚已在 main、体验版也需重新上传：

• 来访资料只填真名 + 手机号
• 工作台转发身份选择页给同行开通

服务端（已提交 main，待部署正式环境）：

• 咨询师 defaultAgreementPolicy + SQL
• 年费有效期内按已开通，投影核对中不挡预约

卡住什么

1. 未绑定来访签知情同意，正式环境仍返回 relationId must be a uuid。小程序已不再传空字段。
2. 点合同「发起签署」报 「电子签渠道暂时不可用」：正式环境 ESIGN_MODE=live 调 E 签宝失败后被统一翻成这句，渠道原文没打进日志。

请龚震先做

1. 知情同意：relationId 选填，按来访 × 咨询师记录。
2. 部署默认签署策略 SQL + 代码。
3. 部署年费有效期判断。
4. 核对来访资料 initialized。
5. 签署失败时把 E 签宝原文打进 503 日志，对照开放平台调用记录。