本文へ移動
KAIHATSU

マスター管理の開発依頼|名称変更・廃止と過去データの扱い

小規模な受託開発におけるマスター管理の開発要件として、商品・取引先の名称変更、廃止、統合が過去データへ及ぼす影響を整理し、履歴固定を分けて見積依頼と納品確認に使える判断基準を示します。

執筆・確認株式会社adding 編集部

order-guide / contract

マスター管理の開発要件を決めるときは、「商品名を変更できるようにする」だけでは足りません。変更後に過去の伝票まで新名称へ変わってよいのか、取引当時の名称を残すのかを先に決めます。廃止では新規選択を止めても既存取引を表示できること、統合では旧コードから統合先を確認できることまで分けて指定します。

発注者が先に決める中心事項は、業務上どの時点の表示を正とするかです。データベースの方式は、その判断と既存システムの構成に応じて開発側が検討します。過去表示を固定するなら、版と有効期間を保存・参照できることを要件に含めます。何を固定し、何を現在値へ追随させるかが見積範囲を分けます。

マスター管理の開発要件は変更後の見え方から決める

商品・取引先マスターは、入力画面だけでなく伝票、帳票、検索結果にも使われます。参照箇所ごとに、変更後の見え方を確認する必要があります。

デジタル庁の標準ガイドライン実践ガイドブック(2026年6月12日改定版)は、要件定義のデータ関連資料について、データ一覧をマスターデータとそれ以外に分け、用途や保存期間などを定義するとしています。データ定義では各項目の意味と記録ルールを定義し、CRUDマトリクスでは生成・参照・更新・削除という時系列の変化を整理します。コードについても、用途・構造と値ごとの意味を定義する資料が示されています。

つまり、「名称変更」という一つの依頼にも、コードは同じか、現在の表示名だけを変えるか、過去の記録をどう読むかという別々の判断があります。ここを一欄で済ませると、発注者は単純な上書きを想定し、開発側は履歴保存まで想定する、といった範囲のずれを見積もり前に見つけられません。

コード・名称・有効期間・廃止・統合・履歴固定の発注判断表

次の表は運用上の提案です。各判断欄を分け、対象マスターごとに「採用する方針」と「未決の方針」を記入して見積依頼へ添えます。

判断項目発注者が決めること過去データの扱い新規登録・更新の扱い見積依頼に書く条件
コード変更前後を同一の対象とみなすか、別対象として新しいコードを発行するか同一なら旧取引から同じ対象を参照する。別なら旧コードを残す旧コードの継続使用または新コードへの切替を指定するコードを不変識別子として扱う範囲と、再採番の有無
名称現在名称へ追随させるか、取引時点の名称を残すか追随なら新名称を表示し、固定なら当時名称を表示する有効な名称を選択・表示する画面、帳票、出力ごとの表示方針
有効期間いつから新しい状態を有効にするか対象日時に応じた版を参照する開始前・終了後の選択可否を指定する開始・終了の記録と、期間が不正な入力の拒否
廃止削除するか、廃止状態で残すか廃止前の取引から表示できる状態を保つ廃止後は新規選択させない一覧・検索・再編集時の表示と選択可否
統合旧コードをどのコードへ統合したか残すか旧取引の元コードと統合先のどちらを表示するか決める新規取引では統合先を使う旧コードから統合先をたどる条件と表示文言
履歴固定固定する項目と、現在値へ追随する項目を分ける固定対象は取引時点の版を再現する登録時に参照した版を特定できるようにする固定対象、参照基準日、対象画面・帳票・出力

行ごとに答えが異なっても構いません。「マスターを履歴管理する」と一括指定せず、利用箇所ごとの期待結果まで書けば、必要な保存と参照の範囲を開発側が見積もれます。

名称変更は「同じ対象か」と「同じ表示か」を分ける

名称が変わっても同一の商品・取引先として集計したいなら、コードの同一性と表示名称を分けます。そのうえで、過去伝票を開いたときの表示を選びます。

  • 現在名称へ追随する:過去伝票も変更後の名称で表示する
  • 取引時点で固定する:過去伝票は当時有効だった名称で表示する
  • 用途で分ける:現在の対象を示す箇所と、当時の記録を示す箇所で表示を変える

どれを選んでも、対象となる画面・帳票・出力を明記しなければ受け入れ時に判定できません。運用上の提案として、「過去データを変えない」という表現は、「取引日時を基準に、その時点で有効だった名称を伝票詳細と帳票に表示する」のように具体化します。基準日時と利用箇所がそろえば、納品時に同じ条件で確認できます。

廃止は削除・参照・選択を別々に決める

廃止済みの項目を新規取引で使わせたくない一方、既存取引からは内容を確認したい場合があります。この場合、運用上の提案は「新規選択は不可、既存取引からの参照は可」と二つの条件に分けることです。

再編集時、複製時、検索条件でも扱いを決めます。選択肢から消すだけでは、既存取引の表示や検索可否が未決のままです。削除を依頼する場合も、既存取引をどう表示するかを指定します。

統合は旧コードと統合先の関係を残す

