---
generated_at: 2026-01-29 22:20:00
metrics:
  claims_total: 166
  claims_with_evidence: 166
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：machine.csv

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：166 / 166、根拠なし：0
- 優先レビュー（高）
  1. **レジストリ連携テスト（UT-MCH-002〜004, 022）**：モデルのsave/deleteとレジストリの連携
  2. **初期化エラー処理（UT-MCH-039, 040, 050, 051）**：ドライバー未発見・互換性エラー・設定不足
  3. **call_machine_function（UT-MCH-112〜116）**：マシン関数呼び出しの各種エラーケース

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

- E-01: `/Users/tomoka.baba/Work/InvenTree-master/src/backend/InvenTree/machine/models.py`
- E-02: `/Users/tomoka.baba/Work/InvenTree-master/src/backend/InvenTree/machine/machine_type.py`
- E-03: `/Users/tomoka.baba/Work/InvenTree-master/src/backend/InvenTree/machine/registry.py`
- E-04: `/Users/tomoka.baba/Work/InvenTree-master/src/backend/InvenTree/machine/serializers.py`
- E-05: `/Users/tomoka.baba/Work/InvenTree-master/src/backend/InvenTree/machine/api.py`
- E-06: `/Users/tomoka.baba/Work/InvenTree-master/src/backend/InvenTree/machine/tasks.py`
- E-07: `/Users/tomoka.baba/Work/InvenTree-master/src/backend/InvenTree/machine/machine_types/label_printer.py`

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

### MachineConfig モデル（UT-MCH-001〜020）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | MachineConfig.__str__がnameを返す | E-01 L43-45 | ○ |
| C-02 | save時に新規作成でregistry.add_machineが呼ばれる | E-01 L47-63 | ○ |
| C-03 | save時に更新でregistry.update_machineが呼ばれる | E-01 L47-68 | ○ |
| C-04 | delete時にregistry.remove_machineが呼ばれる | E-01 L70-75 | ○ |
| C-05 | to_dictがフィールドとsettingsを含むdictを返す | E-01 L77-84 | ○ |
| C-06 | machineプロパティがregistry.get_machineを呼ぶ | E-01 L86-89 | ○ |
| C-07 | errorsプロパティがmachine.errorsを返す | E-01 L91-94 | ○ |
| C-08 | is_driver_availableがmachineとdriverの存在をチェック | E-01 L96-99 | ○ |
| C-09 | no_errorsがerrors長をチェック | E-01 L101-104 | ○ |
| C-10 | initializedがmachine.initializedを返す | E-01 L106-109 | ○ |
| C-11 | get_admin_errorsがHTML形式でエラーを返す | E-01 L111-116 | ○ |
| C-12 | get_machine_statusがHTML形式でステータスを返す | E-01 L118-129 | ○ |

### MachineSetting モデル（UT-MCH-021〜027）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-13 | to_native_valueがget_settingを呼ぶ | E-01 L149-153 | ○ |
| C-14 | save時にregistry.update_machineが呼ばれる | E-01 L166-172 | ○ |
| C-15 | get_config_typeが'M'/'D'を変換する | E-01 L174-180 | ○ |
| C-16 | get_setting_definitionがdriver/machine設定を取得 | E-01 L182-204 | ○ |
| C-17 | unique_together制約が定義されている | E-01 L141 | ○ |

### BaseDriver クラス（UT-MCH-028〜037）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-18 | BaseDriver.__init__が存在 | E-02 L97-99 | ○ |
| C-19 | init_driverメソッドが定義 | E-02 L101-106 | ○ |
| C-20 | init_machineメソッドが定義 | E-02 L108-116 | ○ |
| C-21 | update_machineメソッドが定義 | E-02 L118-129 | ○ |
| C-22 | restart_machineメソッドが定義 | E-02 L131-139 | ○ |
| C-23 | get_machinesがregistry.get_machinesを呼ぶ | E-02 L147-161 | ○ |
| C-24 | handle_errorがerrorsに追加 | E-02 L163-170 | ○ |
| C-25 | errorsプロパティが存在 | E-02 L173-176 | ○ |

