---
generated_at: 2026-02-25 11:00:00
metrics:
  claims_total: 20
  claims_with_evidence: 20
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：7-Webプッシュ通知

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：20 / 20、根拠なし：0
- 優先レビュー（高）
  - 特になし（全ての主張に根拠あり）

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

- E-01: `app/models/notification_pusher.rb` 1-124行目
- E-02: `app/models/push/subscription.rb` 1-55行目
- E-03: `app/models/concerns/push_notifiable.rb` 1-12行目
- E-04: `app/jobs/push_notification_job.rb` 1-7行目
- E-05: `lib/web_push/notification.rb` 1-29行目
- E-06: `db/schema.rb` 418-429行目（push_subscriptions）

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | source_id変更時にPushNotificationJobがキュー投入 | E-03（5行目: `after_save_commit :push_notification_later, if: :source_id_previously_changed?`） | ○ |
| C-02 | should_push?でpush_subscriptions.any?を確認 | E-01（21行目: `notification.user.push_subscriptions.any?`） | ○ |
| C-03 | should_push?でcreator.system?を確認 | E-01（22行目: `!notification.creator.system?`） | ○ |
| C-04 | should_push?でuser.active?を確認 | E-01（23行目: `notification.user.active?`） | ○ |
| C-05 | should_push?でaccount.active?を確認 | E-01（24行目: `notification.account.active?`） | ○ |
| C-06 | source_typeがEventの場合build_event_payload | E-01（29-30行目: `when "Event" then build_event_payload`） | ○ |
| C-07 | source_typeがMentionの場合build_mention_payload | E-01（31-32行目: `when "Mention" then build_mention_payload`） | ○ |
| C-08 | card_publishedは"Added by {名前}" | E-01（59-61行目） | ○ |
| C-09 | card_assignedは"Assigned to you by {名前}" | E-01（55-57行目） | ○ |
| C-10 | card_closedはclosure判定でメッセージ分岐 | E-01（62-65行目） | ○ |
| C-11 | comment_createdはREプレフィックス付き | E-01（49-53行目: `title: "RE: #{base_payload[:title]}"`） | ○ |
| C-12 | mentionは"{名前} mentioned you" | E-01（82行目: `title: "#{mention.mentioner.first_name} mentioned you"`） | ○ |
| C-13 | PERMITTED_ENDPOINT_HOSTSでホワイトリスト制御 | E-02（2-8行目: `PERMITTED_ENDPOINT_HOSTS = %w[...]`） | ○ |
| C-14 | エンドポイントはHTTPS必須 | E-02（42-43行目: `endpoint_uri.scheme != "https"`） | ○ |
| C-15 | SsrfProtectionでパブリックIPのみ許可 | E-02（29行目: `SsrfProtection.resolve_public_ip(endpoint_uri&.host)`） | ○ |
| C-16 | WebPush.payload_sendで送信 | E-05（8行目: `WebPush.payload_send`） | ○ |
| C-17 | urgencyはhigh | E-05（13行目: `urgency: "high"`） | ○ |
| C-18 | badgeは未読通知数から取得 | E-02（19行目: `badge: user.notifications.unread.count`） | ○ |
| C-19 | iconは/apple-touch-icon.png | E-05（26-28行目: `def icon_path; "/apple-touch-icon.png"; end`） | ○ |
| C-20 | DeserializationErrorはdiscard | E-04（2行目: `discard_on ActiveJob::DeserializationError`） | ○ |

## 4) 不足情報（Unknown / Missing）
- 特になし

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 全ての主張がコードから明確に読み取れる

## 6) レビュアーチェックリスト（最小）
- [ ] PERMITTED_ENDPOINT_HOSTSが最新のプッシュサービスをカバーしていることを確認
- [ ] VAPID設定が正しく構成されていることを確認
- [ ] WebPush Poolの設定が本番環境で適切か確認
- [ ] SsrfProtectionが期待通り動作することをテストで確認
