|
|
@@ -1,5 +1,23 @@
|
|
|
# Jotai 移行進捗（2025-09-05 更新）
|
|
|
|
|
|
+## 移行作業フロー ⚠️【重要】
|
|
|
+
|
|
|
+### 基本手順（必ず順序通りに実行）
|
|
|
+1. **新しいJotaiベースの実装を作成**
|
|
|
+2. **使用箇所を新しい実装に置き換え**
|
|
|
+3. **【必須】旧コードの削除** ← これを忘れずに！
|
|
|
+4. **【必須】型チェックの実行** ← migration完了確認
|
|
|
+
|
|
|
+```bash
|
|
|
+# 型チェック実行（migration完了確認）
|
|
|
+cd /workspace/growi/apps/app && pnpm run lint:typecheck
|
|
|
+```
|
|
|
+
|
|
|
+### ⚠️ 旧コード削除が必須な理由
|
|
|
+- **Migration完了の確認**: 旧コードが残っていると、移行が不完全でもtypecheckがパスしてしまう
|
|
|
+- **コンパイルエラーによる検証**: 旧コードを削除することで、移行漏れが確実に検出される
|
|
|
+- **保守性の向上**: 重複コードがないことで、将来の変更時の混乱を防ぐ
|
|
|
+
|
|
|
## 実装状況
|
|
|
|
|
|
### ✅ 移行完了済み
|
|
|
@@ -45,6 +63,11 @@
|
|
|
- 使用箇所を完全移行（GrantSelector、SavePageControls、PageEditor）
|
|
|
- デフォルト値: `{ grant: PageGrant.GRANT_PUBLIC }`
|
|
|
|
|
|
+#### モーダル状態（個別ファイル方式で移行中）
|
|
|
+- ✅ **`usePageCreateModal`**: ページ作成モーダル（states/ui/modal/page-create.ts）
|
|
|
+- ✅ **`usePageDeleteModal`**: ページ削除モーダル（states/ui/modal/page-delete.ts）
|
|
|
+- ✅ **個別インポート方式**: `from '~/states/ui/modal/page-create'` でバンドルサイズ最適化
|
|
|
+
|
|
|
### ✅ 型チェック修正（完了済み）
|
|
|
- ✅ 全てのTS2488エラー（配列分割代入の誤用）を修正済み
|
|
|
- ✅ `pnpm run lint:typecheck` が成功することを確認済み
|
|
|
@@ -62,7 +85,8 @@
|
|
|
- `states/ui/sidebar/`: サイドバー状態の完全実装
|
|
|
- `states/ui/device.ts`: デバイス状態
|
|
|
- `states/ui/editor/`: エディター状態（useSelectedGrant追加）
|
|
|
-- `states/ui/page.ts`: ページUI状態（usePageControlsX新規追加） ← **NEW**
|
|
|
+- `states/ui/page.ts`: ページUI状態（usePageControlsX新規追加）
|
|
|
+- `states/ui/modal/`: 個別モーダルファイル（page-create, page-delete）
|
|
|
- `states/page/`: ページ関連状態の完全実装
|
|
|
- `states/server-configurations/`: サーバー設定状態
|
|
|
- `states/global/`: グローバル状態
|
|
|
@@ -70,7 +94,23 @@
|
|
|
|
|
|
## 🚧 次の実装ステップ（優先度順）
|
|
|
|
|
|
-### **優先度 1: 他のUI関連フック（判定・検討が必要）**
|
|
|
+### **優先度 1: 残りモーダル状態の移行**
|
|
|
+
|
|
|
+#### 個別ファイル方式での継続実装 ← **次の主要タスク**
|
|
|
+- **残り16個のモーダル**: 個別ファイル `states/ui/modal/[modal-name].ts` で実装
|
|
|
+- **対象モーダル**:
|
|
|
+ - `useGrantedGroupsInheritanceSelectModal`, `useEmptyTrashModal`
|
|
|
+ - `usePageDuplicateModal`, `usePageRenameModal`, `usePutBackPageModal`
|
|
|
+ - `usePagePresentationModal`, `usePrivateLegacyPagesMigrationModal`
|
|
|
+ - `useDescendantsPageListModal`, `usePageAccessoriesModal`
|
|
|
+ - `useUpdateUserGroupConfirmModal`, `useShortcutsModal`
|
|
|
+ - `useDrawioModal`, `useHandsontableModal`, `useConflictDiffModal`
|
|
|
+ - `useBookmarkFolderDeleteModal`, `useDeleteAttachmentModal`
|
|
|
+ - `usePageSelectModal`, `useTagEditModal`
|
|
|
+- **実装方針**: 既存パターン（page-create, page-delete）を踏襲
|
|
|
+- **特徴**: すべて一時的な状態で永続化不要
|
|
|
+
|
|
|
+### **優先度 2: 他のUI関連フック（判定・検討が必要）**
|
|
|
|
|
|
以下のフックはSWR継続使用を検討（データフェッチングやcomputed値のため）：
|
|
|
- `useCurrentPageTocNode`: ページ固有の目次データ
|
|
|
@@ -80,25 +120,9 @@
|
|
|
- `useCommentEditorDirtyMap`: 複雑なMap操作
|
|
|
- `useIsAbleToShow*`: computed boolean値群
|
|
|
|
|
|
-### **優先度 2: モーダル状態の一括移行**
|
|
|
-
|
|
|
-#### 全モーダル状態の移行 ← **次の主要タスク**
|
|
|
-- **新規ファイル**: `states/ui/modal.ts`
|
|
|
-- **対象モーダル（全18種類）**:
|
|
|
- - `usePageCreateModal`, `useGrantedGroupsInheritanceSelectModal`
|
|
|
- - `usePageDeleteModal`, `useEmptyTrashModal`, `usePageDuplicateModal`
|
|
|
- - `usePageRenameModal`, `usePutBackPageModal`, `usePagePresentationModal`
|
|
|
- - `usePrivateLegacyPagesMigrationModal`, `useDescendantsPageListModal`
|
|
|
- - `usePageAccessoriesModal`, `useUpdateUserGroupConfirmModal`
|
|
|
- - `useShortcutsModal`, `useDrawioModal`, `useHandsontableModal`
|
|
|
- - `useConflictDiffModal`, `useBookmarkFolderDeleteModal`
|
|
|
- - `useDeleteAttachmentModal`, `usePageSelectModal`, `useTagEditModal`
|
|
|
-- **実装方針**: 統一的なパターンでモーダル状態を管理
|
|
|
-- **特徴**: すべて一時的な状態で永続化不要
|
|
|
-
|
|
|
### **最終フェーズ: クリーンアップ**
|
|
|
|
|
|
-#### 不要ファイルの削除とリファクタリング
|
|
|
+#### 不要ファイルの削除とリファクタリング（旧コード削除手順の厳守）
|
|
|
- `stores/ui.tsx` の段階的縮小・最終削除
|
|
|
- `stores/modal.tsx` の完全削除
|
|
|
- 残存する SWR ベースの状態の最終判定
|
|
|
@@ -106,13 +130,14 @@
|
|
|
|
|
|
## 📊 進捗サマリー
|
|
|
|
|
|
-- **完了**: 主要なUI状態 + ページ関連状態 + SSRハイドレーション + 型チェック修正 + **新規2状態（usePageControlsX, useSelectedGrant）**
|
|
|
-- **次のタスク**: モーダル状態の一括移行
|
|
|
-- **残り**: UI関連フック数個（判定必要） + モーダル18個 + クリーンアップ
|
|
|
+- **完了**: 主要なUI状態 + ページ関連状態 + SSRハイドレーション + 型チェック修正 + 新規2状態 + モーダル2個
|
|
|
+- **次のタスク**: 残り16個のモーダル状態の個別ファイル実装
|
|
|
+- **残り**: UI関連フック数個（判定必要） + モーダル16個 + クリーンアップ
|
|
|
- **推定残工数**: 1-2週間
|
|
|
|
|
|
## 🔄 更新履歴
|
|
|
|
|
|
+- **2025-09-05**: 個別モーダルファイル方式採用、重要な移行手順追加、メモリファイル統合
|
|
|
- **2025-09-05**: `usePageControlsX`と`useSelectedGrant`の移行完了、ビルド確認済み
|
|
|
- **2025-09-05**: 型チェック修正完了、ページ関連状態移行済みを確認、進捗状況を実態に合わせて更新
|
|
|
- **2025-07-30**: ドキュメント統合、進捗の実装状況反映
|
Yuki Takei