补全job文件

application/common/TurnitinService.php

@@ -488,7 +488,7 @@ class TurnitinService
      * Crossref 通道常用 ADMINISTRATOR/USER，非 INSTRUCTOR。可在 .env 配置：
      *   turnitin.viewer_permission_set=ADMINISTRATOR
      *
-     * @param array $viewer 可选，覆盖默认 viewer 请求体字段
+     * @param array $viewer 可选：viewer_user_id、triggered_by（映射为 editor_{id}）、或完整请求体覆盖
      */
     public function getViewerUrl($submissionId, $viewer = [])
     {
@@ -497,6 +497,12 @@ class TurnitinService
             throw new Exception('submissionId required for viewer-url');
         }
 
+        $statusResp = $this->getSimilarityStatus($submissionId);
+        $st = strtoupper(trim((string) ($statusResp['status'] ?? '')));
+        if ($st !== '' && $st !== 'COMPLETE') {
+            throw new Exception('similarity report not ready for viewer-url, status=' . $st);
+        }
+
         $path = '/submissions/' . rawurlencode($submissionId) . '/viewer-url';
         $lastError = null;
 
@@ -521,8 +527,12 @@ class TurnitinService
      */
     private function buildViewerUrlBodies(array $viewerOverrides)
     {
-        if (!empty($viewerOverrides)) {
-            return [$viewerOverrides];
+        if (!empty($viewerOverrides) && isset($viewerOverrides['viewer_default_permission_set'])) {
+            $body = $viewerOverrides;
+            if (empty($body['viewer_user_id'])) {
+                $body['viewer_user_id'] = $this->resolveViewerUserId($viewerOverrides);
+            }
+            return [$body];
         }
 
         $locale = trim((string) Env::get('turnitin.viewer_locale', 'en-US')) ?: 'en-US';
@@ -530,27 +540,67 @@ class TurnitinService
         $permissionSets = $configured !== ''
             ? array_map('trim', explode(',', $configured))
             : $this->defaultViewerPermissionSets();
+        $viewerUserId = $this->resolveViewerUserId($viewerOverrides);
+        $saveChanges  = $this->envBool('turnitin.viewer_save_changes', false);
+        $simModes     = $this->defaultViewerSimilarityBlock();
 
         $bodies = [];
         foreach ($permissionSets as $perm) {
             if ($perm === '') {
                 continue;
             }
+            // TCA 认证要求：必须带 viewer_user_id（此前缺失会导致 400 Bad request）
             $bodies[] = [
-                'viewer_default_permission_set' => $perm,
+                'viewer_user_id'                => $viewerUserId,
                 'locale'                        => $locale,
-                'similarity' => $this->defaultViewerSimilarityBlock(),
+                'viewer_default_permission_set' => $perm,
+                'similarity'                    => [
+                    'view_settings' => ['save_changes' => $saveChanges],
+                ],
             ];
-            // 最简请求体（部分 Crossref 租户只接受 permission + locale）
             $bodies[] = [
-                'viewer_default_permission_set' => $perm,
+                'viewer_user_id'                => $viewerUserId,
                 'locale'                        => $locale,
+                'viewer_default_permission_set' => $perm,
+                'similarity'                    => array_merge($simModes, [
+                    'view_settings' => ['save_changes' => $saveChanges],
+                ]),
+            ];
+            $bodies[] = [
+                'viewer_user_id'                => $viewerUserId,
+                'locale'                        => $locale,
+                'viewer_default_permission_set' => $perm,
             ];
         }
 
         return $bodies;
     }
 
+    /**
+     * viewer-url 必填：与 createSubmission 的 owner/submitter 同一命名空间（editor_{user_id}）。
+     */
+    public function resolveViewerUserId(array $opts = [])
+    {
+        if (!empty($opts['viewer_user_id'])) {
+            return trim((string) $opts['viewer_user_id']);
+        }
+        // 打开报告的人（当前编辑）须与申请 viewer-url 时一致，否则易出现 session 认证失败
+        $editorId = isset($opts['editor_id']) ? intval($opts['editor_id']) : 0;
+        if ($editorId > 0) {
+            return 'editor_' . $editorId;
+        }
+        $triggeredBy = isset($opts['triggered_by']) ? intval($opts['triggered_by']) : 0;
+        if ($triggeredBy > 0) {
+            return 'editor_' . $triggeredBy;
+        }
+        $custom = trim((string) Env::get('turnitin.viewer_user_id', ''));
+        if ($custom !== '') {
+            return $custom;
+        }
+        $name = trim((string) $this->integrationName);
+        return ($name !== '' ? $name : 'tmr') . '_viewer';
+    }
+
     /**
      * Crossref Similarity Check 通常不用 INSTRUCTOR；按常见可用角色排序尝试。
      *