コードで学ぶユースケース(アプリケーションサービス)〜DDD実践のためのきほん〜

2022年2月20日2023年11月22日

はじめに

今回はポイント管理システムをテーマに

DDD×クリーンアーキテクチャでサンプルコードを作ったので、

それを使いながら、

ユースケース(アプリケーション)とは何？？どう使う？？

についてまとめました。

動画にもまとめたのでこちらもご覧ください。

ユースケース(アプリケーションサービス)のサンプルコード

今回テーマにしているポイントシステムでは、

店舗からレシート情報とカード、ポイント利用などを連携され、

付与ポイントの加算、ポイント利用の減算などの

ポイント管理ができるシステムを想定しています。

ポイント管理システムのイメージ図

まずは支払登録ユースケースを実現する

サンプルコードを見てみましょう。

支払登録ユースケース

    fun execute(param: Param) {
        receiptNumberDuplicationCheckService.execute(param.receiptNumber)

        val paymentPurchases = param.paymentPurchases.map { PaymentPurchase.create(it.memberCompanyGoodsCode, it.purchaseQuantity, it.goodsPrice) }
        val paymentMethods = param.paymentMethods.map { PaymentMethod.create(it.paymentMethodCode, it.paymentMethodAmount) }
        val payment = paymentFactory.create(
            param.receiptNumber,
            param.paymentDate,
            param.paymentAmount,
            param.memberCode,
            param.usePoints,
            param.shopCode,
            param.couponCode,
            paymentPurchases,
            paymentMethods
        )

        paymentRepository.save(payment)

        val distributionCoupon = distributeCouponRepository.findBy(param.memberCode)
        distributionCoupon?.let { distributeCouponRepository.update(it) }
    }

ドメインサービスを利用してレシート重複チェックをしたり、

ファクトリーを利用してユースケース実現に必要な

支払エンティティを生成したり、

(エンティティ生成時に付与ポイントは算出される)

リポジトリを利用して支払エンティティを永続化したりしています。