Skip to content

Commit 588ced7

Browse files
committed
backup: Before lucide migration (#2750)
1 parent db9aec3 commit 588ced7

File tree

2 files changed

+428
-0
lines changed

2 files changed

+428
-0
lines changed
Lines changed: 177 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,177 @@
1+
# 実行チェックリスト
2+
3+
## 📋 移行実行前の確認
4+
5+
### 準備フェーズ
6+
7+
- [ ] `plan.md` の内容をレビュー完了
8+
- [ ] 現在のブランチが正しいことを確認 (`git branch`)
9+
- [ ] 作業用ブランチを作成(推奨): `git checkout -b refactor/lucide-migration`
10+
- [ ] 最新の状態に更新: `git pull origin staging`
11+
12+
---
13+
14+
## 🔄 移行実行フェーズ
15+
16+
### ステップ 1: バックアップとコミット
17+
18+
- [ ] 現在の状態をセーブ: `git add -A && git commit -m "backup: before lucide migration"`
19+
- [ ] コミットハッシュを記録: `git log --oneline -1`
20+
21+
### ステップ 2: パッケージ置き換え
22+
23+
- [ ] 現在のバージョンを確認: `pnpm list lucide-svelte`
24+
- 記録: `lucide-svelte@______`
25+
- [ ] 古いパッケージをアンインストール: `pnpm remove lucide-svelte`
26+
- [ ] 新しいパッケージをインストール: `pnpm add @lucide/svelte`
27+
- [ ] インストール完了を確認: `pnpm list @lucide/svelte`
28+
- 記録: `@lucide/svelte@______`
29+
- [ ] `pnpm-lock.yaml` が更新されたことを確認: `git status`
30+
31+
### ステップ 3: コード修正
32+
33+
- [ ] インポート箇所を検索: `grep -r "from 'lucide-svelte" src/`
34+
- [ ] 各ファイルを修正(対象ファイル数: **\_**)
35+
- [ ] `src/routes/+page.svelte`
36+
- [ ] 修正前: `import ArrowRight from 'lucide-svelte/icons/arrow-right'`
37+
- [ ] 修正後: `import { ArrowRight } from '@lucide/svelte/icons'`
38+
- [ ] 保存完了
39+
40+
---
41+
42+
## ✅ 検証フェーズ
43+
44+
### ステップ 4: 型チェック
45+
46+
- [ ] TypeScript 型チェック実行: `pnpm check`
47+
- 結果: **\*\***\_\_\_**\*\***
48+
- [ ] エラーなし ✅
49+
- [ ] エラーあり (詳細: **\*\***\_\_\_\_**\*\***)
50+
51+
### ステップ 5: ビルド確認
52+
53+
- [ ] ビルド実行: `pnpm build`
54+
- ビルド時間: **\_**
55+
- [ ] 成功 ✅
56+
- [ ] 失敗 (エラー: **\*\***\_\_\_\_**\*\***)
57+
- [ ] ビルドレポートを確認
58+
- lucide 関連のサイズ: **\_** KB
59+
- 前回との比較: **\_** KB (削減/増加)
60+
61+
### ステップ 6: 開発サーバー確認
62+
63+
- [ ] 開発サーバー起動: `pnpm dev`
64+
- ポート: 5173
65+
- [ ] 起動成功 ✅
66+
67+
- [ ] ブラウザで画面確認
68+
- URL: http://localhost:5173
69+
- [ ] ページ表示 OK ✅
70+
- [ ] ArrowRight アイコン表示 OK ✅
71+
- [ ] コンソールエラー: なし ✅
72+
73+
- [ ] ページ操作確認
74+
- [ ] ナビゲーション動作 OK ✅
75+
- [ ] アイコンレンダリング OK ✅
76+
77+
### ステップ 7: テスト実行
78+
79+
- [ ] ユニットテスト: `pnpm test:unit`
80+
- 結果: **\*\***\_\_\_**\*\***
81+
- [ ] 全テスト成功 ✅
82+
- [ ] 失敗 (テスト: **\*\***\_\_\_\_**\*\***)
83+
84+
- [ ] E2E テスト: `pnpm test:integration`
85+
- 結果: **\*\***\_\_\_**\*\***
86+
- [ ] 全テスト成功 ✅
87+
- [ ] 失敗 (テスト: **\*\***\_\_\_\_**\*\***)
88+
89+
### ステップ 8: Lint/Format チェック
90+
91+
- [ ] Prettier チェック: `pnpm format`
92+
- [ ] 修正なし ✅
93+
- [ ] 修正あり (ファイル数: \_\_\_\_)
94+
95+
- [ ] ESLint チェック: `pnpm lint`
96+
- [ ] エラーなし ✅
97+
- [ ] エラーあり (詳細: **\*\***\_\_\_\_**\*\***)
98+
99+
---
100+
101+
## 📝 完了フェーズ
102+
103+
### ステップ 9: 変更内容の確認
104+
105+
- [ ] 差分を確認: `git diff`
106+
- 修正ファイル数: \_\_\_\_
107+
- 主要な変更:
108+
- `package.json`
109+
- `pnpm-lock.yaml`
110+
- `src/routes/+page.svelte`
111+
112+
### ステップ 10: コミット
113+
114+
- [ ] ステージング: `git add package.json pnpm-lock.yaml src/routes/+page.svelte`
115+
- [ ] コミット:
116+
```bash
117+
git commit -m "refactor: migrate lucide-svelte to @lucide/svelte for Svelte 5"
118+
```
119+
- [ ] コミット完了確認: `git log --oneline -1`
120+
121+
### ステップ 11: プッシュと PR
122+
123+
- [ ] ローカル変更完了
124+
- [ ] 全テスト成功
125+
- [ ] ビルド成功
126+
- [ ] リモートにプッシュ: `git push origin refactor/lucide-migration`
127+
- [ ] GitHub で PR を作成
128+
- [ ] PR タイトル入力
129+
- [ ] 説明文を追加(`plan.md` のリンク)
130+
- [ ] レビュアー指定
131+
132+
---
133+
134+
## 🚨 トラブルシューティング
135+
136+
### エラーが発生した場合
137+
138+
| エラー | 原因 | 対策 |
139+
| ----------------------------------------- | --------------------- | ------------------------------------- |
140+
| **`Cannot find module '@lucide/svelte'`** | インストール失敗 | `pnpm install` を再実行 |
141+
| **型定義エラー** | TypeScript キャッシュ | `pnpm dlx tsc --noEmit` で確認 |
142+
| **ビルド失敗** | 未修正インポート | `grep -r "lucide-svelte" src/` で検索 |
143+
| **テスト失敗** | キャッシュ問題 | `pnpm store prune && pnpm install` |
144+
145+
### ロールバック手順
146+
147+
エラーが解決しない場合:
148+
149+
```bash
150+
# 最後のコミットに戻す
151+
git revert HEAD
152+
153+
# または
154+
git reset --hard <backup-commit-hash>
155+
156+
# lock ファイルも復元
157+
pnpm install
158+
```
159+
160+
---
161+
162+
## 📊 記録
163+
164+
| 項目 ||
165+
| -------------------- | ------------------------ |
166+
| **開始日時** | 2025-10-25 **_:_** |
167+
| **完了日時** | 2025-10-25 **_:_** |
168+
| **所要時間** | **\_**|
169+
| **修正ファイル数** | **\_** |
170+
| **ビルドサイズ削減** | **\_** KB (**\_** %) |
171+
| **テスト成功率** | **\_** / **\_**|
172+
| **備考** | **\*\***\_\_\_\_**\*\*** |
173+
174+
---
175+
176+
**チェックリスト作成日**: 2025-10-25
177+
**バージョン**: 1.0

0 commit comments

Comments
 (0)