Upgrade to Pro — share decks privately, control downloads, hide ads and more …

QAエンジニアもドメイン駆動設計を学ぶ意味.pdf

koppamijinko
November 13, 2026
310

 QAエンジニアもドメイン駆動設計を学ぶ意味.pdf

2026/11/13 TokyoTestFest 2026で発表した資料です

koppamijinko

November 13, 2026

Transcript

24 slides
  1. 自己紹介 - 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
  2. 今回のアプリケーション • • • • いわゆるメモアプリ 機能は、作成・閲覧・編集・削除のみ 発表の都合で、バックエンドのみ 開発環境は下記の通り ◦

    言語:TypeScript ◦ APIテスト:Playwright ◦ コンポーネントテスト:node:test • 今回は、戦術的パターンを用いたリファクタリングを実施した
  3. 元のソースコード - 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: "サーバーエラー" }); } }
  4. 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に埋まってい る。 すると...
  5. バリデーションのために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で書く必要がある
  6. リファクタリング開始、その前に • イベントストーミング で、業務プロセスのモデリングを実施 • イベントストーミングとは? ◦ 複雑なビジネスドメインを協働で探索していくワークショップのこと ◦ 業務イベントに着目して、時系列に並べながら、業務プロセスの探求をし、コマ

    ンドやアクター、リードモデルなどの情報を追加していくことでモデルの理解を 進め、業務の理解をしていきます • なお、今回は時間の都合上、大まかな流れがわかるように抜粋しています
  7. イベントストーミングの結果からリファクタリングを実施 ❖ メモがリードモデルの中心にあるので、 Memoをドメインモデルとして切り出した 1. 2. まずは、APIテストを網羅的に作成する(正常系・準正常系) domain model Memo

    の実装 a. この時TDDでdomain model のコンポーネントテストを先に実装する 3. 4. 5. Memo に対する操作(コマンド)としてusecaseを実装 usecase がMemoを使えるようにするために、Repositoryの実装 全エンドポイントをこの形に揃えるまでリファクタリングを継続
  8. 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); });
  9. 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文字以内です", }); });
  10. 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メソッドの 制約に移すことができた
  11. 最後に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の コンポーネントテストで十分と考えて、省略した
  12. ダウンサイジングによるテストの速度比較 • create のテストで計測 テスト種別 本数 APIテスト実行時間 Compテスト実行時間 正常系 4

    110ms 0.7ms エラー系 9 158ms 1.1ms 合計 13 268ms 1.8ms コンポーネントテストの実行時間は、 APIテストで 機能性担保する時よりも、 150倍速く、テスト実行を進めることができるようになりまし た!(※テスト実行部分のみの比較 (ランナーの起動時間を除く ))
  13. QAエンジニアもプロダクトコードのことを理解していこう! • ドメイン駆動設計やClean Architecture の用語は、多くの機会で見ること ができると思います。 自分のチームのプロダクトのコードに /domain, /usecase のようなディレク

    トリがあれば、そこで何をしているのか、覗いてみてください • 実際のプロダクトコードが読みづらいこともあるので、コンポーネントテスト と一緒に見るといいと思います! もし、コンポーネントテストがなかったら、開発者と一緒に作っていくといい かも?
  14. 私見:これからのQAエンジニアの生き方 • AI時代だからこそ、QAエンジニアはより広い範囲に目を向けていく必要が あると考えています ◦ ドメイン領域 ◦ エンジニアリング領域 ◦ 品質

    / テストの領域 • そして、テストだけで品質保証をしていく時代の終わりであって、あらゆる 知識・経験・手段を使って、品質を作り込んでいくという時代の始まりに なっている と感じてます
  15. 参考文献 • Vlad Khononov 著『ドメイン駆動設計をはじめよう』, オライ リー・ジャパン, 2024 • エリック・エヴァンス著『エリック・エヴァンスのドメイン駆動設

    計』, 翔泳社, 2011 • 成瀬允宣著『ドメイン駆動設計入門 ボトムアップでわかる!ド メイン駆動設計の基本』, 翔泳社, 2020 • マイケル・C・フェザーズ『レガシーコード改善ガイド』, 翔泳社, 2009

More Decks by koppamijinko