---
generated_at: 2026-02-22 12:00:00
metrics:
  claims_total: 48
  claims_with_evidence: 45
  claims_without_evidence: 3
confidence_derived: 0.94
---

# 根拠レポート：運用マニュアル

## 本レポートについて

### 目的
本レポートは、生成された運用マニュアルの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.94**
  - 根拠あり：45 / 48、根拠なし：3
- 優先レビュー（高）
  1. **CMakeプロジェクト組み込み手順**：find_packageの具体的な使い方はプロジェクト依存のため根拠不足
  2. **デフォルトスレッドプールサイズ上限**：最大1024の記述はソースコード確認が必要
  3. **GitHubイシューURL**：外部URLの正確性は動的に変わる可能性あり

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

- E-01: `docs/code-to-docs/README.md` — プロジェクト概要・技術スタック・ディレクトリ構成・セットアップ手順
- E-02: `docs/code-to-docs/機能一覧/機能一覧.csv` — 全184機能のAPI一覧
- E-03: `docs/code-to-docs/画面一覧/画面一覧.csv` — 全42ドキュメントページ一覧
- E-04: `docs/code-to-docs/画面遷移図/画面遷移図.md` — ドキュメントサイトのページ構成と遷移
- E-05: `docs/code-to-docs/画面機能マッピング/画面機能マッピング.csv` — ページとAPI機能の対応マッピング
- E-06: `docs/src/index.rst` — ドキュメントサイトトップページ（機能一覧・ダウンロード先）
- E-07: `docs/src/design.rst` — 設計概要（ハンドル/リクエスト/I/Oループの設計思想）
- E-08: `docs/src/guide/basics.rst` — 基本事項ユーザーガイド（イベントループ・ハンドル・リクエスト）
- E-09: `include/uv.h` — メインヘッダファイル（全公開API定義）
- E-10: `CMakeLists.txt` — CMakeビルド設定
- E-11: `CONTRIBUTING.md` — コントリビューションガイド

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

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | libuvは非同期I/O処理のマルチプラットフォームCライブラリである | E-01, E-06 | ○ |
| C-02 | Node.jsのために開発され、Luvit, Julia, uvloop等で利用 | E-01, E-06 | ○ |
| C-03 | バージョンは1.52.1-dev（開発版） | E-01 | ○ |
| C-04 | epoll/kqueue/IOCPをバックエンドとする | E-01, E-07 | ○ |
| C-05 | 主要業務カテゴリ（ネットワークI/O、ファイルI/O等）の記載 | E-02 | ○ |
| C-06 | 業務フローは5ステップで構成 | E-01, E-08 | ○ |
| C-07 | ユーザー種別は3種類（利用開発者、コントリビュータ、ドキュメント閲覧者） | E-01, E-11 | ○ |
| C-08 | Tier1プラットフォーム: Linux/macOS/Windows | E-01 | ○ |
| C-09 | Tier2プラットフォーム: FreeBSD/AIX/IBM i/z/OS/musl | E-01 | ○ |
| C-10 | Tier3プラットフォーム: Android/MinGW-w64 | E-01 | ○ |
| C-11 | C11対応コンパイラが必要（GCC 4.8+、Clang、MSVC 2017+） | E-01 | ○ |
| C-12 | CMake 3.10以上が必要 | E-01, E-10 | ○ |
| C-13 | CMakeビルド手順: cmake -B build -DBUILD_TESTING=ON | E-01 | ○ |
| C-14 | Autotoolsビルド手順: sh autogen.sh / ./configure / make | E-01 | ○ |
| C-15 | Homebrew/vcpkg/Conanによるインストール手順 | E-01 | ○ |
| C-16 | ドキュメントはSphinx（RST形式）で生成 | E-03, E-06 | ○ |
| C-17 | ドキュメントは4カテゴリ（設計概要/API/ガイド/アップグレード） | E-03, E-04, E-06 | ○ |
| C-18 | ドキュメントビルドコマンド: make html / make man / make livehtml | E-01 | ○ |
| C-19 | find_packageによるCMakeプロジェクト組み込み手順 | **根拠なし** | △ |
| C-20 | イベントループAPI一覧（13機能） | E-02 | ○ |
| C-21 | イベントループのイテレーション順序（12ステップ） | E-07 | ○ |
| C-22 | イベントループはスレッドセーフではない | E-07 | ○ |
| C-23 | ハンドル型一覧（14種類） | E-02, E-08 | ○ |
| C-24 | ハンドルのライフサイクル（init→start→stop→close） | E-07, E-08 | ○ |
| C-25 | uv_close()の呼び出しが必須 | E-07, E-08 | ○ |
| C-26 | リクエスト型一覧（8種類） | E-02, E-08 | ○ |
| C-27 | uv_fs_t使用後にuv_fs_req_cleanup()が必要 | E-07, E-08 | ○ |
| C-28 | TCPサーバー構築手順（init→bind→listen→accept→read/write） | E-02, E-05 | ○ |
| C-29 | TCPオプション設定（nodelay, keepalive, simultaneous_accepts等） | E-02 | ○ |
| C-30 | UDP通信手順とマルチキャスト対応API | E-02 | ○ |
| C-31 | パイプ・IPC利用手順（uv_write2によるハンドル受け渡し） | E-02 | ○ |
| C-32 | 非同期ファイル操作API一覧（19機能） | E-02 | ○ |
| C-33 | ファイルI/Oはスレッドプール上で実行される | E-07 | ○ |
| C-34 | ファイル監視の2方式（FSイベント/FSポーリング） | E-02 | ○ |
| C-35 | スレッドプールのデフォルトサイズは4 | E-07 | ○ |
| C-36 | UV_THREADPOOL_SIZEで最大1024に変更可能 | **根拠なし** | △ |
| C-37 | 同期プリミティブ一覧（ミューテックス、rwlock、セマフォ等7種） | E-02 | ○ |
| C-38 | 子プロセス管理（uv_spawn, uv_process_kill等） | E-02 | ○ |
| C-39 | シグナルハンドリング（init→start→callback→oneshot対応） | E-02 | ○ |
| C-40 | DNS解決（uv_getaddrinfo, uv_getnameinfo） | E-02 | ○ |
| C-41 | メトリクスAPI（uv_metrics_info, uv_metrics_idle_time） | E-02 | ○ |
| C-42 | エラーコード定義（170以上） | E-01, E-02 | ○ |
| C-43 | エラー処理API（uv_strerror, uv_err_name, uv_translate_sys_error） | E-02 | ○ |
| C-44 | APIリファレンスカテゴリ一覧（25カテゴリ） | E-03, E-05 | ○ |
| C-45 | ユーザーガイド一覧（9ガイド） | E-03 | ○ |
| C-46 | コード規約: Google C/C++スタイル、2スペースインデント、行幅80文字 | E-01 | ○ |
| C-47 | サニタイザー付きビルドフラグ（ASAN/TSAN/UBSAN/MSAN） | E-01 | ○ |
| C-48 | GitHubイシューによるサポート | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- C-19: CMakeプロジェクトへの組み込み手順（`find_package(libuv)`）の記載は一般的なCMakeの慣例に基づくが、libuv固有のCMake設定ファイルの提供有無はCMakeLists.txtの詳細確認が必要
  - 候補：CMakeLists.txt / libuvConfig.cmake / pkg-config
