fix(电子签章): 双方骑缝章错开位置,不再叠在一起 #463

Merged
limeng merged 1 commits from fix/esign-across-page-seal into main 2026-10-22 20:54:03 +08:00
Collaborator

fix(电子签章): 双方骑缝章错开位置,不再叠在一起

问题

已签署协议 AGR-A1F55EB9D5FA7FB16D4A 每页右边缘的骑缝章看起来像"盖了两遍"。查 PDF 签名信息:

签署方 骑缝章纵向范围
常州电优闪供应链管理有限公司 Y 451.7 ~ 575.7
苏州全捷货运代理有限公司 Y 469.3 ~ 593.3

两家各盖了一枚骑缝章,只差约 6mm,重叠 85% 以上。

原因:发起签署时主文件签署区都是 freeMode(自由签),骑缝章由签署人在 E 签宝页面上自己加,E 签宝把各方骑缝章放在同一默认高度。

做了什么

只改 app/Services/Esign/EsignClient.php:

  1. uploadPdf() 上传时记录文件页数。
  2. createSignFlow() 组好签署方后,给主文件上的每个企业签署方各加一个固定骑缝签署区(signFieldStyle: 2,acrossPageMode: ALL),按企业签署方顺序取纵向位置:
    • 第 1 家(我方):positionY = 620(偏上)
    • 第 2 家(对方):positionY = 420(居中偏下)
    • 第 3 家:positionY = 220
    • 章大小 120,相邻间隔 200,不会重叠。
  3. 以下情况不加骑缝章,行为和原来一样:
    • 个人签署方
    • 主文件只有 1 页,或页数识别不出
  4. 原来的自由签单页签署区、证件页的固定签署区都不变。

快递协议(CourierAgreementSignatureService)和报价确认(CourierQuoteSignatureService)两处调用不用改。

上线前请在 E 签宝测试环境验证

本地没有 PHP 依赖环境,也连不上 E 签宝,这次只做了语法检查和组装逻辑的单测(页数识别、企业/个人区分、Y 坐标分配、1 页文件不加),没有真实调用 E 签宝。上线前请在沙箱发一份双方企业签署的多页协议,确认:

  • 创建流程接口不报错(同一签署方同时有自由签区和固定骑缝区,项目里证件页已经这样用过)
  • 签署页上骑缝章已预置在两个不同高度,签署人不需要再手动加
  • 签完后叠页,两枚骑缝章上下分开、各自完整
  • 1 页报价单发起正常,没有骑缝章

注意

  • 签署人仍是自由签模式,理论上还能在页面上手动再加一枚骑缝章。建议通知经办人:骑缝章系统已放好,只盖单页章即可。
  • 已签完的合同改不了,只对新发起的生效。

本次提交验证与发布决定

补丁原样应用,仅修改 app/Services/Esign/EsignClient.php,无迁移、无前端改动。php -l 和 diff 检查通过;实际 dompdf 三页 PDF 页数识别及 620/420/220 坐标、个人/单页/未知页数排除和原自由签区保留的组装检查通过。

未找到可用沙箱配置,未真实调用 E 签宝。负责人于 2026-10-22 明确同意本地测试通过后使用标准发布脚本直接上线,不使用 -AllowMigrations。签署页位置及最终成品签章仍待新发起签署实际确认。

相关测试:100 项,补齐本地构建文件后 97 项通过、3 项页面断言失败;3 项失败已用未修改的主线 EsignClient 逐项复现,均为 AgreementSigningPageTest 的模板/原文展示断言。EsignConfigurationTest、EsignRequestSignerTest、签署工作流和轮询测试通过。尚未合并或部署,等待负责人决定是否接受这三个主线已有失败。

# fix(电子签章): 双方骑缝章错开位置,不再叠在一起 ## 问题 已签署协议 AGR-A1F55EB9D5FA7FB16D4A 每页右边缘的骑缝章看起来像"盖了两遍"。查 PDF 签名信息: | 签署方 | 骑缝章纵向范围 | |---|---| | 常州电优闪供应链管理有限公司 | Y 451.7 ~ 575.7 | | 苏州全捷货运代理有限公司 | Y 469.3 ~ 593.3 | 两家各盖了一枚骑缝章,只差约 6mm,重叠 85% 以上。 原因:发起签署时主文件签署区都是 `freeMode`(自由签),骑缝章由签署人在 E 签宝页面上自己加,E 签宝把各方骑缝章放在同一默认高度。 ## 做了什么 只改 `app/Services/Esign/EsignClient.php`: 1. `uploadPdf()` 上传时记录文件页数。 2. `createSignFlow()` 组好签署方后,给主文件上的**每个企业签署方**各加一个固定骑缝签署区(`signFieldStyle: 2`,`acrossPageMode: ALL`),按企业签署方顺序取纵向位置: - 第 1 家(我方):`positionY = 620`(偏上) - 第 2 家(对方):`positionY = 420`(居中偏下) - 第 3 家:`positionY = 220` - 章大小 120,相邻间隔 200,不会重叠。 3. 以下情况不加骑缝章,行为和原来一样: - 个人签署方 - 主文件只有 1 页,或页数识别不出 4. 原来的自由签单页签署区、证件页的固定签署区都不变。 快递协议(`CourierAgreementSignatureService`)和报价确认(`CourierQuoteSignatureService`)两处调用不用改。 ## 上线前请在 E 签宝测试环境验证 本地没有 PHP 依赖环境,也连不上 E 签宝,这次只做了语法检查和组装逻辑的单测(页数识别、企业/个人区分、Y 坐标分配、1 页文件不加),**没有真实调用 E 签宝**。上线前请在沙箱发一份双方企业签署的多页协议,确认: - [ ] 创建流程接口不报错(同一签署方同时有自由签区和固定骑缝区,项目里证件页已经这样用过) - [ ] 签署页上骑缝章已预置在两个不同高度,签署人不需要再手动加 - [ ] 签完后叠页,两枚骑缝章上下分开、各自完整 - [ ] 1 页报价单发起正常,没有骑缝章 ## 注意 - 签署人仍是自由签模式,理论上还能在页面上手动再加一枚骑缝章。建议通知经办人:骑缝章系统已放好,只盖单页章即可。 - 已签完的合同改不了,只对新发起的生效。 ## 本次提交验证与发布决定 补丁原样应用,仅修改 app/Services/Esign/EsignClient.php,无迁移、无前端改动。php -l 和 diff 检查通过;实际 dompdf 三页 PDF 页数识别及 620/420/220 坐标、个人/单页/未知页数排除和原自由签区保留的组装检查通过。 未找到可用沙箱配置,未真实调用 E 签宝。负责人于 2026-10-22 明确同意本地测试通过后使用标准发布脚本直接上线,不使用 -AllowMigrations。签署页位置及最终成品签章仍待新发起签署实际确认。 相关测试:100 项,补齐本地构建文件后 97 项通过、3 项页面断言失败;3 项失败已用未修改的主线 EsignClient 逐项复现,均为 AgreementSigningPageTest 的模板/原文展示断言。EsignConfigurationTest、EsignRequestSignerTest、签署工作流和轮询测试通过。尚未合并或部署,等待负责人决定是否接受这三个主线已有失败。
limeng added 1 commit 2026-10-22 20:35:39 +08:00
limeng merged commit 9711ec4f57 into main 2026-10-22 20:54:03 +08:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WuYongJie/CaiWuXiTong#463
No description provided.