二つの取引先を一つへ統合する場合、名称変更と同じ扱いにすると、どの旧コードから移ったのかが分からなくなります。運用上の提案として、旧コード、新しい統合先、切替の基準、有効期間を別々に記録する要否を決めます。

過去取引を統合先へ付け替えるのか、元のコードを保って統合先を参照できるようにするのかでも処理は異なります。過去検索、帳票、新規選択で期待する結果を示してください。

履歴固定が必要なら版と有効期間を要件にする

MicrosoftのTemporal tables(2026年8月18日更新)では、システムバージョン管理テーブルは、現在値を持つテーブルと過去版を持つ履歴テーブルを組み合わせ、開始列と終了列で各行の有効期間を記録します。更新時と削除時には変更前の行が履歴テーブルへ格納され、過去の特定時点で有効だった状態を問い合わせられます。

これは特定製品の採用指定ではありません。また、開始列と終了列が示すのは、データベース上でその行が有効だったシステム履歴期間です。商品を販売する期間や取引先との契約適用期間など、判断表にある業務上の有効期間と同一ではありません。業務上の期間と過去版を参照できることを発注条件に分け、実装方式は既存システムの構成を踏まえて開発側に提案してもらいます。

運用上の提案として、履歴固定を求める場合は次を見積依頼に含めます。

  • 版を残す対象項目:名称だけか、住所や分類なども含むか
  • 版を選ぶ基準:取引日時、確定日時など、どの日時を使うか
  • 参照する場所:画面、帳票、ファイル出力のどこか
  • 過去版の訂正:誤登録を直す権限と、訂正前の状態を残すか
  • 移行データ:既存データに当時の版を特定できない場合の扱い

未決の項目は見積条件に残します。外注条件の整理には、システム開発の要件定義チェックリスト|外注前に決める10項目も利用できます。

見積依頼で固定する範囲と追加範囲

見積依頼では、対象マスター名、変更操作、影響する利用箇所、過去表示、新規選択、移行の有無を一組にします。運用上の提案として、依頼文は次の粒度まで具体化します。

取引先のコードは変更せず、名称には有効期間を持たせる。確定済み取引の詳細画面と帳票では取引時点の名称を表示し、新規入力では入力時点で有効な名称を表示する。廃止済み取引先は新規選択できないが、既存取引の表示と検索はできるようにする。

この条件から、版と期間の保存、伝票からの参照、選択肢の制御、既存データの扱いを見積対象として確認できます。統合処理、過去版の訂正、履歴復元、外部連携への反映が必要なら追加範囲として明記します。

見積書では、判断表の各条件がどの作業や成果物に含まれるかを照合します。見積もりの確認観点はシステム開発の見積もりの取り方と内訳|妥当性の判断基準に整理しています。名称変更という機能名だけで比較せず、履歴保存、既存データの移行、画面・帳票・出力の改修、受け入れ確認が含まれるかを質問すると、追加依頼との境界が明確になります。

納品時は変更前後と境界条件を確認する

納品確認では、名称が変わることだけを見て完了にしません。運用上の提案として、依頼時に選んだ方針ごとに、次の条件と期待結果を受け入れ項目へ置きます。

条件操作確認する結果
名称変更前に確定した取引取引詳細と帳票を表示する決めた方針どおり、当時名称または現在名称が表示される
名称変更後の新規取引対象を選択して保存する有効な名称で選択・表示される
廃止済みの項目新規取引で選択を試す新規には選べない
廃止前の既存取引詳細表示と検索を行う既存取引を表示・検索できる
統合済みの旧コード過去取引から参照する元のコードと、指定した場合は統合先を確認できる
不正な有効期間開始と終了の前後関係が不正な状態で登録する登録が拒否される

OWASP FoundationのInput Validation Cheat Sheetは、入力検証を構文上の妥当性と業務文脈上の意味的妥当性の両方へ適用し、意味的検証の例として開始日が終了日より前であることを挙げています。有効期間の受け入れ条件には、日付形式と前後関係の両方を含めます。

判断表の結果が「過去は取引時点で固定」であれば、名称変更前の取引を開いて当時名称が出ることまで確認して完了です。「現在名称へ追随」であれば、同じ操作で新名称が出ることが完了条件になります。正解は一つではありません。発注時に選んだ方針と納品時の期待結果が一致していることが、受け入れの基準です。

未決事項を見積条件に残す

判断表を埋めても決めきれない欄は、空欄にせず「代替案ごとの見積を依頼する」「今回の対象外とする」のどちらかを記します。とくに既存データから当時の名称を復元できない場合は、推測で補うのか、現在名称を表示するのか、移行対象から除くのかを開発会社と合意する必要があります。

見積書と受け入れ項目には、同じ利用箇所と期待結果を転記します。たとえば「変更前に確定した取引の帳票には取引時点の名称を表示する」と決めたなら、その再現に必要な保存・移行・帳票改修までが対象です。統合先の表示や過去版の訂正がそこに含まれていなければ、追加範囲として扱えます。

執筆・確認:株式会社adding編集部

費用、期間、契約、法務・税務上の扱いは条件により異なります。記事の確認日とリンク先の一次情報を確認し、個別判断は専門家へご相談ください。

システム開発・発注ガイドへ戻る