テキストからアーキテクチャへ：アジャイルチームのための Visual Paradigm の VPasCode 習得

@startuml

クラス Library {
  - name: String
  - address: String
  - phone: String
  + addMember(member: Member): void
  + removeMember(memberId: String): void
  + addItem(item: LibraryItem): void
  + removeItem(itemId: String): void
  + lendItem(memberId: String, itemId: String): boolean
  + returnItem(itemId: String): boolean
}

クラス LibraryItem {
  # itemId: String
  # title: String
  # publisher: String
  # publicationYear: int
  # isAvailable: boolean
  + getDetails(): String
  + setAvailability(status: boolean): void
}

抽象クラス Book {
  - isbn: String
  - author: String
  - pageCount: int
  + getAuthor(): String
}

クラス EBook {
  - fileSizeMB: double
  - format: String
  - downloadUrl: String
  + download(): void
}

クラス PrintedBook {
  - shelfLocation: String
  - condition: String
  + getShelfLocation(): String
}

クラス Magazine {
  - issueNumber: int
  - volumeNumber: int
  - coverDate: Date
}

クラス DVD {
  - durationMinutes: int
  - director: String
  - language: String
  - subtitlesAvailable: boolean
}

クラス Member {
  - memberId: String
  - name: String
  - email: String
  - phone: String
  - membershipDate: Date
  + borrowItem(item: LibraryItem): boolean
  + returnItem(item: LibraryItem): boolean
  + getBorrowedItems(): List
}

クラス BorrowingRecord {
  - recordId: String
  - borrowDate: Date
  - dueDate: Date
  - returnDate: Date
  - isOverdue(): boolean
  - calculateFine(): double
}

クラス Fine {
  - fineId: String
  - amount: double
  - issueDate: Date
  - isPaid: boolean
  + payFine(): void
}

クラス Librarian {
  - staffId: String
  - department: String
  + processBorrowing(member: Member, item: LibraryItem): void
  + processReturn(item: LibraryItem): void
  + generateReport(): void
  + manageInventory(): void
}

' 継承関係
LibraryItem <|-- Book
LibraryItem <|-- Magazine
LibraryItem <|-- DVD
Book <|-- EBook
Book <|-- PrintedBook 

' 合成と集約 

Library "1" -- "many" Member : 所有 >
Library "1" -- "many" LibraryItem : 含む >
Library "1" -- "many" Librarian : 雇用 >

Member "1" -- "many" BorrowingRecord : 持つ >
BorrowingRecord "1" -- "1..*" LibraryItem : 参照 >
BorrowingRecord "1" -- "0..*" Fine : 生成 >

' 関連
Librarian --> BorrowingRecord : 管理 >
Member --> BorrowingRecord : 作成 >

note top of Library : メンバー、資料、貸出を管理する
中央システム
note right of LibraryItem : すべての図書館資料の
抽象基底クラス
@enduml

@startuml
' タイトル
title ATM 現金引き出し - シーケンス図

' アクターと参加者
actor Customer as C
participant "ATM" as ATM
participant "銀行システム" as BS
database "顧客口座" as DB

' シーケンス
C -> ATM : カード挿入
ATM -> ATM : カード詳細読み取り
ATM -> C : PIN 入力プロンプト
C -> ATM : PIN 入力
ATM -> BS : カードと PIN の検証
BS -> DB : 認証情報の確認
DB --> BS : 検証結果

alt 無効な PIN
    BS --> ATM : 無効な PIN
    ATM -> C : 無効な PIN、再試行
    note right: 3 回の失敗後、nカードを保持
else 有効な PIN
    BS --> ATM : 有効な PIN
    ATM -> C : メインメニュー表示
    C -> ATM : 引き出しを選択
    ATM -> C : 金額要求
    C -> ATM : 金額入力
    ATM -> BS : 残高と限度額確認
    BS -> DB : 残高照会
    DB --> BS : 現在の残高
    
    alt 資金不足
        BS --> ATM : 残高不足
        ATM -> C : 取引拒否n(残高表示)
        C -> ATM : 取引キャンセル
        ATM -> C : カード返却
    else 資金充足
        BS --> ATM : 承認
        ATM -> ATM : 現金dispense
        ATM -> C : 現金dispense
        C -> ATM : 現金受け取り
        ATM -> BS : 現金dispense確認
        BS -> DB : 口座引き落とし＆取引ログ
        DB --> BS : 更新完了
        BS --> ATM : 取引完了
        ATM -> C : 領収書印刷
        alt 領収書希望
            C -> ATM : 領収書受け取り
        else 領収書不要
            C -> ATM : 領収書拒否
        end
        ATM -> C : カード返却
        C -> ATM : カード受け取り
    end
end

ATM -> C : ありがとう / 取引終了

