From 8495986dd392b5fa9fbf632b6504469f726cd983 Mon Sep 17 00:00:00 2001
From: Nick Zeng <Nick.Zeng@wpic.co>
Date: Thu, 11 Dec 2025 16:35:45 +0800
Subject: [PATCH] update entityUniqueIdentifierExtract return type

---
 backend/app/Entity/Parse/EntityParseInterface.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/backend/app/Entity/Parse/EntityParseInterface.php b/backend/app/Entity/Parse/EntityParseInterface.php
index 1f2452c..e905c9c 100644
--- a/backend/app/Entity/Parse/EntityParseInterface.php
+++ b/backend/app/Entity/Parse/EntityParseInterface.php
@@ -72,12 +72,13 @@ interface EntityParseInterface
     public function entityMap(array $rawData): LazyCollection;
 
     /**
-     * 提取实体唯一标识符
+     * 提取实体唯一标识符， 根据字段查找数据库中匹配的唯一实体
      *
      * @param array $metadata
-     * @return string|int
+     * @return array 提供给 Model::query()->where() 作为参数使用, 每个数组元素的键值分别作为字段名和值
+     * 如果需要多个字段来确认唯一性，则构造多个字段元素
      */
-    public function entityUniqueIdentifierExtract(array $metadata): string|int;
+    public function entityUniqueIdentifierExtract(array $metadata): array;
 
     /**
      * 获取消息数据