-- Views
November 19, 26
スライド概要
よろしくお願い申し上げます。 一流のIT研修講師を目指し、日々研鑽を続けております。 本資料は外部公開用としてご提供するものです。
法人向け実践エンジニアリング研修 | 品質保証・テスト設計編 属人化を防ぎ安全な改修を実現する 自動テストと品質保証の実践講座 商用レベルのWebアプリケーション開発における多層検証パイプラインとテスト設計標準
イントロダクション | 課題提起と受講対象 こんな現場の「悩み」を抱えていませんか? ? 受講前の問いかけ(現場の課題) ・コード修正のたびに「別の場所が壊れていないか」不安になる ・リリース前の手動テストに毎回膨大な工数がかかっている ・特定の担当者しか全体仕様やテスト観点を把握していない 本研修の対象者・ゴール ・Webアプリ開発に携わるエンジニア・テックリード ・テスト自動化を現場へ導入したい開発チーム担当者 ・到達目標 : CI/CDに耐えうる自動検証ゲートを自走構築できる
アジェンダ・研修プログラム構成 本日の講義目次(全6章) 01 Node.jsとモックテストの基礎 実行環境の違いと仮想DOM検証手法 02 テスト設計の原理原則 早期テストとテストピラミッド戦略 03 3段階の自動品質ゲート verify・conformance・ui-smokeの役割 04 CLIオペレーションとWhy/What/How Vitestコマンド活用と学習の目的整理 05 障害切り分けと実機検証の境界 失敗時の初動対応とE2E・負荷試験 06 受講者限定・実務導入特典 明日から現場で使えるスターターキット
公式参考図解:ツールアーキテクチャの全体像 ブラウザ直通パイプラインとマルチパート送信の仕組み ローカルHTML (file://) 中継サーバーなし 1区間ずつ順番に直送 Azure Fast Transcription API 2024-11-15 【リクエスト】 audio (50MB以下・形式別変換) + 定義JSON 【レジリエンス】 429/500系エラー時は最大3回自動リトライ
座学パート①:実行環境の基礎知識 Node.jsとは?ブラウザ外で動くJavaScript実行環境 従来のブラウザ実行 画面操作・DOM描画に特化(手動確認が必要) Node.js(サーバー・CLI実行) OS上で高速動作しビルドや自動テストを自動化 1. 画面を開かずにロジック検証 コマンド1つで数千行のJSコードをミリ秒単位で自動実行できます。 2. npmによる開発ツール統合 Vitestやesbuild等の検証・ビルド基盤を統一管理します。
座学・実務パート:Web3要素とモックテストの仕組み Node.jsでHTML・CSS・JSを疑似再現する実務テスト手法 Web3要素のNode.js上での扱い HTML (構造) : jsdomで仮想DOMを構築し要素取得・イベント検証。 CSS (見た目) : クラス付与やhidden属性による表示切替を検査。 JS (制御) : 単体モジュールを直接importしロジックを高速実行。 モック(疑似応答)テストの実務 通信の差し替え : fetch関数をモック化し本番API課金・通信を遮断。 異常系の意図的再現 : 429(混雑)や500エラーを即座に発生させ検証。 高速・決定論的検証 : ネットワーク遅延ゼロで毎回同じ結果を保証。
座学パート②:ソフトウェアテストの原理原則 プロが押さえる「テスト設計の3大原則」 欠陥の不在証明は不可 リスク優先で検証範囲を設計する。 早期テストの原則 上流工程のバグ検知が修正コスト最小。 テストピラミッド戦略 高速な単体テストを土台に厚く積む。
エンタープライズ開発の鉄則 本番障害を未然に防ぐ「3段階の品質ゲート」 3つの検証ゲート 単体テスト・実データ準拠・画面スモークの全てをパスするまでリポジトリへ統合しない
リリース前検証プロセス コード改修後に必ず通過させる3つの自動検証 1 npm run verify 30件の単体テスト・本番ビルド・仕様整合性チェックを一括実行。 2 npm run conformance 実音声バイナリおよび3時間級の長尺分割処理の準拠性を検証。 3 npm run ui-smoke 配布用シングルHTMLを疑似ブラウザ環境でエンドツーエンド検証。
関心の分離 (Separation of Concerns) 責務ごとに構造化された「30件の単体テストスイート」 10件 core.test.js (純粋ロジック層) 区間計算・ヘッダー生成・指数バックオフ・エラー文言を検証。 8件 mp4.test.js (バイナリ解析層) 無展開でのコンテナ目次 (moov) 解析とADTS変換精度を検証。 5件 pipeline.test.js (統合制御層) 分割からAPI送信・リトライ・結果結合までの一貫処理を検証。 7件 screen.test.js (プレゼンテーション層) UI状態遷移・ボタン排他制御・異常系メッセージ表示を検証。
保守性と技術的負債の抑制 仕様変更に合わせて「テスト名称」もリファクタリングする 実務におけるケーススタディ (pipeline.test.js) 旧仕様のテスト名が残存するリスク 「M4Aは展開が必要」という旧版 (1.1) のテスト名称のまま、実際は新版 (1.2) の「解析不能時のフォールバック挙動」を検証しているケース。 1. テストコードは「生きた仕様書」 チーム開発では、テスト名から現在のシステム仕様を正確に読み取れる状態が必須です。 2. 継続的な名称メンテナンス アサーションが正常でも、実装と名称に乖離が生じた際は次期改修で必ず是正します。
開発生産性を高めるCLIオペレーション 実務で使い分けるVitestテスト実行コマンド一覧 実行コマンド | コマンドの意味・挙動 | 実務での活用シーン npm test | 全テストスイート (30件) を一括実行 | コミット前のデグレード有無を網羅確認 npx vitest run tests/mp4.test.js | 指定ファイル単体のみ実行 | 変更モジュールのピンポイント高速検証 npx vitest run -t "N-03" | 特定文字列 (要件ID等) を含む試験のみ抽出 | 不具合修正時の特定ケース集中デバッグ npx vitest run --reporter=verbose | 全試験項目の詳細名称一覧を出力 | 仕様網羅性の確認と監査エビデンス取得 npx vitest | ファイル保存時に自動再実行 (ウォッチ) | コーディング中の即時フィードバック取得
学習の全体構造整理 なぜ学ぶのか?「Why・What・How」総まとめ WHY (学ぶ意味・目的) 恐怖心と属人化の排除 手作業の限界を超え、誰でも安心して改修・機能追加できる開発体制を築くため。 WHAT (身につける技術) 自動検証と実機試験の設計 Node.jsによる高速な単体・モック検証と、実機E2E試験の最適な役割分担。 HOW (現場での実践手順) 検証ゲートと継続的改善 ウォッチ実行で開発し、コミット前に3段階の自動ゲートを通過させて出荷する。
障害切り分けの思考プロセス テスト失敗時のエラー分析と初動対応フロー AssertionError (期待値不一致) 実装のロジック誤り (デグレード) か、意図的な仕様変更によるテスト側の更新漏れかを切り分ける。 原則:先に仕様書 (spec) を確認し、実装を正す >_ 環境・依存ツールエラー モジュール不足や外部コマンド (ffmpeg等) の未導入による失敗は、環境構築手順に従い復旧する。 対策:npm ciによるロックファイル準拠の再構築
テスト戦略の境界線定義 自動テストの適用範囲と「保証対象外」の明確化 Node.js / 疑似DOMで検証する領域 ・バイナリ切り出しと境界値計算の数学的正確性 ・HTTPステータスに応じたリトライ・例外制御 ・イベント発火に伴うDOM属性・活性状態の遷移 ▲ 自動テスト単体では保証できない領域 ・実ブラウザ (Chrome / Edge) での描画崩れや操作性 ・本番クラウドAPIとの実ネットワーク疎通・認証 ・低メモリ端末 (4GB / 8GB) での実機リソース消費
エンタープライズ品質の担保 自動テストの死角を補完する3つの実機検証工程 E2Eブラウザ実機試験 Selenium自動操作および手動確認で実画面のUI挙動を検証。 商用API結合試験 各音声フォーマットの複数区間連続送信を本番環境で疎通確認。 非機能・限界負荷試験 業務標準スペックPC (4GB・8GB) で長尺処理の安定性を検証。
受講者限定・実務導入特典 明日から現場で即使える「3つの実践スターターキット」 検証ゲート雛形スクリプト verify・smokeの一括実行用package.json設定集。 出荷判定チェックリスト 実機E2Eと低スペック負荷試験の合否基準シート。 1on1 テスト設計レビュー 自部門コードのテスト構成を講師が直接診断。
研修まとめ・現場適用へのアクション 高速な自動検証ゲートと計画的な実機試験の融合が 組織のソフトウェア品質を飛躍させる まずは開発サイクルにテスト駆動のフィードバックループを組み込み、属人化のない開発体制を構築しましょう