Configuração do workspace

Entenda como gerenciar o armazenamento de dados, backups e sincronização na nuvem.

O que é o Workspace Root?

O Workspace Root é a pasta central onde o PDF Mail Engine armazena todos os dados do aplicativo.

Em vez de esconder dados em pastas complexas do sistema, tudo fica em um local transparente e acessível. Isso inclui:

Profiles: Suas configurações de trabalho e de e-mail.
Templates: Os arquivos de layout YAML para seus designs de PDF.
Backups: Backups automáticos das suas configurações.
Output: Os PDFs gerados são salvos aqui por padrão (a menos que seja alterado).
Logs: Logs de operação para solução de problemas.

Comportamento padrão

Por padrão, o aplicativo cria uma pasta no diretório Documentos: Documents/PDFMailEngine_Workspace

Alterando o workspace

Você pode alterar o local na página de configurações do System.

Vá para a aba System.
Em Workspace Configuration, clique em Browse.
Selecione uma nova pasta.

Os dados NÃO são movidos

Ao alterar o Workspace Root, o aplicativo simplesmente passa a apontar para a nova pasta. Ele não copia ou move seus perfis ou modelos existentes. Você precisa movê-los manualmente, se necessário.

Implantação estratégica (Casos de uso)

Como o workspace é apenas uma pasta, você pode colocá-lo em qualquer lugar de acordo com suas necessidades de segurança e operação.

1. Disco local (Padrão)

Ideal para: Privacidade rigorosa e velocidade Manter o workspace no PC local (ex.: C:\Users\Você\Documents\...) garante que nenhum dado saia da sua máquina física. Isso proporciona o melhor desempenho e atende aos requisitos mais rigorosos de residência de dados.

2. Drive externo / NAS

Ideal para: Redundância e compartilhamento local Você pode configurar o workspace em um disco rígido externo (RAID) ou em um dispositivo NAS.

Segurança: Protege contra falhas de hardware do PC.
Compartilhamento: Permite acessar os mesmos perfis de diferentes computadores na mesma rede (garanta que apenas um usuário escreva por vez).

3. Armazenamento em nuvem (Google Drive / OneDrive)

Ideal para: Backup automático e mobilidade Você pode apontar o workspace para uma pasta sincronizada na nuvem (ex.: C:\Users\Você\OneDrive\PDFMailEngine_Workspace).

Backup contínuo: Toda vez que você salva um modelo ou gera um log, o serviço de nuvem faz backup instantaneamente.
Gerenciamento de armazenamento: Libera espaço no disco local.
Mobilidade: Configure o workspace no mesmo caminho da nuvem em um segundo computador (ex.: notebook) para acessar suas configurações de outro local.

Detalhes técnicos (Avançado)

Para administradores de sistema e engenheiros.

Armazenamento da configuração

O caminho do workspace é armazenado no arquivo de configuração local do usuário:

Path: %LOCALAPPDATA%\OFFICEKAMIYA\PDFMailEngine\config\user_settings.json
Key: workspace_root

Se este valor estiver vazio ou o arquivo estiver ausente, o aplicativo reverte para a lógica padrão do diretório Documents.

Resolução de caminhos

O aplicativo utiliza uma arquitetura de "caminho relativo".

Referências internas (ex.: vincular uma imagem em um modelo) são resolvidas em relação ao Workspace Root.
Isso garante portabilidade: você pode copiar a pasta inteira do workspace para outro computador (ex.: de C:\Users\Alice\Docs para D:\Backups), e desde que o aplicativo aponte para o novo diretório raiz, todos os links funcionarão imediatamente.

Lógica de troca

A mudança do workspace é uma troca de estado, não uma migração.

Ação: Atualiza o ponteiro em user_settings.json imediatamente.
Efeito colateral: A interface é atualizada para mostrar os perfis contidos no novo destino.
Limpeza: A pasta do workspace antigo permanece intacta.