ワークスペース設定 (Workspace Configuration)

Workspace Root とは何ですか？ (What is the Workspace Root?)

Workspace Root (ワークスペースルート) は、PDF Mail Engine がすべてのアプリケーションデータを保存する中心的なフォルダです。

複雑なシステムフォルダにデータを隠す代わりに、すべてを1つの透明性の高い場所に保管します。これには以下が含まれます：

• Profiles: ジョブ設定とメール設定。
• Templates: PDFデザイン用のYAMLレイアウトファイル。
• Backups: 設定の自動バックアップ。
• Output: 生成されたPDFはデフォルトでここに保存されます（上書きしない限り）。
• Logs: トラブルシューティング用の操作ログ。

デフォルトの動作 (Default Behavior)

デフォルトでは、アプリケーションはドキュメントディレクトリにフォルダを作成します： Documents/PDFMailEngine_Workspace

ワークスペースの変更 (Changing the Workspace)

この場所は、System 設定ページから変更できます。

1. System タブに移動します。
2. Workspace Configuration の下にある Browse をクリックします。
3. 新しいフォルダを選択します。

戦略的デプロイメント（ユースケース）

ワークスペースは単なるフォルダなので、セキュリティや運用のニーズに合わせてどこにでも配置できます。

1. ローカルディスク (デフォルト)

最適: 厳格なプライバシーと速度 ワークスペースをローカルPC（例：C:\Users\You\Documents\...）に保持することで、データが物理マシンから出ないようにします。これにより、最高のパフォーマンスが得られ、厳格なデータ居住要件を満たすことができます。

2. 外付けドライブ / NAS

最適: 冗長性とローカル共有 ワークスペースを外付けハードドライブ（RAID）またはネットワーク接続ストレージ（NAS）デバイスに設定できます。

• 安全性: PCのハードウェア障害から保護します。
• 共有: 同じオフィスネットワーク上の異なるコンピュータから同じプロファイルにアクセスできます（一度に書き込むのは1人のユーザーのみにしてください）。

3. クラウドストレージ (Google Drive / OneDrive)

最適: 自動バックアップとモビリティ ワークスペースを同期されたクラウドフォルダ（例：C:\Users\You\OneDrive\PDFMailEngine_Workspace）に指定できます。

• 継続的なバックアップ: テンプレートを保存したりログを生成したりするたびに、クラウドサービスが即座にバックアップします。
• ストレージ管理: ローカルディスクのストレージをオフロードします。
• モビリティ: 2台目のコンピュータ（ラップトップなど）で同じクラウドパスにワークスペースを設定して、別の場所からセットアップにアクセスできます。

技術詳細（上級者向け）

システム管理者およびエンジニア向け。

設定ストレージ

ワークスペースパスは、ユーザーのローカル設定ファイルに保存されます：

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

この値が空であるか、ファイルが見つからない場合、アプリケーションはデフォルトの Documents ロジックに戻ります。

パス解決

アプリケーションは「相対パス」アーキテクチャを使用します。

• 内部参照（例：テンプレート内の画像のリンク）は、Workspace Root を基準に解決されます。
• これにより移植性が確保されます：ワークスペースフォルダ全体を別のコンピュータにコピーしても（例：C:\Users\Alice\Docs から D:\Backups へ）、アプリを新しいルートに向ける限り、すべてのリンクはすぐに機能します。

切り替えロジック

ワークスペースの変更は、移行ではなく 状態の切り替え (State Switch) です。

• Action: user_settings.json のポインタを即座に更新します。
• Side Effect: UIがリフレッシュされ、新しいターゲットに含まれるプロファイルが表示されます。
• Cleanup: 古いワークスペースフォルダはそのまま残ります。