---
generated_at: 2026-02-24 10:30:00
metrics:
  claims_total: 125
  claims_with_evidence: 118
  claims_without_evidence: 7
confidence_derived: 0.94
---

# 根拠レポート：index モジュール単体テストケース一覧

## 本レポートについて

### 目的
本レポートは、生成された単体テストケース一覧の信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.94**
  - 根拠あり：118 / 125、根拠なし：7
- 優先レビュー（高）
  1. **UT-IDX-116 gqlSchemaToTypes**：ファイルシステム操作の実装詳細が未確認
  2. **UT-IDX-117 buildEntryPointsTypeMap**：joinerConfigsの動的取得ロジックの検証が必要
  3. **継承確認テストケース（UT-IDX-118-121）**：MedusaInternalServiceの継承動作の詳細確認が必要

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

- E-01: `packages/modules/index/src/services/index-module-service.ts` - IndexModuleServiceクラスの実装
- E-02: `packages/modules/index/src/services/data-synchronizer.ts` - DataSynchronizerクラスの実装
- E-03: `packages/modules/index/src/services/postgres-provider.ts` - PostgresProviderクラスの実装
- E-04: `packages/modules/index/src/services/index-data.ts` - IndexDataServiceクラスの定義
- E-05: `packages/modules/index/src/services/index-relation.ts` - IndexRelationServiceクラスの定義
- E-06: `packages/modules/index/src/services/index-sync.ts` - IndexSyncServiceクラスの定義
- E-07: `packages/modules/index/src/services/index-metadata.ts` - IndexMetadataServiceクラスの定義
- E-08: `packages/modules/index/src/utils/query-builder.ts` - QueryBuilderクラスとヘルパー関数の実装
- E-09: `packages/modules/index/src/utils/build-config.ts` - buildSchemaObjectRepresentation関数の実装
- E-10: `packages/modules/index/src/utils/flatten-object-keys.ts` - flattenObjectKeys関数の実装
- E-11: `packages/modules/index/src/utils/normalize-fields-selection.ts` - normalizeFieldsSelection関数の実装
- E-12: `packages/modules/index/src/utils/sync/orchestrator.ts` - Orchestratorクラスの実装
- E-13: `packages/modules/index/src/utils/sync/configuration.ts` - Configurationクラスの実装
- E-14: `packages/modules/index/src/utils/create-partitions.ts` - createPartitions関数の実装
- E-15: `packages/modules/index/src/utils/normalze-table-name.ts` - normalizeTableName, getPivotTableName関数の実装
- E-16: `packages/modules/index/src/utils/index-metadata-status.ts` - IndexMetadataStatus列挙型の定義
- E-17: `packages/modules/index/src/utils/gql-to-types.ts` - gqlSchemaToTypes関数の実装
- E-18: `packages/modules/index/src/models/index-data.ts` - IndexDataモデルの定義
- E-19: `packages/modules/index/src/models/index-relation.ts` - IndexRelationモデルの定義
- E-20: `packages/modules/index/src/models/index-sync.ts` - IndexSyncモデルの定義
- E-21: `packages/modules/index/src/models/index-metadata.ts` - IndexMetadataモデルの定義
- E-22: `packages/modules/index/src/utils/__tests__/build-config.spec.ts` - buildSchemaObjectRepresentationの既存テスト
- E-23: `packages/modules/index/src/utils/__tests__/flatten-object-keys.spec.ts` - flattenObjectKeysの既存テスト
- E-24: `packages/modules/index/src/utils/__tests__/normalize-fields-selcetion.spec.ts` - normalizeFieldsSelectionの既存テスト
- E-25: `packages/modules/index/src/types/index.ts` - 型定義ファイル

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

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | IndexModuleService.constructorは依存関係を正しく注入する | E-01 (L102-131) | ○ |
| C-02 | EventBusModuleServiceが未登録の場合エラーがスローされる | E-01 (L126-130) | ○ |
| C-03 | onApplicationStart_でスキーマが構築される | E-01 (L139-187) | ○ |
| C-04 | ワーカーモードでデータ同期が開始される | E-01 (L164-183) | ○ |
| C-05 | サーバーモードではデータ同期が開始されない | E-01 (L164) | ○ |
| C-06 | queryメソッドがstorageProviderに委譲する | E-01 (L189-193) | ○ |
| C-07 | getInfoがIndexMetadataとIndexSyncからデータを取得する | E-01 (L269-306) | ○ |
| C-08 | syncメソッドがstrategyに応じて適切なメソッドを呼ぶ | E-01 (L308-326) | ○ |
| C-09 | 無効なstrategyでエラーがスローされる | E-01 (L309-313) | ○ |
| C-10 | registerListenersがイベントを購読する | E-01 (L195-230) | ○ |
| C-11 | DataSynchronizer.constructorがコンテナを保持する | E-02 (L56-58) | ○ |
| C-12 | onApplicationStartで初期化フラグが設定される | E-02 (L68-80) | ○ |
| C-13 | syncEntitiesがOrchestratorを使用して処理する | E-02 (L82-97) | ○ |
| C-14 | 初期化前のsyncEntitiesでエラーがスローされる | E-02 (L60-66) | ○ |
| C-15 | removeEntitiesがDELETE SQLを実行する | E-02 (L99-117) | ○ |
| C-16 | syncEntityがエンティティを同期する | E-02 (L217-350) | ○ |
| C-17 | PostgresProvider.constructorが依存関係を設定する | E-03 (L56-71) | ○ |
| C-18 | onApplicationStartがパーティションを作成する | E-03 (L73-87) | ○ |
| C-19 | queryメソッドがQueryBuilderを使用する | E-03 (L233-313) | ○ |
| C-20 | consumeEventがイベントアクションに応じたメソッドを呼ぶ | E-03 (L169-231) | ○ |
| C-21 | onCreateがupsertManyを呼ぶ | E-03 (L323-438) | ○ |
| C-22 | onUpdateがupsertManyを呼ぶ | E-03 (L448-489) | ○ |
| C-23 | onDeleteがnativeDeleteを呼ぶ | E-03 (L499-542) | ○ |
| C-24 | onAttachがリンクエンティティを処理する | E-03 (L551-680) | ○ |
| C-25 | onDetachがリンクエンティティを削除する | E-03 (L690-733) | ○ |
| C-26 | parseDataがデータを正しく解析する | E-03 (L89-133) | ○ |
| C-27 | parseMessageDataがメッセージを解析する | E-03 (L135-167) | ○ |
| C-28 | QueryBuilder.constructorが初期化を行う | E-08 (L88-112) | ○ |
| C-29 | buildQueryがSQL文字列を生成する | E-08 (L828-1055) | ○ |
| C-30 | buildObjectFromResultsetが結果を変換する | E-08 (L1057-1204) | ○ |
| C-31 | parseWhereがWHERE句を構築する | E-08 (L245-535) | ○ |
| C-32 | 各種演算子が正しく処理される | E-08 (L58-70, L245-535) | ○ |
| C-33 | escapeJsonPathStringがエスケープ処理を行う | E-08 (L16-19) | ○ |
| C-34 | buildSafeJsonPathQueryがJSONパスクエリを構築する | E-08 (L21-56) | ○ |
| C-35 | buildSchemaObjectRepresentationがスキーマを構築する | E-09 (L1242-1293) | ○ |
| C-36 | makeSchemaExecutableが実行可能スキーマを生成する | E-09 (L28-38) | ○ |
| C-37 | flattenObjectKeysがオブジェクトをフラット化する | E-10, E-23 | ○ |
| C-38 | normalizeFieldsSelectionがフィールドを正規化する | E-11, E-24 | ○ |
| C-39 | Orchestrator.constructorが初期化を行う | E-12 (L77-89) | ○ |
| C-40 | Orchestrator.processがエンティティを処理する | E-12 (L157-176) | ○ |
| C-41 | Orchestrator.renewLockがロックを更新する | E-12 (L109-111) | ○ |
| C-42 | Configuration.constructorが初期化を行う | E-13 (L17-35) | ○ |
| C-43 | Configuration.checkChangesが変更を検出する | E-13 (L37-156) | ○ |
| C-44 | createPartitionsがパーティションを作成する | E-14 (L6-116) | ○ |
| C-45 | normalizeTableNameがテーブル名を正規化する | E-15 (L3-5) | ○ |
| C-46 | getPivotTableNameがピボットテーブル名を生成する | E-15 (L7-10) | ○ |
| C-47 | IndexMetadataStatusが4つの状態を定義する | E-16 (L1-6) | ○ |
| C-48 | gqlSchemaToTypesが型定義ファイルを生成する | E-17 (L10-48) | △ |
| C-49 | buildEntryPointsTypeMapがマップを構築する | E-17 (L50-84) | △ |
| C-50 | IndexDataServiceがMedusaInternalServiceを継承する | E-04 (L1-4) | ○ |
| C-51 | IndexRelationServiceがMedusaInternalServiceを継承する | E-05 (L1-6) | ○ |
| C-52 | IndexSyncServiceがMedusaInternalServiceを継承する | E-06 (L1-4) | ○ |
| C-53 | IndexMetadataServiceがMedusaInternalServiceを継承する | E-07 (L1-6) | ○ |
| C-54 | IndexDataモデルが正しく定義されている | E-18 (L1-11) | ○ |
| C-55 | IndexRelationモデルが正しく定義されている | E-19 (L1-13) | ○ |
| C-56 | IndexSyncモデルが正しく定義されている | E-20 (L1-17) | ○ |
| C-57 | IndexMetadataモデルが正しく定義されている | E-21 (L1-22) | ○ |
| C-58 | 既存テストがbuildSchemaObjectRepresentationをカバー | E-22 | ○ |
| C-59 | 既存テストがflattenObjectKeysをカバー | E-23 | ○ |
| C-60 | 既存テストがnormalizeFieldsSelectionをカバー | E-24 | ○ |

