GatePassage

GatePassage entity - Registro append-only de solicitudes/aprobaciones de gates. Cada registro representa una solicitud para pasar un gate del pipeline. NUNCA se hace UPDATE ni DELETE. Solo INSERT. Una vez creado, el pasaje se resuelve (approve/reject) una sola vez y queda inmutable. Uses polymorphic model: entity_type + entity_id instead of direct FK. CONSTRAINT CRITICO: requestedBy != approvedBy (prohibicion de auto-aprobacion, enforced a nivel de servicio). `requestedBy`/`approvedBy` are opaque principal strings (e.g. "member:42"), matching {@see Evidence::getUploadedBy()} — the engine stores them verbatim and never resolves them to an entity; the consuming product owns identity (D9).

public function __construct():

public function getId(): int

public function getUuid(): string

public function getStatus(): Milpa\Workflow\Enums\GatePassageStatus

Obtiene el estado como enum GatePassageStatus.

public function getStatusValue(): string

public function getRequestedNotes(): ?string

public function getApprovedNotes(): ?string

public function getRejectedReason(): ?string

public function isWaiver(): bool

public function getWaiverJustification(): ?string

public function getMetadata(): ?array

public function getCreatedAt(): DateTime

public function getResolvedAt(): ?DateTime

public function getGateDefinition(): Milpa\Workflow\Entities\GateDefinition

public function getEntityType(): string

public function getEntityId(): int

public function getRequestedBy(): string

public function getApprovedBy(): ?string

public function getEvidences(): Doctrine\Common\Collections\Collection

public function setStatus(Milpa\Workflow\Enums\GatePassageStatus $status): self

Sets the passage's status.

Parameters

public function setRequestedNotes(?string $requestedNotes): self

Sets the requester's notes at the time the passage was requested.

Parameters

public function setApprovedNotes(?string $approvedNotes): self

Sets the approver's notes at the time the passage was approved.

Parameters

public function setRejectedReason(?string $rejectedReason): self

Sets the reason the passage was rejected.

Parameters

public function setIsWaiver(bool $isWaiver): self

Sets whether this passage was waived instead of meeting its requirements.

Parameters

public function setWaiverJustification(?string $waiverJustification): self

Sets the justification for the waiver (required when {@see self::isWaiver()} is true).

Parameters

public function setMetadata(?array $metadata): self

Sets additional metadata for the passage.

Parameters

public function setGateDefinition(Milpa\Workflow\Entities\GateDefinition $gateDefinition): self

Sets the gate definition this passage requests to pass.

Parameters

public function setEntityType(string $entityType): self

Sets the polymorphic entity type this passage belongs to (e.g. "opportunity").

Parameters

public function setEntityId(int $entityId): self

Sets the polymorphic entity ID this passage belongs to.

Parameters

public function setRequestedBy(string $requestedBy): self

Sets the opaque principal that requested the passage (e.g. "member:42"); never resolved to an entity by the engine — the consuming product owns identity (D9).

Parameters

public function setApprovedBy(?string $approvedBy): self

Sets the opaque principal that approved or rejected the passage; never resolved to an entity by the engine (D9). Must not equal {@see self::getRequestedBy()}.

Parameters

public function addEvidence(Milpa\Workflow\Entities\Evidence $evidence): self

Adds a piece of evidence to this passage, wiring the inverse side back.

Parameters

public function removeEvidence(Milpa\Workflow\Entities\Evidence $evidence): self

Removes a piece of evidence from this passage.

Parameters

public function approve(string $approverId, ?string $notes = null): self

Aprueba el pasaje del gate. CONSTRAINT: El aprobador no puede ser el mismo que el solicitante.

Parameters

public function reject(string $approverId, string $reason): self

Rechaza el pasaje del gate. CONSTRAINT: El aprobador no puede ser el mismo que el solicitante.

Parameters

public function isPending(): bool

Verifica si el pasaje esta pendiente de resolucion.

public function isApproved(): bool

Verifica si el pasaje fue aprobado.

public function isRejected(): bool

Verifica si el pasaje fue rechazado.

public function toArray(): array

Converts the entity to an array for API responses. NOTA: requestedBy != approvedBy (self-approval prohibition, enforced at service level). Both are opaque principal strings (D9) — see the class docblock.