add tagging

src/Tag/TagRoutingService.php

@@ -0,0 +1,98 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tag;
+
+use Doctrine\DBAL\ArrayParameterType;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Component\Uid\Uuid;
+
+final class TagRoutingService
+{
+    private const DEFAULT_TOPK = 8;
+    private const MIN_BEST_SCORE = 0.10;
+    private const MAX_CANDIDATE_DOCS = 200;
+
+    public function __construct(
+        private readonly TagVectorSearchClient $tagSearch,
+        private readonly EntityManagerInterface $em,
+    ) {}
+
+    /**
+     * @return string[]|null
+     */
+    public function route(string $query): ?array
+    {
+        $query = trim($query);
+        if ($query === '') {
+            return null;
+        }
+
+        $hits = $this->tagSearch->search($query, self::DEFAULT_TOPK);
+        if (!is_array($hits) || $hits === []) {
+            return null;
+        }
+
+        $bestScore = (float)($hits[0]['score'] ?? 0.0);
+        if ($bestScore < self::MIN_BEST_SCORE) {
+            return null;
+        }
+
+        // Convert tag UUID strings to binary(16)
+        $tagBinaryIds = [];
+
+        foreach ($hits as $hit) {
+            $id = (string)($hit['tag_id'] ?? '');
+            if ($id === '') {
+                continue;
+            }
+
+            try {
+                $tagBinaryIds[] = Uuid::fromString($id)->toBinary();
+            } catch (\Throwable) {
+                continue;
+            }
+        }
+
+        if ($tagBinaryIds === []) {
+            return null;
+        }
+
+        // Direct DBAL query (binary-safe)
+        $conn = $this->em->getConnection();
+
+        $rows = $conn->executeQuery(
+            'SELECT document_id
+             FROM document_tag
+             WHERE tag_id IN (:tagIds)',
+            ['tagIds' => $tagBinaryIds],
+            ['tagIds' => ArrayParameterType::BINARY]
+        )->fetchAllAssociative();
+
+        if ($rows === []) {
+            return null;
+        }
+
+        $docIds = [];
+
+        foreach ($rows as $row) {
+            if (!isset($row['document_id'])) {
+                continue;
+            }
+
+            try {
+                $uuid = Uuid::fromBinary($row['document_id']);
+                $docIds[(string)$uuid] = true;
+            } catch (\Throwable) {
+                continue;
+            }
+
+            if (count($docIds) >= self::MAX_CANDIDATE_DOCS) {
+                break;
+            }
+        }
+
+        return array_keys($docIds);
+    }
+}