Share
Embed
Transcript
24 slides
-
QAエンジニアも ドメイン駆動設計を学ぶ意味 – テストケースのダウンサイジングの実践 – 2026-11-13 (Fri) Tokyo Test Fest
2026 すなかわ a.k.a ミジンコおじさん / sunakawa a.k.a uncle Mijinko -
自己紹介 - Self Introduction ★ ★ ★ ★ Masahiro Sunakawa
X : koppamijinko ★ History ◦ 2014 〜 2018 Tutor of Preparatory School ◦ 2018 〜 2023 Veriserve ◦ 2023 〜 2026 CoDMON ◦ 2026 〜 SmartHR ◦ 2025 〜 Freelance QA Engineer Hobby ◦ Earning points ◦ Long-Term Investment Favorite Test Design Technique ◦ Decision Table Test 2 -
今回のアプリケーション • • • • いわゆるメモアプリ 機能は、作成・閲覧・編集・削除のみ 発表の都合で、バックエンドのみ 開発環境は下記の通り ◦
言語:TypeScript ◦ APIテスト:Playwright ◦ コンポーネントテスト:node:test • 今回は、戦術的パターンを用いたリファクタリングを実施した -
元のソースコード - Controllerに全部の機能が書かれている // メモ作成 async create(req: Request, res: Response)
{ try { const { title, content, tags } = req.body; if (!title || title.trim() === "") { return res.status(400).json({ error: "タイトルは必須です" }); } ... ); return res.status(201).json(result.rows[0]); } catch (e) { return res.status(500).json({ error: "サーバーエラー" }); } } -
Controllerの問題を特定 // メモ作成 async create(req: Request, res: Response) { try
{ const { title, content, tags } = req.body; if (!title || title.trim() === "") { return res.status(400).json({ error: "タイトルは必須です" }); } ... ); return res.status(201).json(result.rows[0]); } catch (e) { return res.status(500).json({ error: "サーバーエラー" }); } } バリデーションが controllerに埋まってい る。 すると... -
バリデーションのためにAPIテストを作る必要が出る test("POST /memos: タイトルがエラーを空の時はエラーを返す", async ({ request }) => {
const newMemo = { title: "", content: "This is a test memo", }; const response = await request.post("/memos", { data: newMemo }); expect(response.status()).toBe(400); }); // 以下、バリデーションのテストをAPIで書く必要がある -
リファクタリング開始、その前に • イベントストーミング で、業務プロセスのモデリングを実施 • イベントストーミングとは? ◦ 複雑なビジネスドメインを協働で探索していくワークショップのこと ◦ 業務イベントに着目して、時系列に並べながら、業務プロセスの探求をし、コマ
ンドやアクター、リードモデルなどの情報を追加していくことでモデルの理解を 進め、業務の理解をしていきます • なお、今回は時間の都合上、大まかな流れがわかるように抜粋しています -
イベントストーミングの結果からリファクタリングを実施 ❖ メモがリードモデルの中心にあるので、 Memoをドメインモデルとして切り出した 1. 2. まずは、APIテストを網羅的に作成する(正常系・準正常系) domain model Memo
の実装 a. この時TDDでdomain model のコンポーネントテストを先に実装する 3. 4. 5. Memo に対する操作(コマンド)としてusecaseを実装 usecase がMemoを使えるようにするために、Repositoryの実装 全エンドポイントをこの形に揃えるまでリファクタリングを継続 -
APIテストの準備=リファクタリングの時のための拠り所 test.beforeEach(async () => { await truncateMemos(); }); test("POST /memos:
新しいメモを作成できる", async ({ request }) => { const newMemo = { title: "Test Memo", content: "This is a test memo", }; const response = await request.post("/memos", { data: newMemo }); expect(response.status()).toBe(201); const body = await response.json(); expect(body).toMatchObject(newMemo); }); -
APIテストにあったテストをコンポーネントテストとして実装 test("タイトルが100文字の時は、Memoを作成できる", () => { const memo = Memo.create("a".repeat(100), "content");
assert.equal(memo.title, "a".repeat(100)); assert.equal(memo.content, "content"); }); test("タイトルが空の時はエラーとなる", () => { assert.throws(() => Memo.create("", "content"), { name: "MemoValidationError", message: "タイトルは必須です", }); }); test("タイトルが101文字以上だと、エラーとなる", () => { assert.throws(() => Memo.create("a".repeat(101), "content"), { name: "MemoValidationError", message: "タイトルは100文字以内です", }); }); -
domain model Memo の実装 export class Memo { id: number;
... static create(title: string, content: string, tags: string[] = []): Memo { ... if (typeof title !== "string" || title.trim() === "") { throw new MemoValidationError ("タイトルは必須です "); } ... title = title.trim(); content = content.trim(); ... return new Memo(id, title, content, tags); } Memoのcreateメソッドの 制約に移すことができた -
最後にusecaseとRepositoryの実装 • usecase export class CreateMemoUsecase { constructor (private readonly
memoRepository : MemoRepository ) {} async execute(input: { title: string; content: string; tags?: string[] }): Promise<Memo> { const memo = Memo.create(input.title, input.content, input.tags); return this.memoRepository .save(memo); } } • repository export interface MemoRepository { save(memo: Memo): Promise<Memo>; } UsecaseやRepositoryもテストを書くこともある。 しかし、今回の規模では APIテストやdomainの コンポーネントテストで十分と考えて、省略した -
ダウンサイジングによるテストの速度比較 • create のテストで計測 テスト種別 本数 APIテスト実行時間 Compテスト実行時間 正常系 4
110ms 0.7ms エラー系 9 158ms 1.1ms 合計 13 268ms 1.8ms コンポーネントテストの実行時間は、 APIテストで 機能性担保する時よりも、 150倍速く、テスト実行を進めることができるようになりまし た!(※テスト実行部分のみの比較 (ランナーの起動時間を除く )) -
改めて、テストのダウンサイジングをしてみて • プロダクトコードを書いたり、修正した経験がないと重い腰は上がらないで すよね...(多分ここにいる多くの人はそう) • コンポーネントテストに書くべきものって、やっぱり開発者と AIに担保してもらいたいなと感じました でも... • 品質を上げていくためには、QAエンジニアがコンポーネントテストに対し
て、もう少し向き合っていく必要があると感じました • そのためには、ドメイン駆動設計やアーキテクチャ設計を 学び、開発者の視点も持つことが重要だと感じてます! -
QAエンジニアもプロダクトコードのことを理解していこう! • ドメイン駆動設計やClean Architecture の用語は、多くの機会で見ること ができると思います。 自分のチームのプロダクトのコードに /domain, /usecase のようなディレク
トリがあれば、そこで何をしているのか、覗いてみてください • 実際のプロダクトコードが読みづらいこともあるので、コンポーネントテスト と一緒に見るといいと思います! もし、コンポーネントテストがなかったら、開発者と一緒に作っていくといい かも? -
私見:これからのQAエンジニアの生き方 • AI時代だからこそ、QAエンジニアはより広い範囲に目を向けていく必要が あると考えています ◦ ドメイン領域 ◦ エンジニアリング領域 ◦ 品質
/ テストの領域 • そして、テストだけで品質保証をしていく時代の終わりであって、あらゆる 知識・経験・手段を使って、品質を作り込んでいくという時代の始まりに なっている と感じてます -
まとめ • 開発職種の知識(今回はドメイン駆動設計)を活用して、テストのダウンサイ ジングを行うことができました • 自分たちのプロダクトを是非深く理解していくことで、テストの幅を広げてい くことができると考えてます • AI時代は、総合知こそが品質保証の真髄になると考えている。 そのためには、
QAエンジニアも開発の他職種の知識を学んでいくことは 重要だと思っています -
参考文献 • Vlad Khononov 著『ドメイン駆動設計をはじめよう』, オライ リー・ジャパン, 2024 • エリック・エヴァンス著『エリック・エヴァンスのドメイン駆動設
計』, 翔泳社, 2011 • 成瀬允宣著『ドメイン駆動設計入門 ボトムアップでわかる!ド メイン駆動設計の基本』, 翔泳社, 2020 • マイケル・C・フェザーズ『レガシーコード改善ガイド』, 翔泳社, 2009