本書は、本アプリケーション（業務マニュアル生成AI / Business Manuals Create）の操作手順をまとめた利用者向けマニュアルです。画面・ボタン名は実装に準拠しています。

• 対象アプリ: 業務マニュアル生成AI
• 構成: フロントエンド（React + TypeScript + Vite）＋ バックエンド（Express REST API・インメモリ）
• 設計トレース: 業務シナリオ → ユースケース図 / クラス図 / 状態機械 → 実装

01はじめに

本アプリは、業務フロー・ユースケース記述・業務ルール・既存マニュアル・画面定義書などの入力データから、社内閉域のAIで業務マニュアルを自動生成・更新・配布するシステムです。機密を外部に出さずに作成工数を削減しつつ、最新性とレビュー統制を保ちます。主な機能は次のとおりです。

代表的なアクター（利用者像）：管理者（Admin）＝作成・承認 / 一般ユーザ（GeneralUser）＝閲覧。

02起動と終了

2.1 必要環境

• Node.js 20.x 以降

2.2 起動手順

2つのサーバーを起動します。ターミナルを2つ使います。

# ① バックエンド（REST API / ポート 4000）
cd app/backend
npm install        # 初回のみ
npm run dev        # 起動時にデモデータを投入

# ② フロントエンド（画面 / ポート 5173）
cd app/frontend
npm install        # 初回のみ
npm run dev

ブラウザで http://localhost:5173/ を開きます。

2.3 終了手順

各ターミナルで Ctrl + C。または以下で停止します。

lsof -ti:4000,5173 | xargs kill

03画面構成

画面左のサイドバーから各機能へ移動します。グループ構成は次のとおりです。

各機能は共通して 一覧 → 詳細 → 新規/編集 の3画面で構成されます。

• 一覧画面: 検索・絞り込み・並び替え・ページ送り。行クリックで詳細へ。右上「新規作成」で新規登録。
• 詳細画面: 内容表示と、右上の操作ボタン（一覧へ・編集・削除）、上部の「操作（状態遷移）」セクションの業務操作ボタン、関連する子情報の一覧。
• 新規/編集画面: 入力フォーム。「作成」または「更新」で保存、「キャンセル」で戻る。

04ダッシュボード

トップ画面（/）に表示されます。

• 各データの件数サマリ（業務マニュアル・テンプレート・入力データ・生成ジョブ・影響範囲分析・AIエンジン・社員・プロンプト）
• 最近の業務マニュアル（状態・AI生成/手動バッジ付き。クリックで詳細へ）
• AIエンジンの状態（社内閉域・機密非外部送信 BR-003 の遵守状況。「全AIエンジンが外部送信を遮断」バッジ）

全体状況の把握と、各機能への入り口として利用します。画面左がサイドバー、中央が表示エリアです。

05業務マニュアル

本システムの中心となるデータです。標準テンプレート構成のセクションを持ち、レビュー承認を経て、部門・職責を指定して公開・バージョン管理されます。

5.1 マニュアル一覧

• マニュアル名 / 状態 / 対象業務スコープ / テンプレート / 現行バージョン / AI生成 を表示。
• 検索、状態などによる絞り込み、並び替え、ページ送りが可能。行クリックで詳細へ。

5.2 マニュアルの新規作成

右上「新規作成」から登録します。

• マニュアル名（必須）、対象業務スコープ（必須）、状態、テンプレート、現行バージョン、AI生成チェック。
• 「作成」で保存。通常は AI 生成（生成ジョブ）から作られますが、手動での新規作成も可能です。

5.3 マニュアル詳細

詳細画面は、上から次の要素で構成されます。

1. 操作（状態遷移）: 状態に応じた業務操作ボタン（5.4）。
2. マニュアル本文（標準構成レイアウト）: 標準7構成（業務概要／前提条件／手順／分岐条件／注意事項／画面操作説明／用語説明）を文書レイアウトで表示。「印刷プレビュー」で本文のみを印刷できます（BR-013/BR-019/BR-020）。
3. 前バージョンとの差分比較（BR-009）: 直前バージョンとの追加・削除行を色分け表示（前バージョンが無い場合は「比較できる前バージョンがありません」）。
4. 詳細情報: 名称・状態・スコープ・テンプレート・現行バージョン・AI生成・日時。
5. 関連する子情報の一覧: セクション（標準構成）／図（画面図・フローチャート等）／バージョン履歴／レビュー／公開設定／出力／紐付く入力データ／生成ジョブ。各「詳細」から個別画面へ移動できます。

5.4 マニュアルのワークフロー（状態遷移）

詳細画面上部「操作（状態遷移）」のボタンで状態を進めます。ボタンは現在の状態に応じて可否が判定されます。

06マニュアル生成（生成ジョブ・AIエンジン・プロンプト）

AIによる自動生成の中核機能です。管理者が業務スコープを説明し、テンプレートとAIエンジンを指定して生成を指示します。

6.1 生成ジョブ（AIManualGeneration）

「生成・AI → 生成ジョブ」で管理します。ジョブ詳細には、対象業務スコープ・トリガー（手動／変更追従）・テンプレート・AIエンジン・対象マニュアル・使用プロンプトが表示されます。

• 操作（状態遷移）: 実行 / 完了 / 失敗 / 再試行。
• 状態は 待機（Pending）→ 生成中（Generating）→ 生成済（Generated）（または失敗 Failed）と進みます。
• 「使用プロンプト」に、生成に用いたプロンプト（本文生成・画面図生成・フローチャート生成など）が証跡として記録されます（BR-005）。

6.2 AIエンジン（BR-003 / BR-004）