@enduml

@startuml InsuranceClaimSystem

開始

:被保険者が請求を提出;
:請求がシステムに登録されます;

if (契約は有効で有効ですか？) then (yes)
  :調整者に請求を割り当て;
  :調整者に新しい請求を通知;
else (no)
  :被保険者に拒否通知を送信;
  :理由を記録：契約無効/無効;
  終了
endif

:調整者が提出された書類をレビュー;

if (すべての必要な書類が揃っていますか？) then (yes)
  :調整者が請求検証を開始;
else (no)
  :被保険者に不足書類を要求;
  :追加書類を待機;
  :書類を再確認;
  note right
    システムは待機中
    被保険者の応答
  end note
  -> "調整者が提出された書類をレビュー"へ戻る;
endif

:調整者が請求を調査;
:必要に応じて証人/専門家に連絡;
:損害/損失額を見積もります;

if (契約条件に基づき請求は有効ですか？) then (yes)
  :承認金額を計算;
  :適用可能な場合、免責金額を適用;
else (no)
  :理由付きで拒否通知を送信;
  :決定をシステムに記録;
  終了
endif

:和解案を生成;
:和解案を被保険者に送信;

:被保険者が和解案をレビュー;

if (被保険者は和解案を受諾しますか？) then (yes)
  :支払い処理;
  :請求ステータスを「決済済み」に更新;
  :被保険者に確認を送信;
  :決済詳細を記録;
else (no)
  :紛争解決へエスカレート;
  :和解を交渉;
  :和解案を更新;
  -> "和解案を被保険者に送信"へ戻る;
endif

終了

@enduml

@startuml SmokeDetectionSystem

title 状態図 - 煙検出システム

[*] --> PowerOff

state PowerOff {
    [*] --> NoPower
    NoPower : デバイスがオフ
    NoPower --> PowerOn : 電源ボタンが押される
}

state PowerOn {
    [*] --> Standby
    Standby : システム準備完了
    Standby --> SelfCheck : 定期的な自己診断（24 時間ごと）
    Standby --> Monitoring : 監視開始（センサー有効）
    
    state SelfCheck {
        [*] --> TestingSensors
        TestingSensors --> TestPass : すべてのセンサー OK
        TestingSensors --> TestFail : センサーエラー検出
        TestPass --> Standby : スタンバイに戻る
        TestFail --> ErrorState : エラー報告
    }
    
    state Monitoring {
        [*] --> NoSmoke
        NoSmoke : 通常動作
        NoSmoke --> SmokeDetected : 煙レベル > 閾値
        NoSmoke --> LowBattery : バッテリー残量低下（ワイヤレス）
        LowBattery --> NoSmoke : バッテリー交換
        
        state SmokeDetected {
            [*] --> InitialAlert
            InitialAlert --> ConfirmedSmoke : 煙が 5 秒以上持続
            InitialAlert --> FalseAlarm : 煙が 5 秒未満で消滅 FalseAlarm --> NoSmoke : リセット
            ConfirmedSmoke --> AlarmActive
        }
        
        state AlarmActive {
            [*] --> SoundAlarm : サイレンとライトを起動
            SoundAlarm --> SendNotification : コントロールパネル/アプリに通知
            SendNotification --> WaitForReset
            WaitForReset --> AlarmActive : 煙がまだ検出される
            WaitForReset --> ResetSystem : リセットボタンが押される
            ResetSystem --> NoSmoke : システムがリセット
        }
    }
}

state ErrorState {
    [*] --> FaultIndicator : エラー LED を点滅
    FaultIndicator --> PowerOff : 手動電源サイクルが必要
}

PowerOn --> ErrorState : 自己診断失敗
ErrorState --> PowerOff : 電源サイクル

PowerOff --> [*] : システム unplugged / バッテリー取り外し

@enduml

@startuml CourierSystem

title 宅配便システム - コンポーネント図

' === コンポーネント ===
component "顧客アプリ" as CustomerApp
component "宅配業者モバイルアプリ" as CourierApp
component "管理者 Web ダッシュボード" as AdminWeb

component "API ゲートウェイ" as ApiGateway

component "注文サービス" as OrderService
component "配送サービス" as DispatchService
component "追跡サービス" as TrackingService
component "決済サービス" as PaymentService
component "通知サービス" as NotificationService
component "ユーザーサービス" as UserService

component "メッセージキューn(RabbitMQ/Kafka)" as MessageQueue
component "Redis キャッシュ" as RedisCache

database "PostgreSQL DB" as SQLDB
database "MongoDBn(ログ/追跡履歴)" as MongoLogs

' === インターフェース / ポート ===
CustomerApp --> ApiGateway : "REST / WebSocket"
CourierApp --> ApiGateway : "REST / WebSocket"
AdminWeb --> ApiGateway : "REST"

