GatePassageService

Doctrine-backed {@see GateServiceInterface} implementation: persists append-only {@see \Milpa\Workflow\Entities\GatePassage} rows and enforces the anti-self-approval constraint (D9) at the service layer, since it is not expressible as a column constraint on an opaque principal string.

public function __construct(Doctrine\ORM\EntityManagerInterface $em, ?Milpa\Interfaces\Observability\AuditLoggerInterface $auditLogger = null):

Parameters

public function requestPassage(Milpa\Workflow\Entities\GateDefinition $gate, string $entityType, int $entityId, string $requesterId, ?array $fieldValues = null): Milpa\Workflow\Entities\GatePassage

Requests a new gate passage for the given gate and polymorphic entity, persisting it with {@see \Milpa\Workflow\Enums\GatePassageStatus::REQUESTED} and auditing the request.

Parameters

public function approvePassage(Milpa\Workflow\Entities\GatePassage $passage, string $approverId, ?string $notes = null): Milpa\Workflow\Entities\GatePassage

Approves a pending gate passage and audits the approval.

Parameters

Throws

SelfApprovalException when `$approverId` equals the passage's requester (D9)

public function rejectPassage(Milpa\Workflow\Entities\GatePassage $passage, string $rejectorId, string $reason): Milpa\Workflow\Entities\GatePassage

Rejects a pending gate passage with a reason and audits the rejection.

Parameters

public function getApprovedPassagesForEntity(string $entityType, int $entityId): array

Returns every approved gate passage for the given polymorphic entity, most recent first.

Parameters

public function waiveGate(Milpa\Workflow\Entities\GateDefinition $gate, string $entityType, int $entityId, string $waiverId, string $justification): Milpa\Workflow\Entities\GatePassage

Approves a gate passage without requiring its normal evidence/field requirements, recording the waiver and its justification, and audits it.

Parameters

Throws

NonWaivableGateException when the gate's `isWaivable` flag is false