Media, Storage e Artefactos
Como ficheiros carregados, seleção de imagens e artefactos de proposta suportam os outputs de entrega na Ghloria.
Os outputs de entrega dependem de acesso fiável aos media da proposta. A Ghloria usa storage com scope e rotas de artefactos para que imagens, templates e ficheiros de suporte possam ser reutilizados na edição da proposta, exportação de email e exportação PowerPoint.
Media Manager
O construtor de propostas inclui um media manager para blocos baseados em imagem. Suporta:
- Upload de ficheiros de imagem
- Upload de imagens por drag-and-drop
- Colar imagens a partir da área de transferência
- Pesquisa no Unsplash quando configurado
- Adição direta de URLs de imagem
- Seleção de uma ou várias imagens consoante o bloco
- Escolha de modos de visualização para blocos de imagem, incluindo carousel e layouts estilo bento
As imagens carregadas são guardadas como artefactos da versão da proposta quando o bloco está ligado a uma proposta e versão. O editor mantém uma referência de storage para que a mesma imagem possa ser resolvida mais tarde na exportação.
Scopes de Artefactos
A Ghloria expõe rotas de artefactos para vários scopes operacionais:
- Artefactos de versão de proposta
- Artefactos de cliente
- Artefactos de viagem
- Artefactos de fornecedor
Os artefactos podem ser listados, carregados, apagados e movidos entre pastas. Os artefactos de versão de proposta são especialmente importantes para entrega porque fornecem referências de imagem e ficheiro usadas pelo construtor de propostas e pelos serviços de exportação.
Acesso a Objetos de Storage
As rotas de objetos de storage suportam leitura autenticada e remoção de objetos por scope. Os tipos de objeto suportados incluem:
usercompanyclienttemplateproposal
A rota de objeto devolve ficheiros inline com tipos de conteúdo de imagem inferidos quando possível. Também pode servir uma imagem externa inline quando é fornecido um URL de origem válido.
Inicialização de Upload
Para uploads diretos para storage, a Ghloria pede um destino de upload usando nome do ficheiro, tamanho, MIME type, tipo de objeto e caminho. O transporte de upload devolvido é depois usado para enviar o ficheiro para storage antes de o backend finalizar o registo relacionado.
Este padrão é usado para uploads de templates e também está disponível para outros fluxos suportados por storage.
Unsplash e Imagens Externas
Quando o Unsplash está configurado, os utilizadores podem pesquisar imagens no media manager. Assets selecionados do Unsplash podem ser descarregados, registados através da API do Unsplash, carregados como artefactos da versão da proposta e depois referenciados pelo conteúdo da proposta.
URLs diretos de imagem também podem ser selecionados no media manager. Para outputs gerados, as imagens são resolvidas a partir de artefactos guardados ou URLs quando o fluxo de exportação o suporta.
Separador Biblioteca
O media manager inclui um separador de biblioteca na interface, mas a implementação atual mostra um estado vazio nesse separador. Use upload, Unsplash ou seleção direta por URL para media de entrega da proposta.
Como os Media Chegam às Exportações
A exportação de email resolve imagens de capa, logotipos de empresa e fotografias de agente antes da renderização. A exportação PowerPoint pode recolher referências de artefactos de imagem no conteúdo da proposta, procurar URLs dos artefactos da versão atual, converter imagens elegíveis para base64 e incluí-las no payload de geração PPTX.
Isto mantém os ficheiros de entrega alinhados com o conteúdo da proposta, sem depender de substituição manual de imagens depois da exportação.