ADR-0006 · Arquivos em volume local servido pela API

Status: aceito · Substitui: Uploadcare (em desuso)

Contexto

O Uploadcare foi usado para upload e validação de A4, mas acrescentava custo por arquivo e dependência externa para o arquivo mais importante do negócio, a plantigrafia.

Decisão

Todos os uploads vão para o order-lifecycle (/api/v2/upload/*) e ficam no volume uploads (/app/uploads), servidos estaticamente em /uploads/. PDFs são convertidos em imagem no servidor com pdf2pic + GraphicsMagick.

Consequências

• ➕ Sem custo por arquivo e com controle total.
• ➖ Backup e retenção passam a ser do time (R-09).
• ➖ Escalar horizontalmente a API exigiria storage compartilhado (S3 compatível self-hosted, como MinIO).
• 🧹 Remover components/uploadcare, lib/uploadcare, app/api/uploadcare/* e as dependências @uploadcare/*.