大局からコードへ：C4モデルを活用したソフトウェアアーキテクチャの可視化入門ガイド

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml

title PayQuick - システムコンテキスト図

Person(customer, "個人顧客", "アプリを使って送金や請求書の支払いを行う")
Person(merchant, "加盟店", "顧客からの支払いを受け取る")

System_Boundary(payquick, "PayQuickプラットフォーム") {
    System(payquick_system, "PayQuick", "顧客が支払いと送金を行うことを可能にする")
}

System_Ext(bank_system, "銀行ネットワーク", "銀行間送金を処理する", $tags="外部")
System_Ext(sms_gateway, "Twilio SMS", "取引通知を送信する", $tags="外部")
System_Ext(email_service, "SendGrid", "メール領収書を送信する", $tags="外部")

Rel(customer, payquick_system, "送金、請求書の支払い、取引の確認")
Rel(merchant, payquick_system, "支払いの受領、返金の発行")
Rel(payquick_system, bank_system, "API経由で送金を処理")
Rel(payquick_system, sms_gateway, "HTTPS経由でOTPおよび通知を送信")
Rel(payquick_system, email_service, "SMTP経由で領収書を送信")

LAYOUT_WITH_LEGEND()
@enduml

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml

title PayQuick - コンテナ図

Person(customer, "顧客", "モバイルアプリまたはWebインターフェースを使用")
Person(merchant, "merchant", "Webダッシュボードを使用")

System_Boundary(payquick, "PayQuickプラットフォーム") {
    Container(mobile_app, "モバイルアプリ", "React Native, TypeScript", "顧客向けのユーザーインターフェースを提供")
    Container(web_app, "Webアプリケーション", "React, TypeScript", "管理者およびmerchant用ダッシュボードを提供")
    
    Container_Boundary(api, "APIアプリケーション") {
        Container(api_gateway, "APIゲートウェイ", "Node.js, Express", "ルーティング、認証、レート制限を処理")
        Container(payment_service, "決済サービス", "Spring Boot, Java", "決済および送金処理")
        Container(notification_service, "通知サービス", "Python, FastAPI", "SMSおよびメール通知を送信")
    }
    
    ContainerDb(database, "データベース", "PostgreSQL", "ユーザーアカウント、取引、残高を保存")
    ContainerDb(cache, "キャッシュ", "Redis", "セッションデータおよび頻繁にアクセスされるレコードを保存")
    ContainerQueue(queue, "メッセージキュー", "RabbitMQ", "非同期通知処理を処理")
}

System_Ext(bank_api, "銀行API", "外部銀行連携")
System_Ext(sms_provider, "Twilio SMS API")

Rel(customer, mobile_app, "使用", "HTTPS")
Rel(merchant, web_app, "使用", "HTTPS")
Rel(mobile_app, api_gateway, "APIコールを実行", "HTTPS/JSON")
Rel(web_app, api_gateway, "APIコールを実行", "HTTPS/JSON")
Rel(api_gateway, payment_service, "リクエストをルーティング", "gRPC")
Rel(api_gateway, notification_service, "リクエストをルーティング", "gRPC")
Rel(payment_service, database, "データの読み書き", "JDBC")
Rel(payment_service, cache, "頻繁にアクセスされるデータをキャッシュ", "Redisプロトコル")
Rel(notification_service, queue, "イベントを公開", "AMQP")
Rel(notification_service, sms_provider, "SMSを送信", "REST API")
Rel(payment_service, bank_api, "送金処理", "HTTPS")
@enduml

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml

title PayQuick - 決済サービスコンポーネント図

!define C4ShapeInRow 4
!define C4BoundaryInRow 1

Container_Boundary(payment_service, "決済サービス") {
    Component(payment_controller, "決済コントローラー", "Spring RESTコントローラー", "着信する決済リクエストを処理")
    Component(transaction_manager, "トランザクションマネージャー", "Springサービス", "決済ワークフローを調整")
    Component(fraud_detector, "不正検出サービス", "Springサービス", "不正の可能性がある取引を検証")
    Component(balance_calculator, "残高計算機", "Springサービス", "アカウント残高を計算および更新")
    Component(validation_service, "検証サービス", "Springサービス", "決済データおよびビジネスルールを検証")
    
    ComponentDb(transaction_repo, "取引リポジトリ", "Spring Data JPA", "取引記録を保存")
    ComponentDb(account_repo, "アカウントリポジトリ", "Spring Data JPA", "アカウントデータを管理")
    ComponentDb(fraud_repo, "不正ルールリポジトリ", "Spring Data JPA", "不正検出ルールを保存")
    
    Component(notification_client, "通知クライアント", "Feignクライアント", "通知サービスを呼び出し")
    Component(bank_client, "銀行クライアント", "Feignクライアント", "外部銀行APIと統合")
}

Rel(payment_controller, transaction_manager, "決済リクエストを転送")
Rel(transaction_manager, fraud_detector, "取引を検証するために")
Rel(transaction_manager, validation_service, "データを検証するために")
Rel(transaction_manager, balance_calculator, "残高を更新するために")
Rel(transaction_manager, transaction_repo, "取引を保存するために")
Rel(balance_calculator, account_repo, "アカウントデータを読み書きするために")
Rel(fraud_detector, fraud_repo, "ルールを照合するために")
Rel(transaction_manager, notification_client, "通知を送信するために")
Rel(transaction_manager, bank_client, "外部送金を処理するために")

@enduml

@startuml
title 不正検出サービス - クラス図

class 不正検出サービス {
    - 不正ルールリポジトリ fraudRepo
    - 取引リポジトリ txnRepo
    + checkFraud(txn: 取引): 不正結果
    - evaluateRules(txn: 取引): List<ルール>
    - calculateRiskScore(txn: 取引): Double
    - isVelocityExceeded(userId: String): Boolean
}

class 不正結果 {
    + isBlocked: boolean
    + riskScore: double
    + blockedRules: List<String>
    + getRiskLevel(): リスクレベル
}

class 不正ルール {
    + id: Long
    + ruleName: String
    + threshold: Double
    + isEnabled: boolean
    + evaluate(txn: 取引): boolean
}

class 取引 {
    + id: String
    + amount: BigDecimal
    + userId: String
    + timestamp: DateTime
    + merchantId: String
}

不正検出サービス --> 不正結果 : 戻り値
不正検出サービス --> 不正ルール : 使用
不正検出サービス --> 取引 : 検証
不正結果 ..> 不正ルール : 含む

@enduml