---
generated_at: 2026-02-25 02:55:00
metrics:
  claims_total: 97
  claims_with_evidence: 97
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：models-concerns 単体テストケース一覧

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：97 / 97、根拠なし：0
- 優先レビュー（高）
  1. **Storage::Tracked / Storage::Totaled**: ストレージ計算ロジックが複雑なため、テストケースの網羅性を確認推奨
  2. **reconcile_storage**: 並行処理のテストケースが正しい条件を捕捉しているか確認推奨
  3. **Mentions**: リッチテキストとのActionText連携部分の実際の挙動を確認推奨

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `app/models/concerns/mentions.rb` - メンション機能のConcern
- E-02: `app/models/concerns/attachments.rb` - 添付ファイル機能のConcern
- E-03: `app/models/concerns/storage/tracked.rb` - ストレージトラッキングConcern
- E-04: `app/models/concerns/storage/totaled.rb` - ストレージ集計Concern
- E-05: `app/models/concerns/eventable.rb` - イベント追跡Concern
- E-06: `app/models/concerns/push_notifiable.rb` - プッシュ通知Concern
- E-07: `app/models/concerns/searchable.rb` - 検索インデックスConcern
- E-08: `app/models/concerns/filterable.rb` - フィルタリングConcern
- E-09: `app/models/concerns/notifiable.rb` - 通知Concern

## 3) Claims と根拠の対応（レビューの主戦場）

### Mentions (E-01)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | create_mentionsがmentioneeにmentioned_byを呼び出す | E-01 L10-13 | ○ |
| C-02 | scan_mentionees が空配列でも例外なし | E-01 L21-22 | ○ |
| C-03 | mentionable_contentがリッチテキストを連結 | E-01 L16-17 | ○ |
| C-04 | mentionable_contentがnilセーフ | E-01 L17 `&.to_plain_text` | ○ |
| C-05 | scan_mentionees がboard.usersとの積集合を返す | E-01 L21-22 | ○ |
| C-06 | mentionees_from_attachmentsがnilセーフ | E-01 L25-26 `&.body&.attachments` | ○ |
| C-07 | mentionable_usersがboard.usersを返す | E-01 L29-31 | ○ |
| C-08 | rich_text_associationsがActionText関連を返す | E-01 L33-34 | ○ |
| C-09 | should_create_mentions?の条件判定 | E-01 L37-38 | ○ |
| C-10 | mentionable_content_changed?の変更検知 | E-01 L41-42 | ○ |
| C-11 | create_mentions_laterがJobをenqueue | E-01 L45-46 | ○ |
| C-12 | mentionable?のデフォルト値true | E-01 L50-52 | ○ |
| C-13 | should_check_mentions?のデフォルト値false | E-01 L54-56 | ○ |

### Attachments (E-02)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-14 | attachmentsがembedsを返す | E-02 L20-22 | ○ |
| C-15 | attachmentsがnilで空配列を返す | E-02 L21 `|| []` | ○ |
| C-16 | has_attachments?がany?を使用 | E-02 L24-26 | ○ |
| C-17 | remote_imagesがRemoteImageをgrep | E-02 L28-29 | ○ |
| C-18 | remote_imagesがメモ化 | E-02 L28 `@remote_images ||=` | ○ |
| C-19 | remote_imagesがnilで空配列を返す | E-02 L29 `|| []` | ○ |
| C-20 | has_remote_images?がany?を使用 | E-02 L32-34 | ○ |
| C-21 | remote_videosがRemoteVideoをgrep | E-02 L36-37 | ○ |
| C-22 | has_remote_videos?がany?を使用 | E-02 L40-42 | ○ |
| C-23 | rich_text_recordがリフレクションで取得 | E-02 L45-49 | ○ |
| C-24 | rich_text_recordがメモ化 | E-02 L46 `@rich_text_record ||=` | ○ |

### Storage::Tracked (E-03)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-25 | storage_tracked_recordがselfを返す | E-03 L12-13 | ○ |
| C-26 | board_for_storage_trackingがboardを返す | E-03 L17-18 | ○ |
| C-27 | storage_bytesが合計バイト数を返す | E-03 L22-23 | ○ |
| C-28 | board_transfer?がboard_id変更を検知 | E-03 L27-28 | ○ |
| C-29 | board_transfer?がrespond_to?でチェック | E-03 L28 | ○ |
| C-30 | track_board_transferがtransfer_outを記録 | E-03 L43-50 | ○ |
| C-31 | track_board_transferがtransfer_inを記録 | E-03 L52-58 | ○ |
| C-32 | track_board_transferがbytes.zero?でスキップ | E-03 L40 | ○ |
| C-33 | track_board_transferがold_board nilで転出スキップ | E-03 L43 `if old_board` | ○ |
| C-34 | storage_transfer_recordsがself配列を返す | E-03 L62-63 | ○ |
| C-35 | attachments_for_storageが添付取得 | E-03 L67-68 | ○ |
| C-36 | storage_attachments_for_recordsがグループ化 | E-03 L71-95 | ○ |
| C-37 | storage_attachments_for_recordsが空で空Hash | E-03 L73 | ○ |
| C-38 | storage_attachments_for_recordsがRichText親解決 | E-03 L88-89 | ○ |