- C-36: `UV_THREADPOOL_SIZE` の最大値1024はlibuvの一般的なドキュメントに基づくが、本ソースコードの `src/threadpool.c` での確認が必要
  - 候補：src/threadpool.c / include/uv.h
- C-48: GitHubイシューのURLは外部サービスであり、プロジェクト内のソースコードからは直接確認できない
  - 候補：CONTRIBUTING.md / README.md

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク — 本プロジェクトはGUIアプリケーションではなくCライブラリのため、テンプレートの「画面」「ログイン」等の概念をライブラリ利用フローに読み替えている。読み替えの妥当性は要確認
- 0: 低リスク — API関数名・引数はinclude/uv.hと機能一覧から網羅的に確認済み
- 1: 中リスク — スレッドプールサイズの上限値（1024）はソースコード直接確認が必要
- 0: 低リスク — ビルド手順はREADME.mdの内容と整合

## 6) レビュアーチェックリスト（最小）
- [ ] C-19: `find_package(libuv)` によるプロジェクト組み込み手順が実際に動作するか確認
- [ ] C-36: `src/threadpool.c` で `UV_THREADPOOL_SIZE` の最大値が1024であることを確認
- [ ] C-48: GitHubリポジトリのイシューページが有効であることを確認
- [ ] テンプレートの「業務フロー」概念をライブラリ開発フローに読み替えた構成が適切か確認
- [ ] APIリファレンスカテゴリ数と機能数の正確性を画面機能マッピングCSVと照合
