設計って技術的にも大変だけど組織的な大変さもあるよねという話

Product Team の竹原です。

みなさん、ドメインのモデリングしてますか？最近私たちのチームでは以下のプレスリリースにある機能の開発に勤しんでいます。

FORCAS、生成AIを活用した新機能「AIセールストーク自動生成」の実証実験を開始 | FORCAS（フォーカス）｜営業DXソリューション｜企業データベースと顧客分析

その開発において、ドメインの理解をしっかり深めないまま開発を続けたためにちょっとつまづいてしまったので、反省も兼ねて記事にまとめてみることにしました。

ドメインの概要

上記のAIセールストーク自動生成機能には以下の図のように、

課題に悩む企業
自社のプロダクトをおすすめしたい FORCAS ユーザー

の2種類の登場人物がいます。

さらに、「このプロダクトの便益によって、この企業課題を解決できそうだ」というものが見つかれば、それらが１対１で紐付いて「マッチング」になります。

そして、「マッチング」をもとに企業課題の概要やプロダクトの概要など様々な情報をかき集めて AI に投げると、晴れて「セールストーク」が生まれます。

今になって図に起こすとシンプルではありますね。

何がどうなってつまづいたのか

つまづいたのは、以下の画像に示す赤枠の領域を実装している最中です。

赤枠のところを実装するためには、バックエンドから以下の情報を取得してくる必要があります。

課題に悩む企業の 企業名
上記企業におすすめできるプロダクトの名称と便益
課題の詳細やプロダクトの便益などを駆使して作られた セールストーク (図中の「具体的な提案内容」)

さて、↑この情報のまとまりをなんと呼べばよいでしょうか？ マッチング？それともセールストーク？みなさんならどちらだと思いますか？

これをなんと呼ぶべきか、の認識がズレていた or 曖昧だったため、認識合わせとコード修正に時間を取られることになってしまいました。

原因1: 既存コードに何も考えず乗っかった

私達がこの開発作業に取り掛かる時点で、以下のような SalesTalk と名前がついているドメインオブジェクトが存在していました。

export class SalesTalk {
  companyName: string,
  productName: string,
  productMerit: string
}

ここに salesTalk というフィールドを追加できれば、上に示した図の赤枠の範囲を実装しきれそうでした。

export class SalesTalk {
  companyName: string,
  productName: string,
  productMerit: string,
  salesTalk: string
}

ここでチームメンバーが以下のような疑問を持ちました。

「セールストークというドメインがよく分からなくなってきました... これはマッチングというドメインと何が違うんでしたっけ？」

改めて整理すると下記のようになります。

セールストークとは
- 企業課題とプロダクトの便益をもとに生成できる文章
マッチングとは
- 企業課題とプロダクトの便益が紐付いているもの

どちらも企業課題やプロダクトの便益が同じように関係したドメインであり、明確に区別しなければ混乱を招く、ということがこの時点でわかりました。

教訓1: ドメインオブジェクトは常に見直そう (特にプロジェクト立ち上げ時期)

上記の会話をしたあと、チーム内でいろいろ整理をして「もともとあった SalesTalk は Matching としたほうがよい」「Matching がフィールドとして salesTalk: string を持つこととしよう」としました。

この結論が正しいか誤りかはさておき、「セールストークとマッチングは何が違うのか」という問題提起があった上で、チーム内で認識を揃えたことが功を奏したと思っています。ドメインオブジェクトを少しずつ作っていく上で、作ってみてから気づくことというのは多々あるはずです。気づきを常にコードに反映するために、違和感などあればすぐ会話していくことが重要かと思います。

原因2: 過去の会話内容がロストした

前述した「SalesTalk は Matching とするのが正しそうだ」という合意は、実は1ヶ月前に会話され合意済のものでした。しかし、その合意をとったメンバーが他のチームへ移動していたり、開発とは別の運用作業やミーティングに呼ばれたりして、チームで合意をとったはずなのに実際はその合意をしたメンバーはチームにおらず、新しくチームに入ってきたメンバーしかいなかった、という状況が生まれていました。

「コレって SalesTalk なんですかね？ Matching では？」
『あれ？それって前に会話して合意しませんでしたっけ？』
「あれ？そうでしたっけ？」
『......あ、合意とったメンバー誰もいなかったですね...』

という会話をあとになって行いました。