VS Codeをインストールしたら最初に設定すべき5選!おすすめ拡張機能も解説

保守案件に入ったら最初に確認すること!現役SEが実務で見ているポイント

VS Codeをインストールしたら最初に設定すべき5選!おすすめ拡張機能も解説

新規開発ではなく、既存システムの保守案件に入ることはSEの実務でよくあります。

保守案件では、すでに動いているシステムを扱うため、いきなりコードを読んだり修正したりするよりも、まず全体像を把握することが重要です。

初心者のうちは、担当になった機能のソースコードから見始めてしまいがちです。しかし実務では、コードだけを見ても、そのシステムが業務でどう使われているのか、どこを変更すると影響が出るのかは分かりません。

私自身、保守や改修に関わる中で、最初に確認する情報の質によって、その後の調査や対応のしやすさが大きく変わると感じています。

この記事では、保守案件に入ったら最初に確認することを、現役SEの実務目線で整理します。

この記事でわかること

  • 保守案件で最初に確認すべき情報
  • 初心者SEがやりがちな失敗
  • 業務、運用、障害履歴、リリース手順の見方
  • 既存システムを安全に改修するための考え方

保守案件では「コードを読む前の確認」が重要

保守案件に入ると、まずソースコードを確認したくなります。

もちろんコードを読むことは必要です。しかし、最初から細かい実装だけを見ると、全体像を見失うことがあります。

保守案件で最初に知りたいのは、次のような情報です。

  • このシステムは何の業務に使われているか
  • 主な利用者は誰か
  • 重要な機能はどれか
  • 止まると困る処理は何か
  • よく問い合わせが来る箇所はどこか
  • 過去に障害が起きた箇所はどこか

このあたりを把握してからコードを見ると、なぜその実装になっているのかを理解しやすくなります。

失敗例1:担当機能だけを見て影響範囲を見落とす

保守案件でよくある失敗が、担当機能だけを見て修正してしまうことです。

既存システムでは、同じデータを複数の画面、バッチ、帳票、外部連携で使っていることがあります。

たとえば、注文ステータスの扱いを少し変えるだけでも、次のような箇所に影響するかもしれません。

  • 注文一覧画面
  • 管理者向け詳細画面
  • 夜間バッチ
  • 売上集計
  • CSV出力
  • 外部システム連携

対象画面だけで動作確認しても、他の処理で不具合が出る可能性があります。

リリース前の影響確認については「リリース前チェックで見落としやすいポイント」でも解説しています。

失敗例2:過去の障害履歴を見ない

保守案件では、過去の障害履歴や問い合わせ履歴が重要な情報になります。

過去に何度も問題が起きている箇所は、仕様が複雑だったり、運用で例外対応が多かったりすることがあります。

障害履歴を見ると、次のような情報が分かります。

  • 過去にどの機能で問題が起きたか
  • 原因はコード、設定、データ、運用のどれだったか
  • 暫定対応で終わっていないか
  • 再発防止が実施されているか
  • 問い合わせが多い画面や処理はどこか

この情報を知らずに改修すると、過去と同じ問題を繰り返す可能性があります。

障害報告の見方については「障害報告書で伝わらない原因と対策」も参考になります。

失敗例3:運用ルールを確認しない

既存システムには、設計書に書かれていない運用ルールが残っていることがあります。

たとえば、月末だけ手動でデータを補正している、特定の取引先だけ例外対応している、障害時だけ別手順で処理している、というケースです。

これらを知らずにシステムを変更すると、現場の運用が回らなくなることがあります。

確認対象 見るポイント 見落としたときのリスク
業務フロー 誰がいつ何をするか 現場の作業と画面が合わない
例外対応 手動補正や特別対応があるか 特定ケースだけ処理できない
締め処理 月次、日次、締め後変更の扱い 集計や帳票にズレが出る
権限 誰が参照・更新できるか 見えてはいけない情報が見える
問い合わせ よく聞かれる内容 利用者が困る箇所を見落とす

保守案件では、仕様書だけでなく、運用担当者や過去の問い合わせも重要な情報源になります。

最初に確認するドキュメント

保守案件に入ったら、まず次のドキュメントを確認します。

  • システム概要資料
  • 業務フロー
  • 画面一覧
  • 機能一覧
  • テーブル定義
  • バッチ一覧
  • 外部連携一覧
  • リリース手順書
  • 障害報告書や問い合わせ履歴

すべてが最新とは限りません。そのため、資料を読むだけでなく、実際の画面やログ、運用担当者への確認と合わせて見ることが大切です。

問い合わせ対応で見るべきポイント

保守案件では、問い合わせ対応を任されることもあります。

問い合わせを受けたときは、いきなり原因を決めつけず、まず事象を整理します。

  • 誰が操作したのか
  • どの画面や処理で起きたのか
  • いつから起きているのか
  • 全員で起きるのか、特定ユーザーだけか
  • 対象データに特徴があるか
  • 直近でリリースや設定変更があったか

この整理をせずに調査を始めると、原因から遠ざかることがあります。

バグ調査の切り分けは「AIでバグ調査をするときの落とし穴」でも考え方を紹介しています。

保守案件で最初に聞く質問

私が保守案件に入ったときは、次のような質問をします。

  • このシステムで一番止まると困る処理は何ですか
  • 問い合わせが多い機能はどこですか
  • 過去に大きな障害が起きた箇所はどこですか
  • リリース時に特に注意する作業はありますか
  • 仕様書に書かれていない運用ルールはありますか
  • 手動対応が残っている業務はありますか
  • 変更時に必ず確認する担当者は誰ですか

このような質問をしておくと、コードだけでは分からないリスクを把握しやすくなります。

AIを使うなら資料整理の補助に使う

保守案件では、資料が多く、最初に全体像をつかむのが大変です。

AIは、資料の要約や確認観点の洗い出しに使えます。ただし、業務情報や個人情報、顧客情報をそのまま入力しないよう注意が必要です。

使うなら、情報を抽象化したうえで次のように依頼します。

以下の機能一覧をもとに、保守担当者が最初に確認すべき業務影響、障害リスク、運用確認ポイントを整理してください。未確認の前提や関係者に聞くべき質問も分けてください。

AIの回答は、あくまで確認観点のたたき台として使い、最終的には現場の資料や担当者に確認する必要があります。

まとめ:保守案件は全体像をつかんでからコードを見る

保守案件に入ったら、いきなりコードを直すのではなく、まずシステムの役割、利用者、業務フロー、運用ルール、障害履歴、リリース手順を確認することが大切です。

既存システムは、長く運用される中で例外対応や暗黙のルールが増えていることがあります。そこを知らずに変更すると、思わぬ影響が出る可能性があります。

初心者SEほど、担当機能だけに集中しがちです。しかし実務では、周辺機能、データ、運用、問い合わせ履歴まで見ることで、安全に保守対応しやすくなります。

保守案件では、コードを読む力だけでなく、業務と運用を理解する力が重要です。最初の確認を丁寧に行うことで、その後の調査や改修の質を上げることができます。