「生成・AI → AIエンジン」で、生成に用いるエンジンを管理します。

• AIエンジンは社内閉域（オンプレ／専用環境）で動作し、機密データを外部送信しません（BR-003）。
• 導入時にエンジンを指定でき、本テストでは Claude を指定しています（BR-004）。
• ダッシュボードの「AIエンジン」カードで、全エンジンが外部送信を遮断していることを確認できます。

6.3 プロンプト（BR-005）

「生成・AI → プロンプト」で、本システム及びその他業務で使用したプロンプトを記録・管理します。用途・利用区分・AIエンジン・使用日時が残り、監査の対象になります。

07テンプレート管理

業務マニュアルの標準構成を定義します。管理者が作成・修正・削除し、バージョン管理します（BR-010/BR-016）。

7.1 標準テンプレート

「テンプレート管理 → 標準テンプレート」で管理します。詳細画面には、セクション定義（標準7構成）・バージョン履歴・このテンプレートから作成されたマニフェスト一覧が表示されます。

• 操作（状態遷移）: 有効化 / 修正(下書きへ) / アーカイブ。
• 状態は 下書き（Draft）→ 有効（Active）→（下書き｜アーカイブ） と遷移します。

7.2 テンプレートセクション／バージョン

• テンプレートセクション: 各構成セクション（業務概要・前提条件・手順・分岐条件・注意事項・画面操作説明・用語説明）の枠と記述ガイドを定義。
• テンプレートバージョン: バージョン番号・作成日/修正日・管理者名の版履歴（BR-010）。

08入力データと変更追従（影響範囲分析）

8.1 入力データ・ファイル（InputSource）

「入力データ・変更追従 → 入力データ・ファイル」で、生成の入力となるデータを管理します。種別は 業務フロー / ユースケース記述 / 業務ルール / 既存マニュアル / 操作ログ / 画面定義書 / DB設計。業務フローはマニュアルと紐づけて表示できます（BR-015）。

8.2 影響範囲分析（ChangeFollowUp / BR-011・BR-012）

入力データが変更されたとき、差分を検出し、どのマニュアルが影響を受けるかを分析して、承認付きで自動更新する変更追従の記録です。詳細画面には、入力データ・差分要約・影響マニュアル数・影響マニュアル一覧が表示されます。

• 操作（状態遷移）: 影響分析 / 自動更新 / 影響なしで終了 / 承認(公開)。
• 状態は 検出（Detected）→ 影響分析済（Analyzed）→（自動更新 Regenerated →）承認（Approved） と進みます。

09レビュー・公開・組織

9.1 レビュー（BR-006）

「公開・組織 → レビュー」で、自動生成マニュアルに対する管理者のレビューを管理します。判定は 承認（Approved）／修正指示（ChangeRequested）／却下（Rejected）。承認されなければマニュアルは公開されません。

9.2 公開設定（公開範囲の指定）

「公開・組織 → 公開設定」で、公開対象の部門と職責を指定します（BR-007）。

部門・社員データ（名前・所属・役職）に基づき閲覧範囲を制御する想定です。マニュアルの「承認・公開」には、この公開設定が1件以上必要です。

9.3 部門・社員

• 部門（Department）: 公開対象の指定と閲覧範囲制御に用いる組織データ。
• 社員（Employee）: 名前・所属・役職を管理。管理者（Admin）/一般ユーザ（GeneralUser）の区分と職責で、公開マニュアルの閲覧可否が決まります（BR-017/BR-018）。

10マニュアルの出力（PDF/Word/Markdown）

「マニュアル → マニュアル出力」または、マニュアル詳細の関連「出力」から確認します。出力は公開済（Published）マニュアルに対して行います。

• 出力形式は PDF / Word / Markdown / 印刷（BR-014）。
• 出力詳細画面では、出力済みマニュアルのプレビュー（標準構成レイアウト）、「ダウンロード」ボタン、「印刷プレビュー」が利用できます。
• 図・罫線表は、ビューア表示・印刷・各形式出力のいずれでも表現を保ちます（BR-021）。

11業務ルールと状態遷移

11.1 マニュアルの状態遷移

         レビュー提出            承認・公開(公開設定≥1)
 下書き ──────────────▶ レビュー中 ──────────────▶ 公開済 ──── アーカイブ ──▶ アーカイブ
   ▲                     │                          │
   │   修正指示(差戻)     │                          │ 新版を公開
   └─────────────────────┘                          ▼
                                                  （新バージョンを発番して公開）

• 「レビュー提出」は 下書き から。
• 「修正指示(差戻)」は レビュー中 から下書きへ。
• 「承認・公開」は レビュー中 から。公開設定（部門・職責）が1件以上必要。
• 「新版を公開」は 公開済 から（コメント付きで版を追加）。
• 「アーカイブ」は 公開済 から。

11.2 テンプレート／生成ジョブ／影響範囲分析の状態

11.3 主な業務ルール

12よくある質問・トラブルシュート

13制約事項

• データはインメモリ保持です。バックエンドを再起動すると、登録したデータはシード（初期）状態に戻ります。
• ログイン認証はありません。権限は社員データ上の属性（区分・職責）として扱います。閲覧範囲制御（BR-018）は設計上の想定です。
• AI生成・出力はデモ実装です。生成ジョブはデモの状態遷移として動作し、マニュアル出力（PDF/Word/Markdown）は形式・本文の記録とプレビューまでを行う想定で、実ファイル生成は本デモ範囲外です。AIエンジンは「Claude を閉域指定」というメタデータとして扱います。
• 本番運用では、永続化層を PostgreSQL（Prisma 等）へ、AI連携を実際の閉域エンジンへ差し替えることを想定しています。