【要約】タスク管理機能を全面再設計した理由 - フラットなリストの限界 - Day 13 [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者が、マイルストーン管理を実現しようとした際に、既存のデータ構造が限界に達した。従来の設計では、以下の技術的課題に直面していた。
- ・1レコード1タスクのフラットな構造である。
- ・プロジェクトとタスクの親子関係を表現できない。
- ・単なるTODO管理の域を出ていない。
// Approach
開発者は、階層的な管理を実現するため、データ構造を3階層のチケット形式へ刷新するアプローチを採用した。具体的な手法は以下の通りである。
- ・親（プロジェクト）、子（ドメイン）、孫（タスク）の3階層を定義した。
- ・フロントエンド連携前に設計変更を行い、影響範囲を最小化した。
- ・Pythonを用いて、新構造への書き込みロジックを検証した。
- ・各階層のAPIを独立させる設計方針を固めた。
// Result
開発者は、設計変更を早期に行うことで、将来的な手戻りコストを抑制する成果を得た。今回の改修により、以下の改善が見込まれる。
- ・プロジェクト単位の期限や概要を保持できる。
- ・作業ドメインごとの管理が可能になった。
- ・細かなタスク単位での進捗管理が実現する。
- ・今後は、UUIDを用いたフロントエンドとの連携実装を進める予定である。
Senior Engineer Insight
> 設計の「手戻り」を恐れず、結合前に構造変更を決断した点は評価できる。しかし、階層化によるデータ構造の複雑化には注意が必要だ。JSONL形式での階層管理は、更新のたびにファイル全体の読み書きが発生し、I/O負荷が増大する。データ量が増大した場合、パフォーマンス劣化を招く恐れがある。実戦では、更新頻度とデータ整合性のトレードオフを慎重に検討すべきだ。