ApiGateway --> OrderService
ApiGateway --> TrackingService
ApiGateway --> PaymentService
ApiGateway --> UserService

' === サービス依存関係 ===
OrderService --> DispatchService : "gRPC / REST"
OrderService --> PaymentService
OrderService --> NotificationService
OrderService --> SQLDB : "JDBC"
OrderService --> RedisCache : "キャッシュ"

DispatchService --> MessageQueue : "イベント公開"
DispatchService --> CourierApp : "API ゲートウェイ経由でプッシュ"
DispatchService --> SQLDB

TrackingService --> MessageQueue : "位置情報更新を購読"
TrackingService --> MongoLogs : "追跡履歴の書き込み"
TrackingService --> RedisCache : "現在の位置情報キャッシュ"

PaymentService --> SQLDB
PaymentService --> NotificationService

NotificationService --> MessageQueue : "通知の消費"
NotificationService --> CustomerApp : "API ゲートウェイ経由でプッシュ"

UserService --> SQLDB
UserService --> RedisCache

' === 注釈 ===
note right of OrderService
  パッケージ作成、
  価格設定、注文ステータスの処理
end note

note right of DispatchService
  注文と宅配業者のマッチング、
  ルートの最適化
end note

note bottom of MessageQueue
  非同期イベント：order_created、
  location_updated、
  delivery_status_changed
end note

@enduml

@startuml
node "AWS Cloud Route53" as DNS

node "VPC (10.0.0.0/16)" {
  node "パブリックサブネット" {
    artifact "NGINX ロードバランサー" as ALB
  }
  
  node "プライベートサブネットクラスター" {
    node "EC2 インスタンス 1" {
      component "Node.js API [Pod 1]" as Pod1
    }
    node "EC2 インスタンス 2" {
      component "Node.js API [Pod 2]" as Pod2
    }
  }
  
  node "データベースサブネット" {
    database "Amazon RDS (Multi-AZ Aurora)" as Aurora
  }
}

DNS --> ALB : トラフィックの解決
ALB --> Pod1 : ラウンドロビン負荷分散
ALB --> Pod2
Pod1 --> Aurora : コネクションプール
Pod2 --> Aurora
@enduml

@startuml Internet Browser Sample
!include <archimate/Archimate>

title Archimate サンプル - インターネットブラウザ

'LAYOUT_AS_SKETCH()
'LAYOUT_LEFT_RIGHT()
'LAYOUT_TOP_DOWN()

Grouping(business, "ビジネス"){
  Business_Object(businessObject, "ビジネスオブジェクト")
  Business_Process(someBusinessProcess,"あるビジネスプロセス")
  Business_Service(itSupportService, "ビジネス向けの IT サポート（アプリケーションサービス）")
}

Grouping(application, "アプリケーション"){
  Application_DataObject(dataObject, "Web ページデータ n 'その場で'")
  Application_Function(webpageBehaviour, "Web ページの動作")
  Application_Component(ActivePartWebPage, "Web ページのアクティブな部分 n 'その場で'")
}

Grouping(technology, "テクノロジー"){
  Technology_Artifact(inMemoryItem,"メモリ内 / 'その場' html/javascript")
  Technology_Service(internetBrowser, "インターネットブラウザ汎用 & プラグイン")
  Technology_Service(internetBrowserPlugin, "あるインターネットブラウザプラグイン")
  Technology_Service(webServer, "ある Web サーバー")
}


Rel_Flow_Left(someBusinessProcess, businessObject, "")
Rel_Serving_Up(itSupportService, someBusinessProcess, "")
Rel_Specialization_Up(webpageBehaviour, itSupportService, "")
Rel_Flow_Right(dataObject, webpageBehaviour, "")
Rel_Specialization_Up(dataObject, businessObject, "")
Rel_Assignment_Left(ActivePartWebPage, webpageBehaviour, "")
Rel_Specialization_Up(inMemoryItem, dataObject, "")
Rel_Realization_Up(inMemoryItem, ActivePartWebPage, "")
Rel_Specialization_Right(inMemoryItem,internetBrowser, "")
Rel_Serving_Up(internetBrowser, webpageBehaviour, "")
Rel_Serving_Up(internetBrowserPlugin, webpageBehaviour, "")
Rel_Aggregation_Right(internetBrowser, internetBrowserPlugin, "")
Rel_Access_Up(webServer, inMemoryItem, "")
Rel_Serving_Up(webServer, internetBrowser, "")

@enduml

@startuml

entity "顧客" as customer {
  * customer_id : UUID <>
  --
  * first_name : VARCHAR(50)
  * last_name : VARCHAR(50)
  * email : VARCHAR(100) <>
  * phone : VARCHAR(20)
  * loyalty_points : INT
  * registration_date : TIMESTAMP
}

