feat(settings): add getUserIdentificationSettings method with tests

- Add getUserIdentificationSettings() public method
- Extract user identification logic for reusability
- Add comprehensive test coverage for all scenarios:
  * identification documents disabled
  * need to send documents
  * waiting for approval
  * documents approved

This enables external services to check user identification
status without duplicating the status resolution logic.

Signed-off-by: Vitor Mattos <[email protected]>

Author: vitormattos

lib/Service/File/SettingsLoader.php

@@ -83,4 +83,22 @@ public function getIdentificationDocumentsStatus(string $userId = ''): int {
 
 		return self::IDENTIFICATION_DOCUMENTS_APPROVED;
 	}
+
+	/**
+	 * Get user identification documents settings
+	 * These are user-specific settings, not file-specific
+	 *
+	 * @return array{needIdentificationDocuments: bool, identificationDocumentsWaitingApproval: bool}
+	 */
+	public function getUserIdentificationSettings(string $userId): array {
+		$status = $this->getIdentificationDocumentsStatus($userId);
+
+		return [
+			'needIdentificationDocuments' => in_array($status, [
+				self::IDENTIFICATION_DOCUMENTS_NEED_SEND,
+				self::IDENTIFICATION_DOCUMENTS_NEED_APPROVAL,
+			], true),
+			'identificationDocumentsWaitingApproval' => $status === self::IDENTIFICATION_DOCUMENTS_NEED_APPROVAL,
+		];
+	}
 }

tests/php/Unit/Service/File/SettingsLoaderTest.php

@@ -232,4 +232,67 @@ public function testLoadSettingsEmptyUserIdReturnsNeedSend(): void {
 
 		$this->assertEquals(SettingsLoader::IDENTIFICATION_DOCUMENTS_NEED_SEND, $status);
 	}
+
+	public function testGetUserIdentificationSettingsDisabled(): void {
+		$this->appConfig->method('getValueBool')
+			->with(Application::APP_ID, 'identification_documents', false)
+			->willReturn(false);
+
+		$service = $this->getService();
+		$result = $service->getUserIdentificationSettings('user123');
+
+		$this->assertFalse($result['needIdentificationDocuments']);
+		$this->assertFalse($result['identificationDocumentsWaitingApproval']);
+	}
+
+	public function testGetUserIdentificationSettingsNeedSend(): void {
+		$this->appConfig->method('getValueBool')
+			->with(Application::APP_ID, 'identification_documents', false)
+			->willReturn(true);
+
+		$this->fileMapper->method('getFilesOfAccount')->with('user456')->willReturn([]);
+
+		$service = $this->getService();
+		$result = $service->getUserIdentificationSettings('user456');
+
+		$this->assertTrue($result['needIdentificationDocuments']);
+		$this->assertFalse($result['identificationDocumentsWaitingApproval']);
+	}
+
+	public function testGetUserIdentificationSettingsNeedApproval(): void {
+		$this->appConfig->method('getValueBool')
+			->with(Application::APP_ID, 'identification_documents', false)
+			->willReturn(true);
+
+		$file = new File();
+		$file->setStatus(File::STATUS_DRAFT);
+
+		$this->fileMapper->method('getFilesOfAccount')->with('user789')->willReturn([$file]);
+
+		$service = $this->getService();
+		$result = $service->getUserIdentificationSettings('user789');
+
+		$this->assertTrue($result['needIdentificationDocuments']);
+		$this->assertTrue($result['identificationDocumentsWaitingApproval']);
+	}
+
+	public function testGetUserIdentificationSettingsApproved(): void {
+		$this->appConfig->method('getValueBool')
+			->with(Application::APP_ID, 'identification_documents', false)
+			->willReturn(true);
+
+		$file1 = new File();
+		$file1->setStatus(File::STATUS_SIGNED);
+
+		$file2 = new File();
+		$file2->setStatus(File::STATUS_SIGNED);
+
+		$this->fileMapper->method('getFilesOfAccount')->with('user999')->willReturn([$file1, $file2]);
+
+		$service = $this->getService();
+		$result = $service->getUserIdentificationSettings('user999');
+
+		$this->assertFalse($result['needIdentificationDocuments']);
+		$this->assertFalse($result['identificationDocumentsWaitingApproval']);
+	}
 }