{"v":{"area":"admin","slug":"upload-integracoes","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/upload-integracoes.md","relative_path":"docs/readme/admin/upload-integracoes.md","title":"Integracoes de Upload","html":"<h1>Integracoes de Upload</h1><h2>O que e</h2><p>A pagina <code>upload-integracoes</code> centraliza a governanca dos providers de armazenamento usados pelos uploads do sistema.</p><p>Ela complementa duas telas existentes:</p><ul><li><code>uploads-manager</code>, focada em navegar arquivos e testar uploads;</li><li><code>bunny-storage</code>, focada em credenciais Bunny por contrato.</li></ul><h2>Para que serve</h2><ul><li>definir a politica padrao de upload por tipo de arquivo;</li><li>diagnosticar se o Bunny esta configurado para o contrato atual;</li><li>orientar a adocao futura de providers como S3/R2/Wasabi, Google Drive e Dropbox;</li><li>reforcar que <code>upload.php</code> e apenas ponte legada, nao endpoint preferencial.</li></ul><h2>Blocos da tela</h2><ul><li><strong>Politica por tipo de arquivo</strong>: define provider padrao e provider para imagem, video, audio, documento e arquivo generico.</li><li><strong>Diagnostico do contrato</strong>: mostra provider padrao, status do Bunny e contrato analisado.</li><li><strong>Providers de upload</strong>: cards operacionais para Local, Bunny e proximos providers planejados.</li><li><strong>Roadmap em offcanvas</strong>: mostra o que ja foi entregue na frente de upload e as proximas etapas da arquitetura.</li><li><strong>Frentes auditadas agora</strong>: resume os fluxos de foto, documentos e prontuario que ja foram mapeados no codigo, com status visual por frente.</li></ul><h2>Acoes</h2><ul><li><strong>Salvar politica</strong>: grava a politica global em <code>tiix_uploads_manager_settings</code>.</li><li><strong>File manager</strong>: abre a navegacao operacional de arquivos.</li><li><strong>Bunny Storage</strong>: abre a gestao de credenciais Bunny por contrato.</li><li><strong>Roadmap</strong>: abre o painel lateral com entregas concluidas, prioridades atuais e fases futuras.</li><li><strong>Atualizar</strong>: recarrega politica e diagnostico do contrato.</li></ul><h2>Observacoes tecnicas</h2><ul><li>A pagina usa <code>/adm/api/Uploads/settingsGet</code>, <code>/adm/api/Uploads/settingsSave</code> e <code>/adm/api/Uploads/managerConfig</code>.</li><li>Novos providers devem entrar pela camada <code>App\\Shared\\Storage</code>.</li><li>Drive e Dropbox devem ser tratados inicialmente como integracoes documentais ou sincronizacao, nao como storage primario de midia.</li><li>Status atual do roadmap: tarefas e chats ja conseguem acompanhar a politica local/cloud; o mapa atual tambem separa avatars, documentos de pacientes/clientes, prontuario/resultados e anexos operacionais.</li></ul><h2>Frentes auditadas em 2026-04-23</h2><ul><li><strong>Fotos e avatars</strong></li><li>Parceiro: usa <code>/adm/api/Uploads/simple</code> e depois persiste com <code>Partners/my_avatar_save</code>.</li><li>Admin: usa <code>Customers/upload_avatar</code>, ainda com gravacao local em <code>uploadFiles/avatars/...</code>.</li><li><strong>Pacientes e clientes</strong></li><li><code>Patients/document_save</code>: upload local direto via <code>PatientDocumentsService</code>.</li><li><code>Documents/deliveries_save</code>: ainda multipart local; a trilha chunked existe, mas nao e a principal em todas as telas.</li><li><strong>Prontuario e resultados</strong></li><li><code>Booking/results_upload</code>: grava local em <code>uploadFiles/agendamentos/{contrato}/{agendamento}</code> e ainda depende de URL publica.</li><li><strong>Atendimento e suporte</strong></li><li><code>Customers/support_upload</code> e <code>PartnersAppointments/docs_upload</code>: continuam em trilha local propria.</li><li><strong>Ja no trilho oficial</strong></li><li>tarefas e chats ja usam a camada oficial de upload como base.</li></ul>"},"exp":1780849847}