SEPARAÇÃO DAS PASTAS DE ARQUIVOS (FORA DO SISTEMA)
====================================================

Objetivo
--------
Na atualização da hospedagem, trocar só o código do sistema sem perder
nenhum arquivo: holerite, documento, foto, vídeo, assinatura, banner, logo etc.


Como era
--------
Os arquivos ficavam DENTRO da pasta do sistema, em:

  desktop/storage/
  desktop/public/uploads/

Por isso não dava para apagar ou substituir a pasta do sistema de uma vez:
os arquivos iam junto.


Como ficou
----------
O código e os arquivos passaram a ser coisas separadas.

O sistema pergunta no arquivo .env onde estão os documentos, na linha:

  STORAGE_PATH=../../armazenamento-pontosaas

O caminho é relativo à pasta desktop/. No computador e na hospedagem
a estrutura é a mesma, então a linha vale nos dois lugares.


O que colocar na hospedagem
---------------------------
A pasta que recebe os arquivos já existe, irmã do sistema:

  https://cliente.procontrolcloud.com/projetos/apps/armazenamento-pontosaas/

No disco, ao lado de ponto-saas:

  projetos/apps/armazenamento-pontosaas/

No .env (não substituir esse arquivo na atualização do código):

  STORAGE_PATH=../../armazenamento-pontosaas

Dentro dessa pasta o sistema usa:

  armazenamento-pontosaas/
    storage/     holerites, documentos do colaborador, selfies, vídeos,
                 evidências de ponto, logs, pacotes assinados
    uploads/     fotos de perfil, banners, logos, chat, solicitações

Os nomes das pastas internas continuam os mesmos
(employee_documents, holerites, profiles, etc.).
Só a raiz muda.


Rede de segurança na leitura
----------------------------
O sistema primeiro procura o arquivo na pasta nova (STORAGE_PATH).
Se ainda não tiver sido movido, procura no lugar antigo dentro de desktop/.

Assim, no meio da mudança, arquivo antigo não some.


O que fazer UMA VEZ na hospedagem
---------------------------------
1. A pasta já está criada:
     projetos/apps/armazenamento-pontosaas
     (na web: /projetos/apps/armazenamento-pontosaas/)

2. Mover para dentro dela, uma vez:
     - desktop/storage          ->  armazenamento-pontosaas/storage
     - arquivos de desktop/public/uploads  ->  armazenamento-pontosaas/uploads
     Não mova gateway.php nem o .htaccess de public/uploads.
     Esses dois ficam no sistema.

3. Gravar no .env:
     STORAGE_PATH=../../armazenamento-pontosaas

4. Conferir se o PHP consegue ler e gravar nessa pasta (permissão de escrita).

5. Manter o .htaccess dessa pasta. Ela fica dentro do site, então sem esse
   bloqueio qualquer pessoa abriria holerite, foto e documento pelo navegador.
   O sistema continua lendo os arquivos pelo PHP.

A partir daí, na atualização:
  - troca só a pasta do código (desktop/)
  - NÃO apaga armazenamento-pontosaas
  - NÃO substitui o .env da hospedagem pelo .env do computador


No computador local
-------------------
A mesma linha aponta para:

  C:\xampp\htdocs\projetos\apps\armazenamento-pontosaas

Arquivo que ainda estiver em desktop/storage ou desktop/public/uploads
continua sendo lido. Arquivo novo passa a ser gravado na pasta de fora.


Resumo
------
Código  = pasta do sistema (pode atualizar / substituir)
Arquivos = pasta STORAGE_PATH (fica sempre no mesmo lugar)
.env da hospedagem = aponta o caminho e não vai no pacote de atualização