DuRT 3.0.0 移行ガイド：データベース刷新と旧バージョンからの安全な移行

WARNING

アップグレード前の重要なお知らせ（警告）：
DuRT 3.0.0 は、データ永続化アーキテクチャ（GRDB SQLite エンジン）およびワークフロー実行コアを大幅に刷新しました。3.0.0 のデータベース構造は、2.x 以前のバージョンと互換性がありません。
以前のバージョンの DuRT をインストールまたは使用したことがある場合、絶対にそのまま上書きインストールしないでください！ 起動時のクラッシュや履歴の読み込みエラーが発生する可能性があります。必ず以下の手順に従ってリソースを移行し、クリーンアンインストールを行ってください。

---

1. 移行が必要かどうかの確認

DuRT のワークスペース（Workspace）設定によって、音声や字幕、書き起こし文書の保存場所が異なります：

ワークスペース種別	特徴	手動移行が必要か？	推奨アクション
カスタムワークスペース	ユーザーが設定で指定した外部フォルダ（書類、外付けドライブなど）	不要 ✅	ファイルは指定したフォルダに安全に保存されており、旧バージョンのアンインストールによる影響を受けません。新バージョンで再バインドするだけで完了します。
デフォルトワークスペース (Default)	macOS サンドボックス内の規定フォルダ（~/Library/...）	必須 ⚠️	サンドボックスの初期化やアンインストール時にデータが消去されるリスクがあります。アンインストール前に重要な文書・字幕・音声を退避してください。

---

2. デフォルトワークスペースの退避手順

デフォルトワークスペースをご利用中の方は、旧バージョンをアンインストールする前に以下を実施してください：

1. 現在の旧バージョン DuRT を起動します。
2. 重要字幕・書き起こしテキストのエクスポート：
   • 履歴一覧またはエディタから、保存したいデータを .srt, .vtt, .json, .txt として「ダウンロード」や「書類」フォルダへ書き出します。
3. ローカルサンドボックスフォルダのバックアップ：
   • Finder で Command ⌘ + Shift ⇧ + G を押します。
   • サンドボックスパスを入力します：

     ~/Library/Containers/com.dudufuture.durt/Data/Library/workspace

   • workspace フォルダをデスクトップまたは安全な場所へコピーして退避します。

---

3. 旧バージョンの完全アンインストール

App Store から 3.0.0 をダウンロードする前に、競合する旧版 SQLite ファイルを削除します：

ステップ A：旧版アプリの終了と削除

1. DuRT を完全に終了します（Dock およびメニューバーから確実に終了）。
2. Finder で「アプリケーション」を開きます。
3. 旧版 DuRT.app をゴミ箱に入れ、「ゴミ箱を空にする」を実行します。

ステップ B：旧版データベースキャッシュの削除

ターミナルを開き、以下のコマンドで旧版データベースを削除します：

rm -rf ~/Library/Containers/com.dudufuture.durt/Data/Library/database

（※完全にクリーンな状態で再インストールしたい場合は rm -rf ~/Library/Containers/com.dudufuture.durt を実行してください。事前にバックアップが完了していることをご確認ください。）

---

4. DuRT 3.0.0 のインストールと利用開始

1. Mac App Store から最新の DuRT 3.0.0 をインストールします。
2. アプリを起動すると、最新の GRDB データベースとワークフローエンジンが自動構築されます。
3. 設定 → ワークスペースから必要に応じてフォルダを再リンクし、Pro 会員の方は「購入を復元 (Restore Purchase)」を行ってください。