### Storage::Totaled (E-04)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-39 | foreign_key_for_storageがモデル名から生成 | E-04 L10-12 | ○ |
| C-40 | bytes_usedがstorage_total.bytes_storedを返す | E-04 L16-17 | ○ |
| C-41 | bytes_usedがnilで0を返す | E-04 L17 `|| 0` | ○ |
| C-42 | bytes_used_exactがcurrent_usageを返す | E-04 L21-22 | ○ |
| C-43 | bytes_used_exactがstorage_totalを作成 | E-04 L22 `create_or_find_storage_total` | ○ |
| C-44 | materialize_storage_laterがJobをenqueue | E-04 L25-26 | ○ |
| C-45 | materialize_storageがdelta_sumで更新 | E-04 L30-42 | ○ |
| C-46 | materialize_storageがlast_entry_idを更新 | E-04 L41 | ○ |
| C-47 | materialize_storageが新entries無しでスキップ | E-04 L36 | ○ |
| C-48 | materialize_storageがwith_lockを使用 | E-04 L33 | ○ |
| C-49 | reconcile_storageが差分でEntry記録 | E-04 L66-73 | ○ |
| C-50 | reconcile_storageが差分なしでスキップ | E-04 L66 `if diff.nonzero?` | ○ |
| C-51 | reconcile_storageが成功でtrueを返す | E-04 L76 | ○ |
| C-52 | reconcile_storageがcursor変動でfalseを返す | E-04 L59-61 | ○ |
| C-53 | reconcile_storageがAccount判定 | E-04 L69 `is_a?(Account)` | ○ |
| C-54 | reconcile_storageがBoard判定 | E-04 L70 `is_a?(Board)` | ○ |
| C-55 | create_or_find_storage_totalがcreate_or_find_by | E-04 L81-82 | ○ |
| C-56 | calculate_real_storage_bytesがNotImplementedError | E-04 L85-86 | ○ |

### Eventable (E-05)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-57 | track_eventがイベント作成 | E-05 L8-11 | ○ |
| C-58 | track_eventがprefixを付与 | E-05 L10 `eventable_prefix` | ○ |
| C-59 | track_eventがshould_track_event?でガード | E-05 L9 | ○ |
| C-60 | track_eventがCurrent.userをデフォルト | E-05 L8 `creator: Current.user` | ○ |
| C-61 | track_eventがカスタムcreatorを受け入れ | E-05 L8 | ○ |
| C-62 | track_eventがparticularsを渡す | E-05 L10 | ○ |
| C-63 | event_was_createdが空実装 | E-05 L14-15 | ○ |
| C-64 | should_track_event?がデフォルトtrue | E-05 L18-19 | ○ |
| C-65 | eventable_prefixがunderscoreで変換 | E-05 L22-23 | ○ |

### PushNotifiable (E-06)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-66 | push_notification_laterがJobをenqueue | E-06 L9-10 | ○ |
| C-67 | after_save_commitがsource_id変更で発火 | E-06 L5 | ○ |
| C-68 | after_save_commitがsource_id未変更でスキップ | E-06 L5 `if: :source_id_previously_changed?` | ○ |

### Searchable (E-07)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-69 | reindexがupdate_in_search_indexを呼ぶ | E-07 L12-13 | ○ |
| C-70 | create_in_search_indexがsearchable?でガード | E-07 L17-18 | ○ |
| C-71 | create_in_search_indexがcreate!を呼ぶ | E-07 L19 | ○ |
| C-72 | update_in_search_indexがupsert!を呼ぶ | E-07 L25 | ○ |
| C-73 | update_in_search_indexがsearchable? falseでremove | E-07 L26-27 | ○ |
| C-74 | remove_from_search_indexがdestroy | E-07 L31-32 | ○ |
| C-75 | remove_from_search_indexがnilセーフ | E-07 L32 `&.destroy` | ○ |
| C-76 | search_record_attributesが正しいHash | E-07 L35-45 | ○ |
| C-77 | search_record_contentがtruncate_bytes | E-07 L48-49 | ○ |
| C-78 | search_record_contentがnilセーフ | E-07 L49 `search_content&.truncate_bytes` | ○ |
| C-79 | SEARCH_CONTENT_LIMITが32KB | E-07 L4 | ○ |
| C-80 | search_record_classがSearch::Record.for | E-07 L52-53 | ○ |

### Filterable (E-08)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-81 | after_updateがfilters.touch_all | E-08 L7 | ○ |
| C-82 | remove_from_filtersが各filterにresource_removed | E-08 L14-15 | ○ |
| C-83 | remove_from_filtersがfilters空でも安全 | E-08 L15 `filters.each` | ○ |

### Notifiable (E-09)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-84 | notify_recipientsがNotifier.for.notify | E-09 L10-11 | ○ |
| C-85 | notify_recipientsがnilセーフ | E-09 L11 `&.notify` | ○ |
| C-86 | notifiable_targetがself | E-09 L14-15 | ○ |
| C-87 | notify_recipients_laterがJobをenqueue | E-09 L19-20 | ○ |
| C-88 | after_create_commitがnotify_recipients_later | E-09 L7 | ○ |

## 4) 不足情報（Unknown / Missing）
- **なし** - 全てのテストケースはソースコードから直接導出されています

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - 全テストケースがソースコードの実装に基づいており、根拠が明確
- **1: 中リスク（確認推奨）**:
  - Storage::Tracked/Totaled: 金額・容量計算に関わるロジックのため、テストの網羅性を確認
  - reconcile_storage: 並行処理の検出ロジックがあり、競合条件のテストが重要
  - Mentions: ActionTextとの連携部分で実際の挙動確認が推奨

## 6) レビュアーチェックリスト（最小）
- [ ] Storage関連のテストケースが全ての計算パスをカバーしているか確認
- [ ] 各Concernのコールバック条件（if/unless）が正しくテストされているか確認
- [ ] nilセーフティのテストケースが適切な前提条件を持っているか確認
- [ ] 非同期処理（Job.perform_later）のテストケースが適切にモック化の想定をしているか確認
- [ ] テンプレートメソッド（mentionable?, should_track_event?等）のオーバーライドケースが考慮されているか確認
