個人開発 » Ferrhythm

実装に着手しました。

• ブランチ: feature/352-db
• 対応方針: SQLite(rusqlite/bundled/WAL) を継続採用。(path,size,mtime,hash) による差分スキャン＋rayon 並列パースで再スキャンの大半を stat() のみに抑え、20 分問題の核心（全曲再パース）を回避する。ノーツレーダー等の解析計算は本チケットでは格納列(nullable)のみ用意し、計算実装は別チケットへ委譲。

本チケットのスコープ: スキーマ/マイグレーション・楽曲/スコア/フォルダの CRUD・差分スキャン(rayon)・プルーニング。コンテナで TDD(SQLite は Linux 動作)。

実装完了・MR マージ済み。

• MR: !8（feature/352-db → develop、merge commit dccf8cb）

実装概要¶

楽曲/スコア DB クレート ferrhythm-db を新規追加。SQLite（rusqlite bundled / WAL / synchronous=NORMAL）を採用し、rayon による差分並列スキャンで beatoraja の「全曲更新で20分」問題（全曲再パース）を回避。

確定方針（ユーザー確認済み）¶

• SQLite 継続採用（KV 不採用）。遅さは DB 起因ではなく全曲再パースが原因 → 差分スキャンで解決。
• 本チケットは差分基盤＋格納列のみ。ノーツレーダー等の解析計算は #366 に分離。

主な実装¶

• スキーマ（user_version マイグレーション）: folders / songs / scores / song_analysis の4テーブル。
• songs にレーダー6主軸（radar_notes/peak/scratch/soflan/charge/chord、beatoraja PlayerNotesRadarAxis 準拠）を nullable 列で先行用意。
• サブ軸テーブル song_analysis（beatoraja information 相当: n/ln/s/ls・density/peak/end・total・mainbpm・distribution/speedchange/lanenotes）を先行作成。レーダー/解析値は全て NULL（計算は #366）。
• 差分スキャン: (path, size, mtime) 一致なら stat のみでパースしない。変更/新規のみ rayon 並列パース→単一トランザクション書込→消失分プルーニング。root 配下判定は Path::starts_with。
• CRUD（songs/folders/scores/analysis）、ESCAPE 付き LIKE タイトル検索、optional serde。

レビューで修正した点¶

• [Major] プルーニングの SQL LIKE 'prefix%' 境界バグ（/songs が /songs_old に誤一致し別 root の曲を誤削除＝データ消失＋_/% 未エスケープ）を Path::starts_with 方式へ修正、回帰テスト追加。
• [Minor] タイトル検索 LIKE の ESCAPE 化、レーダー6軸を beatoraja 準拠にリネーム。

テスト（DevContainer / Linux）¶

• cargo test --workspace --all-features: 成功（ferrhythm-db 35件含む全グリーン）
• cargo clippy --workspace --all-targets --all-features: 警告ゼロ
• cargo fmt --all -- --check: クリーン

残課題（別途）¶

• ノーツレーダー/サブ軸の値算出 → #366。
• judge_rank/key_mode の安定文字表現（Display/FromStr 化）、folders.parent_id のネスト構築は将来対応。