From a9f00597430ef44be59e388575afd9e65c96f083 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Julien=20Fastr=C3=A9?= <julien.fastre@champs-libres.coop>
Date: Wed, 19 Jun 2024 12:17:25 +0200
Subject: [PATCH] Add PDF signature zone parsing functionality

This update introduces new services into the ChillDocStoreBundle for signature zone parsing within PDFs. The PDFSignatureZoneParser service identifies signature zones within PDF content while the additional classes, PDFPage and PDFSignatureZone, help define these zones and pages. Corresponding tests have also been
---
 .../Service/Signature/PDFPage.php             |  28 +++++++
 .../Service/Signature/PDFSignatureZone.php    |  33 ++++++++
 .../Signature/PDFSignatureZoneParser.php      |  57 +++++++++++++
 .../Signature/PDFSignatureZoneParserTest.php  |  77 ++++++++++++++++++
 .../data/signature_2_signature_page_1.pdf     | Bin 0 -> 16589 bytes
 5 files changed, 195 insertions(+)
 create mode 100644 src/Bundle/ChillDocStoreBundle/Service/Signature/PDFPage.php
 create mode 100644 src/Bundle/ChillDocStoreBundle/Service/Signature/PDFSignatureZone.php
 create mode 100644 src/Bundle/ChillDocStoreBundle/Service/Signature/PDFSignatureZoneParser.php
 create mode 100644 src/Bundle/ChillDocStoreBundle/Tests/Service/Signature/PDFSignatureZoneParserTest.php
 create mode 100644 src/Bundle/ChillDocStoreBundle/Tests/Service/Signature/data/signature_2_signature_page_1.pdf

diff --git a/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFPage.php b/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFPage.php
new file mode 100644
index 000000000..138c4e1c8
--- /dev/null
+++ b/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFPage.php
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Chill\DocStoreBundle\Service\Signature;
+
+final readonly class PDFPage
+{
+    public function __construct(
+        public int $index,
+        public float $width,
+        public float $height,
+    ) {}
+
+    public function equals(self $page): bool
+    {
+        return $page->index === $this->index
+            && round($page->width, 2) === round($this->width, 2)
+            && round($page->height, 2) === round($this->height, 2);
+    }
+}
diff --git a/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFSignatureZone.php b/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFSignatureZone.php
new file mode 100644
index 000000000..515356e52
--- /dev/null
+++ b/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFSignatureZone.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Chill\DocStoreBundle\Service\Signature;
+
+final readonly class PDFSignatureZone
+{
+    public function __construct(
+        public float $x,
+        public float $y,
+        public float $height,
+        public float $width,
+        public PDFPage $PDFPage,
+    ) {}
+
+    public function equals(self $other): bool
+    {
+        return
+            $this->x == $other->x
+            && $this->y == $other->y
+            && $this->height == $other->height
+            && $this->width == $other->width
+            && $this->PDFPage->equals($other->PDFPage);
+    }
+}
diff --git a/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFSignatureZoneParser.php b/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFSignatureZoneParser.php
new file mode 100644
index 000000000..3aade2fcc
--- /dev/null
+++ b/src/Bundle/ChillDocStoreBundle/Service/Signature/PDFSignatureZoneParser.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Chill\DocStoreBundle\Service\Signature;
+
+use Smalot\PdfParser\Parser;
+
+class PDFSignatureZoneParser
+{
+    public const ZONE_SIGNATURE_START = 'signature_zone';
+
+    private Parser $parser;
+
+    public function __construct(
+        public float $defaultHeight = 180.0,
+        public float $defaultWidth = 180.0,
+    ) {
+        $this->parser = new Parser();
+    }
+
+    /**
+     * @return list<PDFSignatureZone>
+     */
+    public function findSignatureZones(string $fileContent): array
+    {
+        $pdf = $this->parser->parseContent($fileContent);
+        $zones = [];
+
+        $defaults = $pdf->getObjectsByType('Pages');
+        $defaultPage = reset($defaults);
+        $defaultPageDetails = $defaultPage->getDetails();
+
+        foreach ($pdf->getPages() as $index => $page) {
+            $pdfPage = new PDFPage(
+                $index,
+                $page['MediaBox'][2] ?? $defaultPageDetails['MediaBox'][2],
+                $page['MediaBox'][3] ?? $defaultPageDetails['MediaBox'][3],
+            );
+
+            foreach ($page->getDataTm() as $dataTm) {
+                if (str_starts_with($dataTm[1], self::ZONE_SIGNATURE_START)) {
+                    $zones[] = new PDFSignatureZone($dataTm[0][4], $dataTm[0][5], $this->defaultHeight, $this->defaultWidth, $pdfPage);
+                }
+            }
+        }
+
+        return $zones;
+    }
+}
diff --git a/src/Bundle/ChillDocStoreBundle/Tests/Service/Signature/PDFSignatureZoneParserTest.php b/src/Bundle/ChillDocStoreBundle/Tests/Service/Signature/PDFSignatureZoneParserTest.php
new file mode 100644
index 000000000..5a78c8bbf
--- /dev/null
+++ b/src/Bundle/ChillDocStoreBundle/Tests/Service/Signature/PDFSignatureZoneParserTest.php
@@ -0,0 +1,77 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Tests\Service\Signature;
+
+use Chill\DocStoreBundle\Service\Signature\PDFPage;
+use PHPUnit\Framework\TestCase;
+use Chill\DocStoreBundle\Service\Signature\PDFSignatureZone;
+use Chill\DocStoreBundle\Service\Signature\PDFSignatureZoneParser;
+
+/**
+ * @internal
+ *
+ * @coversNothing
+ */
+class PDFSignatureZoneParserTest extends TestCase
+{
+    private static PDFSignatureZoneParser $parser;
+
+    public static function setUpBeforeClass(): void
+    {
+        self::$parser = new PDFSignatureZoneParser();
+    }
+
+    /**
+     * @dataProvider provideFiles
+     *
+     * @param list<PDFSignatureZone> $expected
+     */
+    public function testFindSignatureZones(string $filePath, array $expected): void
+    {
+        $content = file_get_contents($filePath);
+
+        if (false === $content) {
+            throw new \LogicException("Unable to read file {$filePath}");
+        }
+
+        $actual = self::$parser->findSignatureZones($content);
+
+        self::assertEquals(count($expected), count($actual));
+
+        foreach ($actual as $index => $signatureZone) {
+            self::assertObjectEquals($expected[$index], $signatureZone);
+        }
+    }
+
+    public static function provideFiles(): iterable
+    {
+        yield [
+            __DIR__.'/data/signature_2_signature_page_1.pdf',
+            [
+                new PDFSignatureZone(
+                    127.7,
+                    95.289,
+                    180.0,
+                    180.0,
+                    $page = new PDFPage(0, 595.30393, 841.8897)
+                ),
+                new PDFSignatureZone(
+                    269.5,
+                    95.289,
+                    180.0,
+                    180.0,
+                    $page,
+                ),
+            ],
+        ];
+    }
+}
diff --git a/src/Bundle/ChillDocStoreBundle/Tests/Service/Signature/data/signature_2_signature_page_1.pdf b/src/Bundle/ChillDocStoreBundle/Tests/Service/Signature/data/signature_2_signature_page_1.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..89d91e67cffe721456aa7c0c870a49e7c3b4b278
GIT binary patch
literal 16589
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
PWMM@lCl`?wMg0E&^Ql1<

literal 0
HcmV?d00001