---
generated_at: 2026-01-29 10:30:00
metrics:
  claims_total: 85
  claims_with_evidence: 85
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：データベース設計書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：85 / 85、根拠なし：0
- 優先レビュー（高）
  - 本ドキュメントの全ての主張は `db/schema.rb` および `app/models/*.rb` から直接抽出されており、高い信頼度を有します
  - 特に優先レビューが必要な項目はありません

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。

- E-01: `db/schema.rb` - データベーススキーマ定義（Rails生成）
- E-02: `app/models/account.rb` - Accountモデル定義
- E-03: `app/models/user.rb` - Userモデル定義
- E-04: `app/models/account_user.rb` - AccountUserモデル定義
- E-05: `app/models/contact.rb` - Contactモデル定義
- E-06: `app/models/conversation.rb` - Conversationモデル定義
- E-07: `app/models/message.rb` - Messageモデル定義
- E-08: `app/models/inbox.rb` - Inboxモデル定義
- E-09: `app/models/team.rb` - Teamモデル定義
- E-10: `app/models/label.rb` - Labelモデル定義
- E-11: `app/models/webhook.rb` - Webhookモデル定義
- E-12: `app/models/campaign.rb` - Campaignモデル定義
- E-13: `app/models/notification.rb` - Notificationモデル定義
- E-14: `app/models/channel/*.rb` - 各種チャネルモデル定義
- E-15: `db/migrate/*.rb` - マイグレーションファイル群

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

### テーブル構造に関する主張

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | accountsテーブルが存在しid/name/locale/domain等のカラムを持つ | E-01, E-02 | ○ |
| C-02 | usersテーブルがDevise認証カラムを持つ | E-01, E-03 | ○ |
| C-03 | account_usersテーブルがaccountsとusersの中間テーブルである | E-01, E-04 | ○ |
| C-04 | contactsテーブルがemail/phone_number/identifier等を持つ | E-01, E-05 | ○ |
| C-05 | conversationsテーブルがstatus/priority/display_id等を持つ | E-01, E-06 | ○ |
| C-06 | messagesテーブルがcontent/message_type/sender等を持つ | E-01, E-07 | ○ |
| C-07 | inboxesテーブルがchannel_type/channel_id（ポリモーフィック）を持つ | E-01, E-08 | ○ |
| C-08 | teamsテーブルがname/description/allow_auto_assignを持つ | E-01, E-09 | ○ |
| C-09 | labelsテーブルがtitle/color/show_on_sidebarを持つ | E-01, E-10 | ○ |
| C-10 | webhooksテーブルがurl/subscriptions/webhook_typeを持つ | E-01, E-11 | ○ |
| C-11 | campaignsテーブルがtitle/message/campaign_type/display_idを持つ | E-01, E-12 | ○ |
| C-12 | notificationsテーブルがnotification_type/primary_actor（ポリモーフィック）を持つ | E-01, E-13 | ○ |
| C-13 | 12種類のチャネルテーブルが存在する | E-01, E-14 | ○ |
| C-14 | PostgreSQL拡張機能（pgcrypto, pg_trgm, vector等）を使用 | E-01 | ○ |

### 関連性に関する主張

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-15 | accountsはhas_many account_users関連を持つ | E-02 | ○ |
| C-16 | accountsはhas_many contacts関連を持つ | E-02 | ○ |
| C-17 | accountsはhas_many conversations関連を持つ | E-02 | ○ |
| C-18 | accountsはhas_many inboxes関連を持つ | E-02 | ○ |
| C-19 | accountsはhas_many teams関連を持つ | E-02 | ○ |
| C-20 | usersはhas_many account_users関連を持つ | E-03 | ○ |
| C-21 | usersはhas_many inbox_members関連を持つ | E-03 | ○ |
| C-22 | usersはhas_many team_members関連を持つ | E-03 | ○ |
| C-23 | conversationsはbelongs_to account/inbox/contact関連を持つ | E-06 | ○ |
| C-24 | conversationsはbelongs_to assignee（User）オプション関連を持つ | E-06 | ○ |
| C-25 | conversationsはbelongs_to team オプション関連を持つ | E-06 | ○ |
| C-26 | conversationsはhas_many messages関連を持つ | E-06 | ○ |
| C-27 | messagesはbelongs_to conversation関連を持つ | E-07 | ○ |
| C-28 | messagesはsender（ポリモーフィック）関連を持つ | E-07 | ○ |
| C-29 | messagesはhas_many attachments関連を持つ | E-07 | ○ |
| C-30 | inboxesはbelongs_to channel（ポリモーフィック）関連を持つ | E-08 | ○ |
| C-31 | inboxesはhas_many inbox_members関連を持つ | E-08 | ○ |
| C-32 | inboxesはhas_many conversations関連を持つ | E-08 | ○ |
| C-33 | contactsはhas_many conversations関連を持つ | E-05 | ○ |
| C-34 | contactsはbelongs_to company オプション関連を持つ | E-05 | ○ |

### enum定義に関する主張

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-35 | accounts.statusは{active: 0, suspended: 1}のenum | E-02 | ○ |
| C-36 | account_users.roleは{agent: 0, administrator: 1}のenum | E-04 | ○ |
| C-37 | account_users.availabilityは{online: 0, offline: 1, busy: 2}のenum | E-04 | ○ |
| C-38 | conversations.statusは{open: 0, resolved: 1, pending: 2, snoozed: 3}のenum | E-06 | ○ |
| C-39 | conversations.priorityは{low: 0, medium: 1, high: 2, urgent: 3}のenum | E-06 | ○ |
| C-40 | messages.message_typeは{incoming: 0, outgoing: 1, activity: 2, template: 3}のenum | E-07 | ○ |
| C-41 | messages.statusは{sent: 0, delivered: 1, read: 2, failed: 3}のenum | E-07 | ○ |
| C-42 | contacts.contact_typeは{visitor: 0, lead: 1, customer: 2}のenum | E-05 | ○ |
| C-43 | webhooks.webhook_typeは{account_type: 0, inbox_type: 1}のenum | E-11 | ○ |
| C-44 | campaigns.campaign_typeは{ongoing: 0, one_off: 1}のenum | E-12 | ○ |

