---
generated_at: 2026-02-25 01:35:00
metrics:
  claims_total: 20
  claims_with_evidence: 19
  claims_without_evidence: 1
confidence_derived: 0.95
---

# 根拠レポート：33-カードをピン留め

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.95**
  - 根拠あり：19 / 20、根拠なし：1
- 優先レビュー（高）
  1. **レスポンス時間要件**：具体的な性能要件の根拠なし
  2. **broadcast_pin_updatesの動作**：カード更新時のピントレイ同期動作を確認
  3. **ショートカットキー（Shift+P）**：ビューテンプレートで定義を確認

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

- E-01: `app/controllers/cards/pins_controller.rb` - コントローラ実装（43行）
- E-02: `app/models/card/pinnable.rb` - Pinnableモジュール実装（33行）
- E-03: `app/models/pin.rb` - Pinモデル定義（8行）
- E-04: `app/controllers/concerns/card_scoped.rb` - CardScopedコンサーン
- E-05: `app/views/cards/pins/_pin_button.html.erb` - ピン留めボタンテンプレート（14行）
- E-06: `config/routes.rb` - ルーティング定義（85行目: resource :pin）
- E-07: `db/schema.rb` - pinsテーブルスキーマ（406-416行）
- E-08: `docs/code-to-docs/機能一覧/機能一覧.csv` - 機能一覧（33行目）
- E-09: `docs/code-to-docs/画面機能マッピング/画面機能マッピング.csv` - 画面機能マッピング

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | ピン留めはPinレコードの作成で実現 | E-02（18-20行目: `pins.find_or_create_by!`） | ○ |
| C-02 | find_or_create_by!で冪等性を保証 | E-02（19行目） | ○ |
| C-03 | CardScopedでカード取得とボード設定を行う | E-04（9-15行目） | ○ |
| C-04 | accessible_cardsでアクセス権チェック | E-04（10行目） | ○ |
| C-05 | ピントレイへbroadcast_prepend_to | E-01（31-33行目） | ○ |
| C-06 | ピン留めボタンをturbo_stream.replaceで更新 | E-01（39-41行目） | ○ |
| C-07 | JSON形式では204 No Contentを返却 | E-01（15行目: `head :no_content`） | ○ |
| C-08 | UNIQUE制約（card_id, user_id） | E-07（413行目: `unique: true`） | ○ |
| C-09 | scope :orderedで作成日時降順 | E-03（6行目: `order(created_at: :desc)`） | ○ |
| C-10 | dependent: :destroyでカード削除時にピンも削除 | E-02（5行目: `has_many :pins, dependent: :destroy`） | ○ |
| C-11 | pinned_by?メソッドでピン留め状態を判定 | E-02（10-12行目） | ○ |
| C-12 | ショートカットキーShift+Pで操作可能 | E-05（5行目, 10行目: `keydown.shift+p@document`） | ○ |
| C-13 | カード詳細画面（No.19）から設定可能 | E-09（38行目: API連携として記載） | ○ |
| C-14 | ピン一覧画面（No.49）で一覧表示 | E-09（86行目） | ○ |
| C-15 | account_idはuser経由で取得 | E-03（2行目: `default: -> { user.account }`） | ○ |
| C-16 | 機能説明は「カードを個人のピン留めリストに追加」 | E-08（33行目） | ○ |
| C-17 | after_update_commit :broadcast_pin_updates | E-02（7行目） | ○ |
| C-18 | preview_changed?条件でbroadcast | E-02（7行目） | ○ |
| C-19 | レスポンス時間は200ms以内 | **根拠なし** | △ |
| C-20 | Action Cable経由でリアルタイム同期 | E-01（32行目: broadcast_prepend_to） | ○ |

## 4) 不足情報（Unknown / Missing）
- レスポンス時間要件（200ms以内）の根拠がない
  - 候補：パフォーマンステスト結果 / SLA文書 / 非機能要件定義書

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 標準的なCRUD操作とブロードキャスト処理

## 6) レビュアーチェックリスト（最小）
- [ ] find_or_create_by!の冪等性が意図通りか確認
- [ ] broadcast_prepend_toがAction Cableチャンネルに正しく送信されるか確認
- [ ] カード更新時のbroadcast_pin_updatesが正常に動作するか確認
- [ ] ショートカットキーがカード詳細画面で動作するか確認
