継続的な進化を見据えた、3年越しのレポート機能リファクタリング

freee 技術の日 2026のセッション資料です。

Transcript

2. 継続的な進化を⾒据えた3年越しの レポート機能リファクタリング 2026年10⽉3⽇ 荒⽊幹太/広澤拓
3. SMB会計PdM 荒木幹太（ arakan） 2022.4 パナソニック（株）経理 2026.1 freee 入社 2026.4 SMB会計PdM
4. アジェンダ 目次 ①背景と課題 ②リニューアルの決断 ③リニューアルの詳細
5. 背景と課題：肥⼤化‧散逸化したコードベース • • • freee開発当初から使われているレポート機能 ◦ 試算表‧⽉次推移 ⻑年の継ぎ⾜し開発により、コードベースは極度に肥⼤化‧散逸化 ◦ 機能を少し修正するだけでも影響範囲の読み解きに甚⼤な負担 レガシーな基盤が⾜かせとなり、画⾯挙動の重さによる⼆次災害も頻発
6. 背景と課題：顕在化していた2つの⼤きな課題 ①競合劣後と機能追加の限界 ②パフォーマンスの悪化 • 他社の会計ソフトには当たり前にあ る機能がfreeeには⽋けている ◦ 税込税抜切り替え ◦ タグ（補助科⽬）並び替え • 画⾯の表⽰速度や挙動の重さがユー ザー体験を著しく損ねている ◦ 本来提供すべき価値を届けら れない状態 • しかし、コードが複雑化しすぎてい たため、安易に機能を追加して改善 を図ることすら困難 • 今後も開発が続けられる最重要画⾯ の⼀つであるため、根本的な基盤の 刷新が必要不可⽋
7. リニューアルの決断 3つのPhaseに分けて⼤幅にアップデートすることを決意 ①深刻な課題となっていた表⽰速度‧パフォーマンスの抜本的な改善 ②陳腐化した基盤の刷新と現代的なデザインへの新調←今ここ！ ③刷新された基盤上へ⻑年待ち望まれていた新機能の追加←ここも対応中！
8. SMB会計PdM 広澤 拓 (taku) 2014.04 某日立系の製造業に新卒入社 2019.04 建設業向け ITスタートアップ入社 2021.12 freee 入社 現在はfreee会計レポート機能チームのリードエンジニア
9. リファクタリング〜バックエンド編〜
10. パフォーマンス改善の⼤枠 ①リファクタリング • • 複雑になった依存関係の解きほぐし 集計基盤サービスの活⽤ ②DB側の改善 • Clustered Index による会計レポート機能の パフォーマンス改善 ◦ freee 技術の⽇ 2025 にて解説
11. パフォーマンス改善の⼤枠 Controller / Serializer ①リファクタリング QueryService AggregateService 集計基盤サービス • • 複雑になった依存関係の解きほぐし 集計基盤サービスの活⽤ ・バリデーション ・行ごとの親子階層づけ ・集計結果の行変換
12. 集計基盤サービスの活⽤ 「カスタムレポート」の実現に向けて開発された基盤サービス
13. 集計基盤サービスの活⽤ 売上⾼クロス集計 (品⽬×部⾨) 補助残⾼推移 (取引先×年⽉) 「軸」を変えることで⾃在な分析が可能
14. 集計基盤サービスの活⽤ リファクタリングしたいレポートも、要は「クロス集計」 試算表（勘定科⽬×部⾨） ⽉次推移（勘定科⽬×年⽉） カスタムレポートで使った「集計基盤」と相性ヨシ
15. 集計基盤サービス 売上⾼クロス集計：「今年の」「売上⾼」を「品⽬と部⾨」で「SUM」したい 集計基盤サービス GroupedAggregateValueRepository.new( company: company, fiscal_years: [fy], grouping_elements: ['取引先 ', '品目 '], aggregate_types: ['発生額'], start_date: fy.start_date, end_date: fy.end_date, account_item_ids: [売上高 ], ).fetch_grouped_aggregate_values （相当する）SQL SELECT item_id, section_id, SUM(amount) AS sales_amount, FROM journal_lines WHERE company_id = 123 AND account_item = '売上高' AND booked_on BETWEEN … GROUP BY item_id, section_id
16. 集計基盤サービス 集計は考えることが多い！ • 検索期間に合わせて、⽉毎の集計テーブルと、取引テーブルから効率よくデータを 取る必要がある • • • ⽉毎の集計テーブルが使えない検索条件がある • • 税込経理と税抜経理では、期⾸消費税額の繰り越し⽅が違う うるう⽇始まりの会計年度や、年度をまたいだ期⾸残⾼の引き継ぎの考慮が必要 収益は貸⽅、費⽤は借⽅が正、といったレポートごとの符号⽅針を切り替える必要 がある etc etc …
17. 集計基盤サービス 集計基盤サービス 書き方 隠蔽するもの SQL GroupedAggregateValueRepository.new( company: company, fiscal_years: [fy], grouping_elements: ['取引先 ', '品目 '], aggregate_types: ['発生額'], start_date: fy.start_date, end_date: fy.end_date, account_item_ids: [売上高 ], ).fetch_grouped_aggregate_values SELECT partner_id, item_id, SUM(amount) AS sales_amount, FROM journal_lines WHERE company_id = 123 AND account_item = '売上高' AND booked_on BETWEEN … GROUP BY partner_id, item_id 検索条件ごとのデータ取得テーブルの違い 閏日の考慮 勘定科目ごとの正負反転 期の締め状態や決算整理仕訳の扱いの違い 経理方式ごとの消費税の繰り越し方の違い クエリごとの実行計画の違い テーブルの物理配置(ディスク・ページ) インデックスの選択 join の順序と方式 並行制御(ロック・MVCC) など など
18. パフォーマンス改善の⼤枠 Controller / Serializer • 複雑な集計ロジックは集計基盤サービスに ⼀任 • 上層のサービスは、本レポートのドメイン ロジックに専念できるようになった • 散逸していたクエリが集計基盤サービスに 集約されたことで、結果としてクエリの⾒ 直しも⾏われた QueryService AggregateService 集計基盤サービス 🎉複雑度の低減＆パフォーマンスの向上を達成🎉 指標 OLD NEW メソッド数 164 95 差分 -69 総循環的複雑度 334 256 -78 (-23%) ※月次推移 PL部分だけで算出 循環的複雑度は RubocopのMethodComplexity#complexity相当のロジックで計算 ・バリデーション ・行ごとの親子階層づけ ・集計結果の行変換
19. リファクタリング〜フロントエンド編〜
20. Before After
21. フロントエンド改善のモチベーション • メインはデザインの刷新 ◦ • ライブラリの活⽤ ◦ • ⼀覧性の改善、他画⾯との操作⼀貫性の担保、操作動線の改善 他画⾯‧サービスとの⼀貫性担保、サービスのコードベースの複雑性低減 仮想化の適⽤ ◦ パフォーマンスの改善
22. ライブラリの活⽤ Before(リポジトリ独⾃のコンポーネント群) • • アクセシビリティの考慮が低い 他画⾯との⼀貫性がない After(社内ライブラリの活⽤) • 階層テーブルなどの複雑なロジックをラ イブラリに⼀任 • アクセシビリティが担保されている
23. パフォーマンスの課題 • 勘定科⽬数×品⽬数の⾏がそのまま表⽰される ◦ • 仕様上ページネーションが⼊れづらい リレンダー対象が多すぎて、インタラクションに かかる時間が⻑い ※INP: ユーザーの操作（クリック・タップ・キー入力）から、 その結果が画面に描画されるまでの時間。
24. パフォーマンスの課題解決 「仮想化」を導⼊ 行DOM非表示 • • 表示 行DOM非表示 表ライブラリに導⼊されている「仮想化」機能を 有効化 ◦ スクロールに応じて、⾒えている コンポーネントだけ表⽰する リレンダー対象のコンポーネントが減ることによ り、インタラクションにかかる時間も⼤幅に低減 された
25. まとめ DB〜バックエンド〜フロントエンドの全てに⼿をいれる３年越しのリニューアルを経て、 レポート機能のパフォーマンス向上＆複雑性の低減を達成した • • バックエンド ◦ 「会計の集計」を⾼度に抽象化した基盤サービスを⽤いての、既存の コードベースをゼロから作り直すリファクタリング フロントエンド ◦ 社内ライブラリの活⽤による複雑性の低減 ◦ DOMの仮想化を⽤いて、リレンダーの総負荷を低減させることによる パフォーマンスの向上 🎉2026/09/14 リニューアル版リリース！ 🎉
26. リニューアルを振り返って • • いろいろな社内資産に助けられてのリファクタリングであった ◦ 集計基盤サービス ◦ リファクタリングで挙動が変わらないことを担保するためのDiffChecker 安全にリファクタリングをするために3年という⻑い時間をとっていただけた ◦ PMに感謝すると同時に、freeeが負債解消に時間をかけて向き合える会社だと いうことを強調したい