シーケンス図はとても強力です


このポストでは、シーケンス図の重要性を強調したい.技術のリードとして、私はさまざまなチームの多くのプロジェクトに関与している.チームはアイデアを持っています、彼らは若干のブレーンストーミングを組織します、そして、彼らは光沢がある新しいもので成し遂げたいものに関する若干の種類のドキュメンテーションをつくります.通常、それは彼らが私がいくつかのデザインの決定を行うか、単に彼らが持っているものを確認するように頼むポイントです.私の経験では、それらの初期のデザインドキュメントはすべてをカバーしません.これはプロジェクトを進化させる自然な方法ですが、それらの盲点は技術的な決定を助けません.悪魔は詳細に住んでいる、知っている.だから私は通常、私のための時間を節約し、同時にチームのための問題の分かりやすさを助ける欠けている部分を見つけるためのツールが必要です.私は視覚的な人ではない、私は図面を嫌いまたはボックスの右の色を選択します.一方、私はまた、非再現性、バイナリ形式またはほとんど編集可能なSVGSを好みません.私は最終的な結果をバージョン管理に入れるのが好きです、それで、シーケンス図のような単純な解決策を探しています.
私がhttps://sequencediagram.org/に助言するのを許してください.

これは十分によく見えます、チームメンバーは何が起こっているかを簡単に理解して、適切なデザイン決定をするために何が欠けているかを調査するのを助けます.それはshareableです、そして、最後に、それはちょうど単純なコードです:
title Sample project

actor User
participantgroup #pink **Cluster**
    participantgroup #lightgreen **  Fancy\nfrontend**
        fontawesome5regular f0f8 Frontend
    end
    participantgroup #lightblue **  Fancy\nbackend**
        control Backend
        database Database
    end
    entity #grey:1 Third party
end

group #2f2e7b Some user action #white
    abox over Third party:We haven't choose an implementation
    User->Frontend:Change something
    Frontend->Backend:Validate
    activate Backend
    Backend->Backend:Validate
    Backend->Database:Persist
    deactivate Backend
    Backend<--Database:Watch persisted
    activate Backend
    Backend<->Database:Fetch something
    Backend->Backend:Validate everything
    alt In some case
        Backend->Frontend:Send notification to user
        Frontend-->>User:Send notification
    else Other case
        Backend->Frontend:Create a job
        create Job
        Backend->Job:Create
        Job->Third party:Interact with third party
        destroysilent Job
        Backend->Frontend:Send notification to user
        Frontend-->>User:Send notification
        deactivate Backend
    end
end