Arquivos

Uploads usam presign, envio direto ao armazenamento e confirm. A API não aceita corpos de arquivo brutos.

Endpoint	Corpo/parâmetros	Permissão
`POST /files/presign`	`fileName, contentType, sizeBytes, kind, subjectId, contractId, paymentId`	`contract_view view`
`PUT signed upload URL`	`file bytes to object storage`	`signed URL`
`POST /files/confirm`	`objectKey, fileName, contentType, sizeBytes, kind, uploadToken`	`contract_view view`
`GET /files/:id/download`	`contractId, paymentId`	`contract_view view`