Garage (object storage S3)

O Garage é o object storage S3-compatível da X-Adm, exposto em https://arquivo-api.xadm.biz. É um recurso compartilhado: uma key e um bucket dedicados por app (ex.: onpetro, vantroba).

Regras de uso

• O app fala protocolo S3 padrão (AWS SDK, path-style) — agnóstico de backend.
• Buckets e keys são provisionados no Garage pelo time, não pelo app (nada de criar bucket em produção via código). A key do app precisa de read+write no bucket dele.
• A região configurada no cliente S3 deve bater com o s3_region do Garage (valor atual: garage).
• Credenciais (access key / secret key) entram como variáveis de ambiente marcadas como Secret no Coolify.

Variáveis típicas num app

Variável	Exemplo
S3_ENDPOINT	https://arquivo-api.xadm.biz
S3_BUCKET	vantroba
S3_REGION	garage
S3_ACCESS_KEY / S3_SECRET_KEY	(Secret)

Decisões específicas de cada app sobre o que guardar no Garage (e estratégias de migração) são design docs no repo do app — ver, por exemplo, o modo de armazenamento de XLS do bi-transporte-xls.