ボックスのドラッグを止める：VPasCode と AI チャットボットによる C4 ダイアグラムの生成

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

title システムコンテキスト：オンラインバンキングプラットフォーム

Person(customer, "銀行顧客", "口座を確認し、送金し、請求書を支払う")
Person(admin, "バックオフィス管理者", "ユーザーを管理し、取引を監視する")

System(banking, "オンラインバンキングプラットフォーム", "ウェブとモバイルを通じてインターネットバンキングサービスを提供する")

System_Ext(coreLegacy, "コアバンキングメインフレーム", "取引を処理し、マスター台帳を保持する")
System_Ext(email, "メールサービス", "通知と明細を送信する")
System_Ext(oauth, "OAuth2プロバイダー", "IDと認証を処理する")

Rel(customer, banking, "使用する", "HTTPS/WebSocket")
Rel(admin, banking, "管理する", "HTTPS")
Rel(banking, coreLegacy, "読み取り/書き込み", "REST/SOAP")
Rel(banking, email, "アラートを送信", "SMTP/API")
Rel(banking, oauth, "認証を行う", "OIDC")

@enduml

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

title コンテナ図：オンラインバンキングプラットフォーム

Person(customer, "銀行顧客")

System_Boundary(banking, "オンラインバンキングプラットフォーム") {
    Container(webapp, "Webアプリケーション", "React + Node.js", "ブラウザベースのバンキング用のSPA")
    Container(mobile, "モバイルアプリ", "Flutter", "iOS/Androidネイティブ体験")
    Container(api, "APIゲートウェイ", "Kong", "リクエストのルーティング、レート制限、認証検証")
    Container(service, "口座サービス", ".NET 8", "口座と残高のビジネスロジック")
    Container(cache, "セッションキャッシュ", "Redis", "JWTトークンとセッション状態を保存")
    ContainerDb(db, "口座データベース", "PostgreSQL", "顧客口座、残高、取引")
    ContainerQueue(events, "イベントバス", "RabbitMQ", "非同期取引通知")
}

System_Ext(oauth, "OAuth2プロバイダー")
System_Ext(legacy, "コアバンキングメインフレーム")

Rel(customer, webapp, "使用する", "HTTPS")
Rel(customer, mobile, "使用する", "HTTPS")
Rel(webapp, api, "呼び出す", "REST/JSON")
Rel(mobile, api, "呼び出す", "REST/JSON")
Rel(api, oauth, "トークンを検証", "OIDC")
Rel(api, service, "ルーティング先", "gRPC")
Rel(service, cache, "セッションを読み書き", "TCP")
Rel(service, db, "クエリ", "SQL/TCP")
Rel(service, events, "公開", "AMQP")
Rel(service, legacy, "台帳を同期", "SOAP")

@enduml

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

title コンポーネント図：アカウントサービス (.NET 8)

Container(api, "API ゲートウェイ", "Kong")
ContainerDb(db, "アカウント DB", "PostgreSQL")
ContainerQueue(events, "イベントバス", "RabbitMQ")

Component(auth, "認証ミドルウェア", "ASP.NET Filter", "JWT の検証、ユーザーコンテキストの抽出")
Component(controller, "AccountController", "ASP.NET API", "/accounts 用の REST エンドポイント")
Component(domain, "AccountDomainService", "C# クラスライブラリ", "残高計算、送金ルール")
Component(repo, "AccountRepository", "EF Core", "データアクセス、クエリ最適化")
Component(publisher, "EventPublisher", "MassTransit", "TransactionCompleted イベントの発行")

Rel(api, auth, "リクエストの転送")
Rel(auth, controller, "認証済みリクエストの転送")
Rel(controller, domain, "ビジネスロジックの呼び出し")
Rel(domain, repo, "照会/永続化")
Rel(repo, db, "SQL の実行")
Rel(domain, publisher, "ドメインイベントの発行")
Rel(publisher, events, "発行", "AMQP")

@enduml

# GitHub Action の例スニペット
- name: C4 図のレンダリング
  run: |
    vp-cli render -i docs/architecture/c4/*.puml 
                  -o docs/architecture/output/ 
                  -f svg --c4-layout auto