### BaseMachineType クラス（UT-MCH-038〜080）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-26 | __init__がdriver取得とエラーチェック | E-02 L220-247 | ○ |
| C-27 | __str__がnameを返す | E-02 L249-251 | ○ |
| C-28 | __repr__がクラス名とnameを返す | E-02 L253-255 | ○ |
| C-29 | machine_configプロパティがDBから取得 | E-02 L258-264 | ○ |
| C-30 | nameプロパティがconfig.nameを返す | E-02 L266-270 | ○ |
| C-31 | activeプロパティがconfig.activeを返す | E-02 L272-278 | ○ |
| C-32 | initializeが設定チェックとdriver.init_machineを呼ぶ | E-02 L281-302 | ○ |
| C-33 | updateがdriver.update_machineを呼ぶ | E-02 L304-323 | ○ |
| C-34 | restartが状態リセットとdriver.restart_machineを呼ぶ | E-02 L325-343 | ○ |
| C-35 | handle_errorがerrorsに追加 | E-02 L346-353 | ○ |
| C-36 | reset_errorsがerrorsを空にする | E-02 L355-357 | ○ |
| C-37 | get_settingがMachineSetting.get_settingを呼ぶ | E-02 L359-377 | ○ |
| C-38 | set_settingがMachineSetting.set_settingを呼ぶ | E-02 L379-396 | ○ |
| C-39 | check_settingsが設定検証を行う | E-02 L398-418 | ○ |
| C-40 | set_statusがshared_stateを設定 | E-02 L420-428 | ○ |
| C-41 | set_status_textがshared_stateを設定 | E-02 L430-436 | ○ |
| C-42 | set_propertiesがデフォルト値を設定 | E-02 L438-456 | ○ |
| C-43 | initialized/restart_required/errors/status/status_text/propertiesプロパティ | E-02 L459-501 | ○ |

### MachineRegistry クラス（UT-MCH-081〜119）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-44 | __init__が空のdict/listを初期化 | E-03 L99-114 | ○ |
| C-45 | errorsプロパティがshared_stateから取得 | E-03 L116-119 | ○ |
| C-46 | is_readyがreadyを返す | E-03 L121-124 | ○ |
| C-47 | handle_errorがerrorsに追加 | E-03 L126-129 | ○ |
| C-48 | initializeがreadyをTrueにしreload_machinesを呼ぶ | E-03 L131-135 | ○ |
| C-49 | discover_machine_typesがプラグインからタイプを収集 | E-03 L137-185 | ○ |
| C-50 | discover_driversがプラグインからドライバーを収集 | E-03 L187-226 | ○ |
| C-51 | get_driver_instanceがインスタンスを取得/作成 | E-03 L228-238 | ○ |
| C-52 | load_machinesがDBからマシンをロード | E-03 L240-273 | ○ |
| C-53 | reload_machinesがリセットして再ロード | E-03 L275-287 | ○ |
| C-54 | add_machineがmachinesに追加 | E-03 L289-304 | ○ |
| C-55 | update_machineがmachine.updateを呼ぶ | E-03 L306-315 | ○ |
| C-56 | restart_machineがmachine.restartを呼ぶ | E-03 L317-320 | ○ |
| C-57 | remove_machineがmachinesから削除 | E-03 L322-326 | ○ |
| C-58 | get_machinesがフィルター条件で取得 | E-03 L328-379 | ○ |
| C-59 | get_machine_typesがリストを返す | E-03 L381-384 | ○ |
| C-60 | get_machineがpkで取得 | E-03 L386-389 | ○ |
| C-61 | get_driver_typesがフィルター付きで取得 | E-03 L391-402 | ○ |
| C-62 | get_driversがインスタンスリストを返す | E-03 L404-415 | ○ |
| C-63 | call_machine_functionがドライバー関数を呼ぶ | E-03 L490-530 | ○ |
| C-64 | _calculate_registry_hashがMD5ハッシュを計算 | E-03 L417-439 | ○ |
| C-65 | _check_reloadがハッシュ比較でリロード判定 | E-03 L441-467 | ○ |
| C-66 | _update_registry_hashがグローバル設定に保存 | E-03 L469-488 | ○ |

