マインドマップギャラリー 情報システムの文書化と構成管理
ソフトウェア プロジェクト管理プロセス中に生成されるドキュメントがどのように分類および管理されるか、構成管理を行う方法、および構成管理で実行する手順が簡単にリストされており、必要に応じて収集できます。
2021-08-23 10:05:43 に編集されました
情報システム関連書類
書類の種類
開発ドキュメント
開発ドキュメントには、開発プロセス自体が記述されており、次の 8 つの側面が含まれます。
実現可能性調査レポートとプロジェクトのミッションステートメント
要求仕様
機能仕様
プログラム仕様やデータ仕様などの設計仕様
開発計画
ソフトウェアの統合とテストの計画
品質保証計画
安全性と試験に関する情報
製品ドキュメント
製品ドキュメントは開発プロセスの製品について説明しており、基本的に次の 4 つの側面が含まれています。
トレーニングマニュアル
リファレンスマニュアルとユーザーガイド
ソフトウェアサポートマニュアル
製品パンフレットや情報広告
文書の管理
管理文書にはプロジェクト管理のための情報が記録されています
開発プロセスの各段階における進捗状況と進捗状況の変化の記録
ソフトウェア変更の記録
開発チームの責任の定義
プロジェクト計画、プロジェクトフェーズレポート
構成管理計画
文書の品質評価
最小限のドキュメント (レベル 1 ドキュメント)。開発ワークロードが 1 人月未満の開発者に適しています。プログラムリスト、開発記録、テストデータ、プログラム紹介が含まれます。
内部ドキュメント (レベル 2 ドキュメント)。他のユーザーとリソースを共有しない専用プログラムで利用できます。レベル 1 のドキュメントで提供される情報に加えて、レベル 2 のドキュメントには、ユーザーがプログラムをインストールして使用する際に役立つ十分なコメントがプログラム リスト内に含まれています。
作業文書 (レベル 3 文書)。同じユニット内の複数の人が共同開発したプログラム、または他のユニットで使用できるプログラムに適しています。
正式なドキュメント (レベル 4 ドキュメント)。一般向けに正式にリリースされるソフトウェア製品に適しています。
文書管理のルールと方法
文書作成基準
アイコンの番号付け規則
ドキュメントディレクトリの記述基準
文書管理システム
構成管理
意味
構成管理は、構成の変更を体系的に制御し、システムのライフサイクル全体にわたる構成の整合性とトレーサビリティを維持するために、さまざまな時点でのシステム構成を識別する規律です。
構成管理アクティビティ
構成管理は 6 つのアクティビティで構成されます
構成管理計画の作成、構成の識別、構成制御、構成ステータスのレポート、構成の監査、リリース管理および配信
設定項目
外部から提供されるソフトウェア製品およびデータ
指定された内部ソフトウェア作業成果物およびデータ
ソフトウェア製品の作成またはサポートに使用される指定されたサポート ツール
サプライヤー/サプライヤーが提供するソフトウェアと顧客が提供する機器/ソフトウェア
番組企画提案
要件文書
設計ドキュメント
ソースコード
実行可能コード
テストケース
ソフトウェアを動作させるために必要な各種データ
すべての構成アイテムの操作権限は構成管理者によって管理され、ベースライン構成アイテムは開発者向けの読み取り専用権限で開発されます。非ベースライン構成アイテムは PM、CCB、および関連担当者によって開発されます。
設定項目のステータス
構成項目の状態は「草案」、「正式」、「修正」の3種類に分類できます。
構成アイテムのバージョン番号
「ドラフト」ステータスの設定項目のバージョン番号の形式は 0.YZ で、YZ の番号範囲は 01 ~ 99 です。
「公式」状態の構成アイテムのバージョン番号形式は X.Y です。X はメインのバージョン番号で、値の範囲は 1 ~ 9 です。 Y はマイナー バージョン番号で、値の範囲は 0 ~ 9 です。
構成アイテムが初めて「公式」ファイルになるとき、バージョン番号は 1.0 です。
「変更済み」状態の構成アイテムのバージョン番号形式は X.YZ です。構成アイテムを変更する場合、通常は Z 値のみが増加し、X.Y 値は変更されません。設定項目が変更され、ステータスが「正式」になった場合は、Z 値を 0 に設定し、X.Y 値を増加させます。
構成アイテムのバージョン管理
構成ベースライン
ベースラインは通常、開発プロセスのマイルストーンに対応します
外部顧客に提供されるベースラインは一般にリリース ベースラインと呼ばれ、内部開発に使用されるベースラインは一般に構築ベースラインと呼ばれます。
ベースラインを確立するイベント
制御された構成アイテム
ベースラインの確立および変更の手順
ベースラインへの変更を承認するために必要な権限
各ベースラインが定義するもの
ベースラインは開発作業の固定点とスナップショットを提供します
新しいプロジェクトは、ベースラインによって提供される固定ポイントで作成できます。新しいプロジェクトは、元のプロジェクト (メイン ブランチ上) に対する後続の変更から分離された、別個のブランチとして機能します。
ベースラインは、アップデートが不安定または信頼できないと判断された場合に変更をキャンセルする方法をチームに提供します。
ベースライン化を使用すると、特定のリリースに基づいて構成を再確立し、報告されたバグを再現できます。
ベースラインを確立する利点
構成ライブラリ
開発ライブラリ
動的ライブラリまたは作業ライブラリ。開発者が現在開発中の構成エンティティを保存するために使用されます。
ダイナミック ライブラリは開発者の個人的なワークスペースであり、構成制御なしで開発者によって制御されます。
管理されたライブラリ
現在のベースラインとベースラインへの変更を含むマスター ライブラリになります。
制御ライブラリ内の構成アイテムは完全な構成管理下に置かれます
開発の特定の段階の終了時に、現在の作業成果物は管理されたライブラリに保存されます。
製品ライブラリ
静的ライブラリ、リリース ライブラリ、ソフトウェア ウェアハウスとも呼ばれ、リリースおよび使用されたさまざまなベースラインのアーカイブが含まれており、完全な構成管理下に置かれます。
開発された情報システム製品は、システムテストを完了した後、最終製品として製品ライブラリに保管され、ユーザーへの納品や現場での設置を待ちます。
データベースを構築する
データベースの構築モードには、構成アイテムの種類ごとにデータベースを構築する方法と、タスクごとにデータベースを構築する方法の 2 つがあります。
構成項目の種類に応じたデータベース構築:製品継承が強く、一般的なソフトウェア開発組織に適しています
開発タスクに応じて対応する構成ライブラリを確立するため、この設定戦略はより柔軟です。
ライブラリの権限設定を構成する
構成制御ボードCCB
構成変更の評価、承認、および承認された変更の実装の監督を担当します。
CCB はプロジェクト レベルで設立され、そのメンバーにはプロジェクト マネージャー、ユーザー代表、製品マネージャー、開発エンジニア、テスト エンジニア、品質管理担当者、構成管理者などが含まれます。
CCB は、構成変更を制御する代わりに、ベースラインの承認や構成管理計画の承認など、より多くの構成管理タスクを担当します。
管理者 CMO の構成
構成管理計画を作成する
構成管理システムを確立および維持する
構成ライブラリの作成と保守
構成項目の識別
ベースラインの確立と管理
バージョン管理と構成制御
ステータスレポートを構成する
監査の構成
リリース管理と配信
プロジェクトメンバーに構成管理トレーニングを提供する
構成管理システム
構成管理に使用されるソフトウェア システムです。
構成管理ポリシー
構成管理の目標を決定する
ソフトウェア構成管理計画が作成され、関連担当者によってレビューおよび確認されていることを確認します。
管理対象のプロジェクト成果物を特定し、適切な担当者がこれらのプロジェクト成果物を確実に入手できるように、関連する管理戦略を策定する必要があります。
プロジェクト製品が管理された制限内で確実に変更されるように、管理戦略を策定する必要があります。
関連するグループや個人がソフトウェア ベースラインのステータスと内容をタイムリーに理解できるように、適切なツールと方法を採用する必要があります。
構成管理のポリシーを決定する
日常的な構成管理アクティビティ
構成管理計画を作成する
構成管理アクティビティ。主なアクティビティには、構成の識別、構成の制御、構成ステータスのレポート、構成の監査、リリース管理および配信が含まれます。
これらの活動を実施するための規範とプロセス
活動実施スケジュール
これらの活動の実行に責任を負う人々または組織、および他の組織との関係
構成管理計画には何が含まれますか?
構成アイテムID
制御する必要がある構成項目を特定する
各構成アイテムに一意の識別番号を指定します
各構成アイテムの重要な特性を定義する
各構成アイテムの所有者とその責任を決定する
構成アイテムが構成管理に入る時期と条件を決定する
ベースラインの確立と管理
ドキュメントおよびコンポーネントのリビジョンと製品バージョンとの関係を維持する
構成項目の識別は構成管理者の責任であり、次の手順を含める必要があります。
構成制御
変更要求
変更評価
プロジェクトに対する変更の影響
変更は必要ですか?
変更の範囲は十分に検討されていますか?
変更の実施計画は実現可能ですか?
変更作業の見積もりは妥当ですか?
CCB組織が変更申請を評価する際に決定する必要がある内容
CCB は変更を受け入れるかどうかを決定し、関連担当者に決定を通知します。
評価結果の通知
変更の実装
変更の検証と確認
変更リリース
構成リポジトリベースの変更管理
アップグレードするベースライン (バージョン番号が V2.1 であると仮定) を製品ライブラリから取り出し、管理ライブラリに入れます。
プログラマは、変更するコード セグメントを管理されたライブラリからチェックアウトし、それを変更のために独自の開発ライブラリに入れます。
コードはチェックアウトされると「ロック」され、A が同じコードを同時に変更できるのは 1 人のプログラマーのみであるため、B はチェックアウトできません。
プログラマは、開発ライブラリ内の変更されたコード セグメントを制御ライブラリにチェックインします。チェックイン後、コードの「ロック」が解除され、他のプログラマがコードをチェックアウトできるようになります。
ソフトウェア製品のすべてのアップグレードおよび変更作業が完了すると、管理ライブラリ内の新しいベースラインが製品ライブラリに保存されます (ソフトウェア製品のバージョン番号は V2.2 に更新され、古い V2.1 バージョンは削除され、製品ライブラリに引き続き保存されます)
特定のソフトウェア製品のアップグレードを例として、構成ライブラリの変更制御について説明します。
ステータスレポートを構成する
制御される各構成アイテムの ID とステータス
各変更依頼の状況と承認された変更の実施状況
各ベースラインの現在および過去のバージョンのステータスとバージョンの比較
その他の構成管理プロセスのアクティビティの記録
ステータスレポートに含まれる内容の構成
監査の構成
効果
不適切な商品がユーザーに提供されることを防止する
不完全な実装を発見する
各構成アイテムがベースラインに含まれており、必要な品質管理レビュー後にライブラリに保存されていることを確認します。
記録と文書がトレーサビリティを維持していることを確認する
機能構成の監査
構成アイテムの開発は正常に完了しました
構成アイテムは、構成識別で指定されたパフォーマンスおよび機能特性を達成しています。
構成アイテムの操作およびサポートに関するドキュメントが完全であり、準拠している
構成アイテムの整合性(構成アイテムの実際の機能が要件と一致しているかどうか)を監査するためです。
物理構成の監査
納品対象の構成アイテムが存在するか
構成アイテムに必要な項目がすべて含まれているかどうか
構成アイテムの整合性 (構成アイテムの物理的な存在が期待と一致しているかどうか) を監査するためです。
リリース管理と配信
ストレージ
紛失のリスクを軽減するために、コピーを管理された別の場所に保管します。
コピー
レプリケーションの一貫性と整合性を確保するための手順を確立する
公開に使用されるメディアに無関係なアイテムが含まれていないことを確認してください
適切なメディアを使用して、ソフトウェア製品が複製要件に準拠し、配信期間全体にわたってそのコンテンツの完全性が保証されるようにします。
パック
届ける
復興
構成管理ツール
オープンソース ツール: SVN、GIT、CVS
情報文書管理と構成管理