私はかなりのプロジェクトでアーキテクチャ設計を担当しています。アーキテクチャ設計を伝えるために最もよく使用されるツールは、クラス図、パッケージ図、シーケンス図、 展開図です。また、場合によっては、フローチャットは重要なビジネスプロセスモデリングにも使用されます。アーキテクチャ設計を伝える最も良い方法は何ですか？
今のところ私はOKだと思います。しかし、私はこの目的のためのより良い選択肢があるのだろうかと思っています。私は4 + 1ビューメソッドをチェックアウトしました。それはより包括的なアプローチのようです。次回は試してみるよ。では、建築デザインを伝えるあなたの好きな方法は何ですか？
UML！
これは役に立つかもしれません：www.sintef.no/time/UML_ArchDesign.pdf。
私のお気に入りの1つはData Flow Diagramsで、これはいわゆる「構造化」分析と設計の時代からのものです。
これはおそらくあなたが考えていたものではなく、ホワイトボードです。真剣に言えば、設計をうまくやりとりするために、さまざまな可動部品間の設計や相互作用を引き出し、必要に応じて注釈を付けることはできません。正式な方法ではありませんが、重要な「人から人へ」の議論のためにはうまくいきます。
人と話す。あなたが達成しようとしていることをあなたに教えてください：あなたが会おうとしている（そしてそれほど重要でない）非機能的な要件は何ですか？主要なトレードオフは何ですか？どのような基本原則とパターンを使用している。
図はあなたの話をサポートするためにありますが、それ自体は物語ではありません。私は2つのプロジェクトで全く同じアーティファクトのリストを使用したことはありません。私は気まぐれだからだとは思っていませんが、すべてのプロジェクトには独自の課題があります（技術でなければ人やプロセスではない）。
UML、ER図、プロセスモデル、モックアップ、またはタップダンスを使用する準備が整っていればそれを準備してください。あなたがイメージやテキストで何を言っているのかを補うことができます（これにより、より長い期間に多くの人に手を差し伸べることができます）。しかし、建築家として何をすべきかのコアは、現在の開発者、将来のメンテナー、システム運営者、エンドユーザー、ビジネススポンサーなど、すべてのステークホルダーにとって、何が最も重要であるかを知り、さまざまなレベルで伝えることです。あなたが使用することを意味するものは、のの長所と短所に適合させる必要があります。まあ、最適なArchitectural Documentationフォーマットのようなものはありません。
私は、要件を決定するためにホワイトボードの概念と対面する傾向があります。そして、UMLを使ってそれらのアイデアを標準化/定式化します。
コラボレーションプロセスでは、厳しい基準を遵守することが、実際の目標から逸脱していることがわかります。それは、私はいくつかのPMP（プロジェクトマネジメントCERT）トレーニングを受け、彼らは紙の大きなスプールを使用して、青い粘着性のgoop（これは何かをタックと呼んでいますか？）とキューカードと、ホワイトボードに。ホワイトボードとは異なり、巨大な紙は簡単に動かすことができ、キューカードは紙の上で簡単に移動、取り外し、交換することができます。私はこれを試すことをお勧めします
完了したら、巨大な紙片を手渡してください。貧弱な人々のために正式なUML図に入力する必要があります。
文書化されていないアーキテクチャでは、習得や保守が少し難しい場合があります。また、文書化されたアーキテクチャは、チーム間のコミュニケーションをゲートするのに役立ちます。各コンポーネントを開発するチーム、QAチームなど）：ドキュメントがなければ、アーキテクチャの変更を維持するための口コミや人の記憶に頼っているかもしれません。 – ChrisW