### データベーストリガーに関する主張

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-45 | accounts作成時にconv_dpid_seq_{id}シーケンスが作成される | E-01, E-02 | ○ |
| C-46 | accounts作成時にcamp_dpid_seq_{id}シーケンスが作成される | E-01, E-02 | ○ |
| C-47 | conversations作成時にdisplay_idが自動採番される | E-01, E-06 | ○ |
| C-48 | campaigns作成時にdisplay_idが自動採番される | E-01, E-12 | ○ |

### インデックスに関する主張

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-49 | accountsテーブルにstatusインデックスが存在する | E-01 | ○ |
| C-50 | usersテーブルにemail/pubsub_token/uid_providerインデックスが存在する | E-01 | ○ |
| C-51 | account_usersテーブルにaccount_id_user_idユニークインデックスが存在する | E-01 | ○ |
| C-52 | contactsテーブルにemail_account_idユニークインデックスが存在する | E-01 | ○ |
| C-53 | conversationsテーブルにaccount_id_display_idユニークインデックスが存在する | E-01 | ○ |
| C-54 | conversationsテーブルにuuidユニークインデックスが存在する | E-01 | ○ |
| C-55 | messagesテーブルにcontentのGINインデックスが存在する | E-01 | ○ |
| C-56 | labelsテーブルにtitle_account_idユニークインデックスが存在する | E-01 | ○ |
| C-57 | teamsテーブルにname_account_idユニークインデックスが存在する | E-01 | ○ |

### JSONB使用に関する主張

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-58 | accounts.settingsがJSONB型である | E-01, E-02 | ○ |
| C-59 | accounts.custom_attributesがJSONB型である | E-01 | ○ |
| C-60 | accounts.limitsがJSONB型である | E-01 | ○ |
| C-61 | contacts.custom_attributesがJSONB型である | E-01 | ○ |
| C-62 | contacts.additional_attributesがJSONB型である | E-01 | ○ |
| C-63 | conversations.custom_attributesがJSONB型である | E-01 | ○ |
| C-64 | conversations.additional_attributesがJSONB型である | E-01 | ○ |
| C-65 | messages.additional_attributesがJSONB型である | E-01 | ○ |
| C-66 | automation_rules.conditions/actionsがJSONB型である | E-01 | ○ |
| C-67 | campaigns.trigger_rules/audienceがJSONB型である | E-01 | ○ |

### チャネル関連テーブルに関する主張

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-68 | channel_web_widgetsテーブルが存在する | E-01 | ○ |
| C-69 | channel_emailテーブルがIMAP/SMTP設定を持つ | E-01 | ○ |
| C-70 | channel_whatsappテーブルがmessage_templatesを持つ | E-01 | ○ |
| C-71 | channel_telegramテーブルがbot_tokenを持つ | E-01 | ○ |
| C-72 | channel_twilio_smsテーブルがaccount_sid/auth_tokenを持つ | E-01 | ○ |
| C-73 | channel_facebook_pagesテーブルがpage_id/access_tokenを持つ | E-01 | ○ |
| C-74 | channel_apiテーブルがwebhook_url/identifierを持つ | E-01 | ○ |
| C-75 | channel_lineテーブルが存在する | E-01 | ○ |
| C-76 | channel_instagramテーブルが存在する | E-01 | ○ |
| C-77 | channel_tiktokテーブルが存在する | E-01 | ○ |
| C-78 | channel_voiceテーブルが存在する | E-01 | ○ |

### Captain（AI機能）関連に関する主張

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-79 | captain_assistantsテーブルが存在する | E-01 | ○ |
| C-80 | captain_assistant_responsesテーブルがembedding（vector）を持つ | E-01 | ○ |
| C-81 | captain_documentsテーブルが存在する | E-01 | ○ |
| C-82 | captain_inboxesテーブルが存在する | E-01 | ○ |
| C-83 | captain_scenariosテーブルが存在する | E-01 | ○ |
| C-84 | copilot_threads/copilot_messagesテーブルが存在する | E-01 | ○ |
| C-85 | article_embeddingsテーブルがembedding（vector 1536次元）を持つ | E-01 | ○ |

## 4) 不足情報（Unknown / Missing）
- 本ドキュメントの作成にあたり、根拠不足の主張はありません
- 全てのテーブル定義は `db/schema.rb` から直接抽出されています
- 関連性定義は各モデルファイルから直接抽出されています

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**: 全ての主張がソースコードから直接抽出されており、信頼性が高い
- 注意点：
  - `db/schema.rb` はRailsが自動生成するファイルであり、信頼性が高い
  - モデルファイルの関連定義もActiveRecordの標準的な記述方法に従っている
  - Enterprise版固有のテーブル・カラムがある可能性（`enterprise/` ディレクトリ内は未調査）

## 6) レビュアーチェックリスト（最小）
- [ ] テーブル一覧が実際のデータベースと一致しているか確認
- [ ] 主要なカラムの説明が業務要件と合致しているか確認
- [ ] ER図の関連性が実際のモデル定義と一致しているか確認
- [ ] Enterprise版固有のテーブル・カラムを追加調査するか検討
- [ ] 本番環境固有の設定（インデックス追加等）の確認
