Evidence

Evidence entity - Archivo/enlace de evidencia adjuntado a un GatePassage. Cada evidencia es inmutable una vez creada: se asocia al pasaje y no cambia. Puede ser un archivo local (filePath) o una URL externa (fileUrl), o ambos.

public function __construct():

public function getId(): int

public function getUuid(): string

public function getEvidenceType(): Milpa\Workflow\Enums\EvidenceType

Obtiene el tipo como enum EvidenceType.

public function getTypeValue(): string

public function getTitle(): string

public function getDescription(): ?string

public function getFilePath(): ?string

public function getFileUrl(): ?string

public function getMimeType(): ?string

public function getFileSize(): ?int

public function getMetadata(): ?array

public function getCreatedAt(): DateTime

public function getGatePassage(): Milpa\Workflow\Entities\GatePassage

public function getUploadedBy(): string

public function setType(Milpa\Workflow\Enums\EvidenceType $type): self

Sets the evidence type.

Parameters

public function setTitle(string $title): self

Sets the evidence's descriptive title.

Parameters

public function setDescription(?string $description): self

Sets the evidence's optional description.

Parameters

public function setFilePath(?string $filePath): self

Sets the local filesystem path to the evidence file.

Parameters

public function setFileUrl(?string $fileUrl): self

Sets the external URL of the evidence file.

Parameters

public function setMimeType(?string $mimeType): self

Sets the evidence file's MIME type.

Parameters

public function setFileSize(?int $fileSize): self

Sets the evidence file's size in bytes.

Parameters

public function setMetadata(?array $metadata): self

Sets additional metadata for the evidence.

Parameters

public function setGatePassage(Milpa\Workflow\Entities\GatePassage $gatePassage): self

Associates this evidence with the gate passage it belongs to.

Parameters

public function setUploadedBy(string $uploadedBy): self

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

Parameters

public function hasFile(): bool

Verifica si la evidencia tiene un archivo local.

public function hasUrl(): bool

Verifica si la evidencia tiene una URL externa.

public function isImage(): bool

Verifica si el archivo es una imagen.

public function getFormattedFileSize(): string

Obtiene el tamano del archivo formateado.

public function toArray(): array

Converts the entity to an array for API responses.