mirror of
https://github.com/LibreSign/libresign.git
synced 2025-12-18 05:20:45 +01:00
d74ffe257d
Created dedicated service to manage sign request status determination and validation. Implements shouldNotifySignRequest, canNotifySignRequest, updateStatusIfAllowed, determineInitialStatus, and private helper methods for status calculation based on file status, signer status, signing order, and flow type (parallel/sequential). Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
93 lines
2.8 KiB
PHP
93 lines
2.8 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
/**
|
|
* SPDX-FileCopyrightText: 2025 LibreCode coop and contributors
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
|
|
namespace OCA\Libresign\Service;
|
|
|
|
use OCA\Libresign\Db\File as FileEntity;
|
|
use OCA\Libresign\Db\SignRequest as SignRequestEntity;
|
|
use OCA\Libresign\Enum\SignRequestStatus;
|
|
|
|
class SignRequestStatusService {
|
|
public function __construct(
|
|
private SequentialSigningService $sequentialSigningService,
|
|
private FileStatusService $fileStatusService,
|
|
) {
|
|
}
|
|
|
|
public function shouldNotifySignRequest(SignRequestStatus $signRequestStatus, ?int $fileStatus): bool {
|
|
return $this->fileStatusService->canNotifySigners($fileStatus)
|
|
&& $this->canNotifySignRequest($signRequestStatus);
|
|
}
|
|
|
|
public function canNotifySignRequest(SignRequestStatus $status): bool {
|
|
return $status === SignRequestStatus::ABLE_TO_SIGN;
|
|
}
|
|
|
|
public function updateStatusIfAllowed(
|
|
SignRequestEntity $signRequest,
|
|
SignRequestStatus $currentStatus,
|
|
SignRequestStatus $desiredStatus,
|
|
bool $isNewSignRequest,
|
|
): void {
|
|
if ($isNewSignRequest || $this->sequentialSigningService->isStatusUpgrade($currentStatus, $desiredStatus)) {
|
|
$signRequest->setStatusEnum($desiredStatus);
|
|
}
|
|
}
|
|
|
|
public function determineInitialStatus(
|
|
int $signingOrder,
|
|
int $fileId,
|
|
?int $fileStatus = null,
|
|
?int $signerStatus = null,
|
|
?SignRequestStatus $currentStatus = null,
|
|
): SignRequestStatus {
|
|
if ($fileStatus === FileEntity::STATUS_DRAFT) {
|
|
return SignRequestStatus::DRAFT;
|
|
}
|
|
|
|
if ($fileStatus === FileEntity::STATUS_ABLE_TO_SIGN) {
|
|
return $this->determineStatusForAbleToSignFile($signingOrder);
|
|
}
|
|
|
|
if ($signerStatus !== null) {
|
|
return $this->handleExplicitSignerStatus($signerStatus, $signingOrder, $fileId, $currentStatus);
|
|
}
|
|
|
|
return $this->getDefaultStatusByFlow($signingOrder);
|
|
}
|
|
|
|
private function determineStatusForAbleToSignFile(int $signingOrder): SignRequestStatus {
|
|
if ($this->sequentialSigningService->isOrderedNumericFlow()) {
|
|
return $signingOrder === 1 ? SignRequestStatus::ABLE_TO_SIGN : SignRequestStatus::DRAFT;
|
|
}
|
|
return SignRequestStatus::ABLE_TO_SIGN;
|
|
}
|
|
|
|
private function handleExplicitSignerStatus(
|
|
int $signerStatus,
|
|
int $signingOrder,
|
|
int $fileId,
|
|
?SignRequestStatus $currentStatus,
|
|
): SignRequestStatus {
|
|
$desiredStatus = SignRequestStatus::from($signerStatus);
|
|
|
|
if ($currentStatus !== null && !$this->sequentialSigningService->isStatusUpgrade($currentStatus, $desiredStatus)) {
|
|
return $currentStatus;
|
|
}
|
|
|
|
return $this->sequentialSigningService->validateStatusByOrder($desiredStatus, $signingOrder, $fileId);
|
|
}
|
|
|
|
private function getDefaultStatusByFlow(int $signingOrder): SignRequestStatus {
|
|
if (!$this->sequentialSigningService->isOrderedNumericFlow()) {
|
|
return SignRequestStatus::ABLE_TO_SIGN;
|
|
}
|
|
|
|
return $signingOrder === 1 ? SignRequestStatus::ABLE_TO_SIGN : SignRequestStatus::DRAFT;
|
|
}
|
|
}
|