## 4) 不足情報（Unknown / Missing）

- **gqlSchemaToTypes関数（UT-IDX-116）**：ファイルシステム操作の具体的な挙動確認が不足
  - 候補：実際のファイル生成テスト / モック環境でのファイル操作テスト
- **buildEntryPointsTypeMap関数（UT-IDX-117）**：MedusaModule.getAllJoinerConfigs()の動的な振る舞いの検証が不足
  - 候補：より多くのjoinerConfig設定パターンでのテスト
- **MedusaInternalService継承テスト（UT-IDX-118-121）**：継承されたメソッドの具体的な動作確認が必要
  - 候補：list, create, update, deleteメソッドの統合テスト
- **エラーハンドリングの一部**：一部の異常系シナリオで詳細なエラーメッセージの検証が不足
  - 候補：エラーメッセージの内容検証を追加
- **トランザクション処理**：@InjectTransactionManagerデコレータの動作検証が限定的
  - 候補：トランザクションロールバックシナリオのテスト追加

## 5) リスクフラグ（レビュー観点）

| リスクレベル | 項目 | 説明 |
|---|---|---|
| 1: 中リスク | ファイルシステム操作 | gqlSchemaToTypesのファイル生成処理は外部依存があるため、モック環境での検証が推奨 |
| 1: 中リスク | データベース操作 | createPartitions等のDDL操作は実環境での検証が必要 |
| 0: 低リスク | 列挙型・モデル定義 | 静的な定義であり、変更リスクは低い |
| 0: 低リスク | ユーティリティ関数 | 純粋関数であり、既存テストでカバーされている |

## 6) レビュアーチェックリスト（最小）

- [ ] IndexModuleServiceのコンストラクタでEventBusModuleServiceの必須チェックが適切か
- [ ] sync戦略（full/reset/continue）の動作が設計通りか
- [ ] DataSynchronizerの初期化チェックが全てのpublicメソッドで行われているか
- [ ] PostgresProviderの各イベントハンドラ（onCreate, onUpdate, onDelete, onAttach, onDetach）のデータ整合性
- [ ] QueryBuilderの演算子処理（$and, $or, $not, $in, $like等）が正しく実装されているか
- [ ] Orchestratorのロック取得・解放処理がデッドロックを起こさないか
- [ ] Configurationのハッシュ変更検出ロジックが正しいか
- [ ] パーティション作成時のスキーマ名処理が正しいか
