新規開発ではなく、既存システムの保守案件に入ることはSEの実務でよくあります。
保守案件では、すでに動いているシステムを扱うため、いきなりコードを読んだり修正したりするよりも、まず全体像を把握することが重要です。
初心者のうちは、担当になった機能のソースコードから見始めてしまいがちです。しかし実務では、コードだけを見ても、そのシステムが業務でどう使われているのか、どこを変更すると影響が出るのかは分かりません。
私自身、保守や改修に関わる中で、最初に確認する情報の質によって、その後の調査や対応のしやすさが大きく変わると感じています。
この記事では、保守案件に入ったら最初に確認することを、現役SEの実務目線で整理します。
この記事でわかること
- 保守案件で最初に確認すべき情報
- 初心者SEがやりがちな失敗
- 業務、運用、障害履歴、リリース手順の見方
- 既存システムを安全に改修するための考え方
保守案件では「コードを読む前の確認」が重要
保守案件に入ると、まずソースコードを確認したくなります。
もちろんコードを読むことは必要です。しかし、最初から細かい実装だけを見ると、全体像を見失うことがあります。
保守案件で最初に知りたいのは、次のような情報です。
- このシステムは何の業務に使われているか
- 主な利用者は誰か
- 重要な機能はどれか
- 止まると困る処理は何か
- よく問い合わせが来る箇所はどこか
- 過去に障害が起きた箇所はどこか
このあたりを把握してからコードを見ると、なぜその実装になっているのかを理解しやすくなります。
失敗例1:担当機能だけを見て影響範囲を見落とす
保守案件でよくある失敗が、担当機能だけを見て修正してしまうことです。
既存システムでは、同じデータを複数の画面、バッチ、帳票、外部連携で使っていることがあります。
たとえば、注文ステータスの扱いを少し変えるだけでも、次のような箇所に影響するかもしれません。
- 注文一覧画面
- 管理者向け詳細画面
- 夜間バッチ
- 売上集計
- CSV出力
- 外部システム連携
対象画面だけで動作確認しても、他の処理で不具合が出る可能性があります。
リリース前の影響確認については「リリース前チェックで見落としやすいポイント」でも解説しています。
失敗例2:過去の障害履歴を見ない
保守案件では、過去の障害履歴や問い合わせ履歴が重要な情報になります。
過去に何度も問題が起きている箇所は、仕様が複雑だったり、運用で例外対応が多かったりすることがあります。
障害履歴を見ると、次のような情報が分かります。
- 過去にどの機能で問題が起きたか
- 原因はコード、設定、データ、運用のどれだったか
- 暫定対応で終わっていないか
- 再発防止が実施されているか
- 問い合わせが多い画面や処理はどこか
この情報を知らずに改修すると、過去と同じ問題を繰り返す可能性があります。
障害報告の見方については「障害報告書で伝わらない原因と対策」も参考になります。
失敗例3:運用ルールを確認しない
既存システムには、設計書に書かれていない運用ルールが残っていることがあります。
たとえば、月末だけ手動でデータを補正している、特定の取引先だけ例外対応している、障害時だけ別手順で処理している、というケースです。
これらを知らずにシステムを変更すると、現場の運用が回らなくなることがあります。
| 確認対象 | 見るポイント | 見落としたときのリスク |
|---|---|---|
| 業務フロー | 誰がいつ何をするか | 現場の作業と画面が合わない |
| 例外対応 | 手動補正や特別対応があるか | 特定ケースだけ処理できない |
| 締め処理 | 月次、日次、締め後変更の扱い | 集計や帳票にズレが出る |
| 権限 | 誰が参照・更新できるか | 見えてはいけない情報が見える |
| 問い合わせ | よく聞かれる内容 | 利用者が困る箇所を見落とす |
保守案件では、仕様書だけでなく、運用担当者や過去の問い合わせも重要な情報源になります。
最初に確認するドキュメント
保守案件に入ったら、まず次のドキュメントを確認します。
- システム概要資料
- 業務フロー
- 画面一覧
- 機能一覧
- テーブル定義
- バッチ一覧
- 外部連携一覧
- リリース手順書
- 障害報告書や問い合わせ履歴
すべてが最新とは限りません。そのため、資料を読むだけでなく、実際の画面やログ、運用担当者への確認と合わせて見ることが大切です。
問い合わせ対応で見るべきポイント
保守案件では、問い合わせ対応を任されることもあります。
問い合わせを受けたときは、いきなり原因を決めつけず、まず事象を整理します。
- 誰が操作したのか
- どの画面や処理で起きたのか
- いつから起きているのか
- 全員で起きるのか、特定ユーザーだけか
- 対象データに特徴があるか
- 直近でリリースや設定変更があったか
この整理をせずに調査を始めると、原因から遠ざかることがあります。
バグ調査の切り分けは「AIでバグ調査をするときの落とし穴」でも考え方を紹介しています。
保守案件で最初に聞く質問
私が保守案件に入ったときは、次のような質問をします。
- このシステムで一番止まると困る処理は何ですか
- 問い合わせが多い機能はどこですか
- 過去に大きな障害が起きた箇所はどこですか
- リリース時に特に注意する作業はありますか
- 仕様書に書かれていない運用ルールはありますか
- 手動対応が残っている業務はありますか
- 変更時に必ず確認する担当者は誰ですか
このような質問をしておくと、コードだけでは分からないリスクを把握しやすくなります。
AIを使うなら資料整理の補助に使う
保守案件では、資料が多く、最初に全体像をつかむのが大変です。
AIは、資料の要約や確認観点の洗い出しに使えます。ただし、業務情報や個人情報、顧客情報をそのまま入力しないよう注意が必要です。
使うなら、情報を抽象化したうえで次のように依頼します。
以下の機能一覧をもとに、保守担当者が最初に確認すべき業務影響、障害リスク、運用確認ポイントを整理してください。未確認の前提や関係者に聞くべき質問も分けてください。
AIの回答は、あくまで確認観点のたたき台として使い、最終的には現場の資料や担当者に確認する必要があります。
まとめ:保守案件は全体像をつかんでからコードを見る
保守案件に入ったら、いきなりコードを直すのではなく、まずシステムの役割、利用者、業務フロー、運用ルール、障害履歴、リリース手順を確認することが大切です。
既存システムは、長く運用される中で例外対応や暗黙のルールが増えていることがあります。そこを知らずに変更すると、思わぬ影響が出る可能性があります。
初心者SEほど、担当機能だけに集中しがちです。しかし実務では、周辺機能、データ、運用、問い合わせ履歴まで見ることで、安全に保守対応しやすくなります。
保守案件では、コードを読む力だけでなく、業務と運用を理解する力が重要です。最初の確認を丁寧に行うことで、その後の調査や改修の質を上げることができます。