active: true
derived: false
groups:
- MAINT
header: |
  MaintenanceService テスト
level: '2.20'
links:
- SPEC020: NTlW5X3cj5UrQb-SH3YhZG10AwptJvDUc3aUW4rIvWQ=
normative: true
ref: ''
references:
- path: tests/unit/test_maintenance.py
  type: file
reviewed: OMkpxV0fD--iQVf9SreOvIQt38sX9ldGWXd4enjK-oo=
text: |
  ## 目的

  `MaintenanceService` は CLI やダッシュボードからのシステム管理操作を仲介するサービス層である。タスク詳細の表示ミスは運用者の誤判断を招き、メンテナンス操作の不備はデータの意図しない削除に繋がる。

  ## 検証観点

  - **タスク詳細取得**: 存在するタスクIDに対して正しいメタデータ（func_name, input_key, result, created_at 等）が返却されること
  - **存在しないタスク**: 不在のタスクIDに対して `None` が返却され、例外が送出されないこと
  - **統計情報**: キャッシュの件数、サイズ、関数ごとの分布など統計情報が正確に算出されること
  - **クリア操作**: 指定条件に合致するタスクのみが削除され、他のタスクが影響を受けないこと
  - **GC 操作**: 有効期限切れタスクの削除と孤立Blobファイルのクリーンアップが正しく連動すること