entity "映画" as movie {
  * movie_id : UUID <>
  --
  * title : VARCHAR(200)
  * description : TEXT
  * duration_minutes : INT
  * genre : VARCHAR(50)
  * release_date : DATE
  * rating : VARCHAR(10)
}

entity "劇場" as theater {
  * theater_id : UUID <>
  --
  * theater_name : VARCHAR(100)
  * total_seats : INT
  * seat_layout : JSON
}

entity "上映" as show {
  * show_id : UUID <>
  --
  * movie_id : UUID <>
  * theater_id : UUID <>
  * show_time : TIMESTAMP
  * end_time : TIMESTAMP
  * language : VARCHAR(50)
  * subtitle : BOOLEAN
  * price_regular : DECIMAL(10,2)
  * price_vip : DECIMAL(10,2)
}

entity "座席" as seat {
  * seat_id : UUID <>
  --
  * theater_id : UUID <>
  * row_label : CHAR(2)
  * seat_number : INT
  * seat_type : VARCHAR(20)
  * is_accessible : BOOLEAN
}

entity "予約" as booking {
  * booking_id : UUID <>
  --
  * customer_id : UUID <>
  * show_id : UUID <>
  * booking_time : TIMESTAMP
  * total_amount : DECIMAL(10,2)
  * status : VARCHAR(20)
  * payment_method : VARCHAR(30)
  * transaction_id : VARCHAR(100)
}

entity "予約座席" as booking_seat {
  * booking_id : UUID <<FK,PK>>
  * seat_id : UUID <<FK,PK>>
  --
  * ticket_price : DECIMAL(10,2)
  * discount_applied : DECIMAL(10,2)
}

entity "支払い" as payment {
  * payment_id : UUID <>
  --
  * booking_id : UUID <>
  * amount : DECIMAL(10,2)
  * payment_date : TIMESTAMP
  * payment_status : VARCHAR(20)
  * payment_gateway : VARCHAR(30)
  * gateway_reference : VARCHAR(200)
}

entity "レビュー" as review {
  * review_id : UUID <>
  --
  * customer_id : UUID <>
  * movie_id : UUID <>
  * rating : INT
  * comment : TEXT
  * review_date : TIMESTAMP
}

' リレーションシップ
customer ||--o{ booking : "予約する"
movie ||--o{ show : "スケジュールされる"
theater ||--o{ show : "開催する"
show ||--o{ booking : "含む"
booking ||--|{ booking_seat : "含む"
seat ||--o{ booking_seat : "割り当てられる"
booking ||--|| payment : "含む"
customer ||--o{ review : "投稿する"
movie ||--o{ review : "受け取る"

note right of booking : ステータス: 保留中、確認済み、キャンセル済み、期限切れ
note left of seat : seat_type: 一般、VIP、カップル
note right of payment : payment_status: 保留中、成功、失敗、返金

@enduml

flowchart TD
    A[体調が悪い、または医療アドバイスが必要] --> B{緊急事態ですか？}

    B -->|はい| C[救急車を呼ぶ、または救急外来へ行く]
    B -->|いいえ| D[医師の予約をスケジュールする]

    D --> E[予約に出席する]
    E --> F[医師による評価]

    F --> G{診断は下されましたか？}

    G -->|はい| H[治療計画]
    G -->|いいえ| I[検査を依頼する]

    I --> J[検査結果を受け取る]
    J --> F

    H --> K[治療に従う]
    K --> L{症状は改善しましたか？}

    L -->|はい| M[回復 / 定期的なフォローアップ]
    L -->|いいえ| N[医師に再診する]
    N --> F

graph UndirectedSpanningTree {
    fontname="Helvetica,Arial,sans-serif"
    label="データセンターメッシュネットワークトポロジバックボーンインフラ"
    labelloc="b"
    fontsize=14
    
    node [fontname="Helvetica,Arial,sans-serif", shape=circle, style=filled, color="#475569", fillcolor="#f1f5f9", width=0.8, fixedsize=true]
    edge [color="#94a3b8", penwidth=2.5]
    
    SwitchAlpha  [label="SW_A", fillcolor="#cbd5e1"]
    SwitchBeta   [label="SW_B", fillcolor="#cbd5e1"]
    Node1        [label="Host_01"]
    Node2        [label="Host_02"]
    Node3        [label="Host_03"]
    Node4        [label="Host_04"]
    
    SwitchAlpha -- SwitchBeta [label=" トランクリンク", weight=5]
    SwitchAlpha -- Node1
    SwitchAlpha -- Node2
    SwitchBeta -- Node3
    SwitchBeta -- Node4
    Node1 -- Node2 [style=dashed, color="#cbd5e1", label=" フェイルオーバー相互接続"]
}