メインコンテンツにスキップ
自媒科技企業向けAI・開発から導入まで
日本語JA
プロジェクト相談

企業AIプロジェクトWiki · テスト・検収

検収対象版(Acceptance version)

別名Acceptance version · 受入対象版 · 検収版 · UAT候補版 · 検収Baseline

定義

検収対象版とは、検収Cycle開始前に案件の権限者が正式指定し、検収範囲、環境、基準、証拠へ結び付けたSolution Configuration Baselineです。Application Artifact、設定、DB変更、Interfaceと依存先、必要なデータ状態、文書、企業AIのModel、Prompt、Knowledge、Toolを列挙し、全参加者が同じ対象を試験できるようにします。実質変更は新Baselineとし、影響に応じて再テスト範囲を判断します。

正式検収で対象版を指定する理由

検収判断は確定した対象にだけ成立します。午前と午後でCode、設定、データ、Knowledgeが違うのに結果を一回分としてまとめれば、どの対象が合格したか説明できません。

指定により、継続開発と正式判断の境界を作ります。開発は継続しても本Cycle対象は独立Baselineを持ち、不具合修正で元対象を無記録に上書きせず、新しい識別可能なBaselineにします。

Freezeは永久に変更しない意味ではありません。変更を可視化、承認、追跡し、失敗、修正、再テスト、例外、最終署名を具体的対象へBindingするためのものです。

完全な検収対象版に含めるもの

案件に応じて調整できますが、結果を変える対象はBaselineか管理された外部条件として登録します。

Application・Service Artifact

Frontend、Backend、Mobile、Job、Plugin、MiddlewareのVersion、Build、保管先、Content Digestを列挙し、Branch名や`latest`で代用しません。

設定・Feature Flag

環境変数、業務規則、権限Map、Template、Feature Flag、Schedule、主要Parameterを記録します。Secretは参照とVersionだけを記録し平文を載せません。

DB・Migration

Schema版、Migration Script、初期/Master Data Batch、実行結果、互換条件を含めます。同じAppでもDB構造が違えば同一対象ではありません。

Interface・外部依存

API契約、顧客・第三者System版、Endpoint種別、Test Double、証明書、既知制約を明記し、固定不能な依存は環境差異として登録します。

検収データ状態

業務Sample、移行Data、Account Role、初期状態をCycleへ関連付け、Version構成、Test Baseline、外部入力のどれかを区別します。

運用・利用文書

利用、管理、配備、引継ぎも検収する場合、Guide、Interface文書、Runbook、既知問題一覧もVersion管理します。

Build・Configuration Manifest

製品Versionを上記Component、Commit、Build、Digest、承認記録へMapする機械可読または監査可能なManifestを用意します。

一回の対象版を指定・固定する流れ

  1. Cycle範囲を確定

    Requirement、検収基準、業務Flow、Role、非機能項目、明確な対象外、許容例外を確定します。

  2. 候補Baselineを構成

    前段試験済みComponentからManifest、Artifact、配備説明を作り、UAT環境内で場当たり的に組みません。

  3. 配備・同一性確認

    不変Artifactを合意環境へ配備し、画面/APIのVersion、Digest、設定、DB状態をManifestと照合します。

  4. Entry Readinessを確認

    環境、Account、Data、依存、Log、問題Flow、Hard Stopが使え、既知差異が結論を無効にしないか確認します。

  5. 権限者が指定

    対象版ID、Manifest Digest、範囲、環境、期間、承認者、時刻を記録し、このBaselineから証拠を残すよう通知します。

  6. Baselineを保護

    Artifact上書き、DB直修正、無記録設定変更、Model Alias移動、Knowledge再Indexを制限し、必要変更はChange Controlへ通します。

