産業ソフトウェアの引き渡しでベンダーが渡すべき資料は何か｜発注側チェックリスト
システムが動くことと、引き渡されたことは別です。画面は開き、アラームは鳴るのに、保守できる根拠となる資料がベンダー技術者の手元に残ったまま——そのプロジェクトはまだ終わっていません。本記事は発注側の点検リストとして、産業ソフトウェアベンダーが引き渡し時に渡すべき14種の資料を4グループに分け、検収書にサインする前に確認できるようにします。後からファイリングするための一覧ではありません。
システムは動くのに資料が来ないとき、何が起きるか
引き渡し会議では、資料が「残作業の書類」扱いになりがちです。システムは稼働し、オペレーターは画面の説明を受け、残りは「来週渡す」で合意する。その1週間が四半期になり、プロジェクトチームは解散し、タグやテーブル、画面対応を説明できる人が現場担当から外れます。
資料不足の影響は検収当日には現れません。工場が後から必ず直面する場面で現れます。SCADA、MES、エネルギー管理、ライン連携いずれであっても、産業ソフトウェアを保守できる範囲は、資料が見つかり読める範囲に限られます。
- PLC を更新してタグを付け替える必要が出たが、元の I/O 点やレジスタを誰も特定できない
- 生産帳票を直したいが、どのデータベーステーブルを読み、どの集計規則を使っているか書き残されていない
- 元のベンダー技術者が現場を離れ、手元の資料では新しいオペレーターを教育できない
- 次の受託先に拡張を頼むと、アドレス・画面・インターフェースを逆解析してからでないと着手できない
- 保守内容で見解が分かれ、ローリングする保守項目一覧も年間保守報告書もなく、実際に何をしたか示せない
この5つは稼働後の日常であり、まれな事故ではありません。14種の資料がある理由は、ライン改造、担当交代、後工程の連携、保守の確認を「発掘作業」ではなく通常業務に戻すことです。
引き渡し一式に入るべき14種はどれか
工業プロジェクトの資料一式は14種類です。プロジェクト提案書、技術協議書、仕様書（式様書）、I/O 割付表、アドレス割付表、ネットワーク構成図、画面設計説明書、操作取扱説明書、データベーステーブル説明書、データインターフェース仕様書、試験報告書、検収資料、保守項目一覧、年間保守報告書。ファイル名を平面に並べても、発注側は箱の中身を点検できません。各グループが答える問いで分けると点検できます。
下の表は引き渡し会議用です。第3列は工程の完了条件ではなく、検収書にサインする前に見る項目です。
| 資料グループ | 含まれる資料 | 引き渡し時に点検すること |
|---|---|---|
| 契約と範囲 | プロジェクト提案書、技術協議書、仕様書（式様書） | 署名済みの範囲、検収条件、資料一覧そのものが書面にあり、机上の一式と一致している |
| 工程設計 | I/O 割付表、アドレス割付表、ネットワーク構成図、画面設計説明書 | 各信号にソース、アドレス、画面対応がある。渡されたのが設計意図だけでなく、実装と一致した竣工版である |
| システム連携 | データベーステーブル説明書、データインターフェース仕様書 | 後から ERP・WMS・帳票連携を行うとき、元の技術者に電話せず資料だけでインターフェースを設計できる |
| 運用 | 操作取扱説明書、試験報告書、検収資料、保守項目一覧、年間保守報告書 | オペレーターが説明書で勤務できる。試験が合意条件に対応している。保守作業が一覧化され、年次で報告できる |
この一覧は着手前に技術協議書へ書いておきます。締結時に名前のない資料は、チーム解散後に協議対象になり、作り直しは遅く、見解の整理も難しくなります。
発注側は引き渡しサインの前に何を確認するか
検収書への署名は、ベンダー側では案件の終了です。工場側では、これから資料だけで自立する期間の開始です。次の問いは引き渡し会議で一つずつ聞けます。答えが「後で送ります」なら、その項目はまだ納品されていません。
- 14種は技術協議書に項目として書かれているか、契約が「資料」とだけ書いて一覧がないか
- 名前のある各資料は、実装された I/O・アドレス・画面・インターフェースと一致した竣工版か
- プロジェクトに参加していない人が、操作取扱説明書に従って1シフトをベンダーへ電話せず完了できるか
- 試験報告書に判定条件、方法、結果、日付があり、第三者が合否を判断できるか
- データベーステーブル説明書とデータインターフェース仕様書に、テーブル、フィールド、方向、マスタデータの責任者が書かれているか
- 保守項目一覧と年間保守報告書に、翌年の作業の基準になる使えるひな型があるか
- 引き渡し後の編集可能な原本は誰が持つか——工場か、ベンダーが保管する PDF だけか
最後の問いが最も飛ばされやすい項目です。署名済み PDF は記録です。編集できる I/O 割付表、アドレス割付表、ネットワーク構成図は、ラインが変わったときに工場が使う道具です。記録と道具の両方を渡し、一方で他方を代替しないことです。
資料はどの言語、どの形式で渡すべきか
オペレーターが読めない資料は、稼働後に使われません。言語は後回しの翻訳ではなく引き渡し条件であり、技術協議書の各資料名の横に書くべきです。日本の工場では、仕様書（式様書）を日本語で渡すことが設計と検収の基準になります。
形式も、その資料を続けて使えるかを決めます。朱書きだらけのスキャンは記録です。編集可能な I/O 割付表、アドレス割付表、ネットワーク構成図は現場の道具です。両方必要です。
- 会議と常設窓口の作業言語——日本語対応のブリッジ SE が案件を通して担当し、通訳が一度入るだけでは足りない
- 仕様書と操作取扱説明書の言語——使う人が読む日本語で出す。表紙だけ和訳し本文が別言語のファイルは、納品済みと数えない
- ファイル形式——編集可能な原本（表、図面、文書）に加え、署名済み PDF の記録。両方必須の資料を明記する
- 版管理——各資料に版番号、日付、設計稿と竣工稿を区別する印がある
言語と形式を、資料名と同じ表に書き込みます。締結前にその表を埋められるベンダーは、資料を成果物として扱っており、終盤に寄せ集めるファイルとは見ていません。
まとめ
産業ソフトウェアの引き渡しが完了したと言えるのは、元のベンダー技術者がその場にいなくても、工場が操作・変更・拡張できるときです。その条件は、契約と範囲、工程設計、システム連携、運用の4グループで点検した14種の資料を、合意した言語と形式で渡すことで満たされます。
着手前に一覧を技術協議書へ書いてください。引き渡し会議では竣工版を実装と照合し、「後で渡す」項目にはサインしないことです。