Pular para o conteúdo principal

Integração Google Drive — documentos de estabelecimentos

Novos uploads de documentos de EC passam pelo Google Drive (Shared Drive + conta de serviço). Arquivos antigos em disco local continuam legíveis via fallback configurável.

O que faz​

  • Grava uploads novos em uploads/estabelecimentos/{id}/{arquivo} no Drive (via backend/src/integrations/google-drive/).
  • Mantém leitura de arquivos legados em pastas locais (DOCUMENT_STORAGE_ROOT e DOCUMENT_STORAGE_EXTRA_ROOTS).
  • Expõe diagnóstico em backend/api/storage/drive-health.php e utilitário CLI tools/drive_health.php.

Variáveis (.env)​

Ver também .env.example:

  • GOOGLE_DRIVE_USER_MEDIA_FOLDER_ID — ID da pasta raiz no Drive
  • GOOGLE_APPLICATION_CREDENTIALS — caminho absoluto ao JSON da service account (dev)
  • GOOGLE_DRIVE_SERVICE_ACCOUNT_JSON — JSON inline (produção, alternativa ao arquivo)
  • DOCUMENT_STORAGE_ROOT / DOCUMENT_STORAGE_EXTRA_ROOTS — leitura de legado local

Sem credenciais Drive configuradas, o fluxo de upload novo falha; o restante do cadastro pode continuar dependendo da tela.

Relacionado​

  • Agenda pessoal (OAuth por usuário): integracao-google-agenda.md
  • Migration de metadados: database/migrations/20260903_google_drive_media.php