不具合修正後に新版へ切り替える方法

  1. 元の失敗証拠を保持

    元Baseline、Scenario、入力、実結果、Log、Issue IDを残し、修正後に失敗記録を合格へ書き換えません。

    証拠:失敗Case、Defect、元Manifest。

  2. 変更Configuration Itemを特定

    Source、設定、Script、Data、Prompt、Knowledge変更と直接・間接影響を記録します。

    証拠:Change Request、Review、Diff、Risk判断。

  3. 新Baselineを生成

    挙動を変える更新には新しいAcceptance ID/Revisionを付け、ManifestとDigestを再生成します。

    証拠:新Manifest、Build、配備、承認。

  4. 再テスト・回帰範囲を決定

    失敗項目は必ず再テストし、共有Component、Migration、権限、連携、非決定性の影響に応じ回帰を追加します。

    証拠:影響分析と承認済み範囲。

  5. 条件付き受入を区別

    未修正で受け入れる場合は影響、回避策、期限、担当、Risk受入権限者を記録し、番号変更で隠しません。

    証拠:Exception、残留Risk、署名。

  6. Baseline別に結論を集約

    各項目がどの版で合格したかを示し、以前の証拠を再利用する場合は後続変更の影響がない理由を記録します。

    証拠:基準—Case—Version—結果Trace Matrix。

対象版記録が答えるべき質問

  1. 何を検収したか

    製品版、Component、Digest、設定、DB、文書、依存先を取得できます。

  2. 誰がいつ指定したか

    権限根拠、時刻、期間、環境、Manifest Digestを永続記録します。

  3. どこでBuildしどう配備したか

    Source、依存、Build Pipeline、Repository、Deployment Run、環境照合がつながります。

  4. どの基準・Caseが適用されるか

    範囲、基準、Sample、Case、非機能確認、対象外がBaselineへMapされます。

  5. Cycle中に何が変わったか

    各Revisionの理由、内容、承認、影響、再テスト、回帰、終了状態があります。

  6. 最終判断はどの版か

    署名にID、Digest、状態、条件、未解決問題、残留Risk、担当が明記されます。

企業AIで追加固定するもの

Model・托管Deployment

Provider、Model ID、固定Snapshot/Registry版、Deployment名、Region、安全Policy、主要Parameterを記録します。可動Aliasは解決版と再評価Triggerも保存します。

Prompt・Orchestration

System Prompt、Template、Output Schema、Agent Workflow、Routing、Memory Policy、Tool定義、人の承認をManifestへ含めます。

Knowledge状態

Source Batch、権限Snapshot、清掃、Chunk、Embedding Model、Index Build、Retrieval、Reranking、Cacheを固定します。無記録の再Indexは版変更です。

Tool・外部Action

API契約、Credential Scope、Test Endpoint、Allowlist、冪等性、確認Policyを列挙します。回答文が同じでもTool Logic変更は対象変更です。

評価Baseline

Sample、正常・異常分類、参照事実、Rubric、評価者Calibration、自動Judge、反復数をSystemと共にVersion化します。

非決定性の変更判断

出力差だけは必ずしも版変更ではありませんが、Alias移動、Knowledge更新、Prompt/Parameter変更、Provider挙動更新は証拠を無効にし得ます。

検収対象版と混同しやすい概念

関連概念違い
バージョン番号識別子です。検収対象版は番号、Component、条件、管理記録を含む正式指定Configuration Baselineです。
最新版時系列上の現在を示すだけで、前段試験未完了や検収中の継続変更があり得ます。
Release Candidate公開経路へ進む候補です。範囲・証拠へBindingして正式指定されたとき本Cycle対象版になります。両者は一致する場合があります。
UAT環境検収を実行する技術・データ条件です。対象版はその中へ配備され判断されるObjectです。
検収基準判定方法を定めます。対象版は判定対象を定めます。同じ基準を複数Revisionへ使えます。
検収済み版開始時点では受験対象にすぎず、完了と権限者署名後に検収済みとなります。
本番版本番で実稼働するObjectです。検収Baselineが変更なく本番へ入ったかはRelease・Deployment記録で証明します。

出典と適用範囲

Acceptance versionは、すべてのSoftware標準で同じ意味を持つ固定用語ではありません。本項目では、正式な受入・検収Cycleの対象として明示指定された、完全で識別可能かつ管理されたSolution Baselineを指します。番号に「検収版」と付けただけのものではなく、最新Build、Release Candidate、UAT環境、検収基準、検収結果、本番版とも異なります。組織が別名称を使っても、対象と管理が同じなら同じ概念です。