### tasks モジュール（UT-MCH-120〜121）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-67 | ping_machinesが全ドライバーをping | E-06 L14-23 | ○ |
| C-68 | MACHINE_PING_ENABLED=Falseでスキップ | E-06 L18-19 | ○ |

### LabelPrinterBaseDriver クラス（UT-MCH-122〜129）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-69 | print_labelメソッドが定義 | E-07 L34-54 | ○ |
| C-70 | print_labelsが各アイテムにprint_labelを呼ぶ | E-07 L56-82 | ○ |
| C-71 | get_printersがget_machinesを呼ぶ | E-07 L84-98 | ○ |
| C-72 | get_printing_options_serializerがシリアライザを返す | E-07 L100-114 | ○ |
| C-73 | machine_pluginプロパティがプラグインを返す | E-07 L117-121 | ○ |
| C-74 | render_to_pdf/html/pngメソッドが定義 | E-07 L123-174 | ○ |

### LabelPrinterMachine クラス（UT-MCH-130〜132）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-75 | LabelPrinterMachineが定義されMACHINE_SETTINGSを持つ | E-07 L241-260 | ○ |
| C-76 | locationプロパティがStockLocationを返す | E-07 L262-270 | ○ |

### LabelPrinterStatus Enum（UT-MCH-133〜137）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-77 | 各ステータスコードが定義 | E-07 L217-238 | ○ |

### シリアライザ（UT-MCH-138〜151）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-78 | MachineConfigSerializerの各メソッド | E-04 L86-116 | ○ |
| C-79 | MachineDriverSerializerのget_errors | E-04 L207-215 | ○ |
| C-80 | BaseMachineClassSerializerの各メソッド | E-04 L168-185 | ○ |

### API（UT-MCH-152〜166）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-81 | get_machine関数がNotFoundを発生 | E-05 L58-72 | ○ |
| C-82 | MachineListがGET/POSTを処理 | E-05 L18-43 | ○ |
| C-83 | MachineDetailがGET/PUT/PATCH/DELETEを処理 | E-05 L45-56 | ○ |
| C-84 | MachineSettingList/Detailが設定を処理 | E-05 L75-136 | ○ |
| C-85 | MachineRestartがPOSTで再起動 | E-05 L139-156 | ○ |
| C-86 | MachineTypesList/MachineDriverList/RegistryStatusViewが各種情報を返す | E-05 L159-216 | ○ |

## 4) 不足情報（Unknown / Missing）
- 根拠なしの項目はありません。全てのテストケースはソースコードから直接導出されています。

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - 全テストケースがソースコードに基づいており、高い信頼性を持つ
- 注意点:
  - レジストリ連携（save/delete時の動作）はトランザクション境界とタイミングに注意
  - call_machine_functionの例外処理は実際のドライバー実装に依存
  - 状態遷移（active変更時のinitialize/uninitialize）は順序が重要

## 6) レビュアーチェックリスト（最小）
- [ ] レジストリ連携テスト（UT-MCH-002〜004, 022）がモックを適切に使用しているか確認
- [ ] 初期化エラーケース（UT-MCH-039, 040, 050, 051）で全エラーパターンがカバーされているか確認
- [ ] call_machine_function（UT-MCH-112〜116）でraise_errorパラメータの動作が正しいか確認
- [ ] 状態遷移テスト（UT-MCH-053, 054）でactiveフラグ変更時の動作が正しいか確認
- [ ] LabelPrinterのrender系メソッド（UT-MCH-127〜129）で外部依存（PIL, pdf2image）のモック戦略が適切か確認
