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

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

View File

@ -12,6 +12,18 @@ final class EsignClient
private readonly EsignRequestSigner $signer;
/**
* 骑缝章中心的纵向坐标(PDF 坐标,原点在左下角,A4 高 841.89)。
* 按企业签署方顺序依次取用:第一家偏上、第二家居中偏下、第三家靠下。
* 相邻两枚间隔 200,大于骑缝章高度 120,叠页后各自完整、互不重叠。
*/
private const ACROSS_PAGE_SEAL_Y = [620.0, 420.0, 220.0];
private const ACROSS_PAGE_SEAL_SIZE = '120';
/** @var array<string, int> 本实例上传过的文件 ID => 页数(0 表示未能识别)。 */
private array $pageCounts = [];
public function __construct(?EsignConfiguration $configuration = null)
{
$configuration ??= EsignConfiguration::fromConfig();
@ -77,6 +89,7 @@ final class EsignClient
}
$this->waitUntilFileReady($fileId);
$this->pageCounts[$fileId] = self::pdfPageCount($bytes);
return $fileId;
}
@ -119,6 +132,7 @@ final class EsignClient
],
]],
]];
$signerPayload = $this->withAcrossPageSeals($fileId, $signerPayload);
$docs = [[
'fileId' => $fileId,
@ -160,6 +174,49 @@ final class EsignClient
return $signFlowId;
}
/**
* 给主文件上的每个企业签署方各加一个固定位置的骑缝签署区,并按顺序错开纵向位置。
*
* 原来骑缝章由签署人在自由签模式下自己添加,E 签宝把各方的骑缝章放在同一默认高度,
* 双方的章会叠在一起,看起来像盖了两遍。现在由系统预先放好,每方一个高度。
* 个人签署方不加骑缝;主文件少于 2 页或页数识别不出时也不加。
*/
private function withAcrossPageSeals(string $fileId, array $signerPayload): array
{
if (($this->pageCounts[$fileId] ?? 0) < 2) {
return $signerPayload;
}
$orgOrder = 0;
foreach ($signerPayload as $index => $payload) {
if (($payload['signerType'] ?? null) !== 1) {
continue;
}
$positionY = self::ACROSS_PAGE_SEAL_Y[$orgOrder++] ?? null;
if ($positionY === null) {
break;
}
$signerPayload[$index]['signFields'][] = [
'fileId' => $fileId,
'normalSignFieldConfig' => [
'freeMode' => false,
'movableSignField' => false,
'signFieldStyle' => 2,
'signFieldSize' => self::ACROSS_PAGE_SEAL_SIZE,
'signFieldPosition' => ['acrossPageMode' => 'ALL', 'positionY' => $positionY],
],
];
}
return $signerPayload;
}
/** 统计 PDF 页数:数 /Type /Page 对象(不含 /Pages)。系统生成的 dompdf 文件可直接识别;识别不出返回 0。 */
private static function pdfPageCount(string $bytes): int
{
return (int) preg_match_all('#/Type\s*/Page(?![a-zA-Z])#', $bytes);
}
private function signerPayload(string $fileId, array $signer, int $index): array
{
$type = (int) ($signer['signer_type'] ?? 1);