DTOオブジェクトの不完全オブジェクトグラフの文書化

Question

現在のアーキテクチャは、DBからDTOオブジェクトを取り込んでそれらを返すWCFサービスに基づいています。

いくつかのメソッドは完全なオブジェクトグラフを返します。完全に埋め込まれていると、一部のオブジェクトグラフが非常に大きくなるため、すべてのケースでオプションではありません。

多くのDTOオブジェクトのうちどのオブジェクトにどのようなプロパティが設定されているか、どのオブジェクトに設定されていないかを文書化するにはどうすればよいですか？これは.NETのショップであり、XMLコメントでは、常時入力されていないプロパティを文書化するのに十分な柔軟性はありません。他の人はこの挑戦にどのように取り組んでいますか？

例：クライアントには、すべてのプロパティが設定されているかどうかにかかわらず、Invoiceオブジェクトは同じです。

考えられる1つのアイデアは、入力されたプロパティのみを持つオブジェクトのXSDスキーマを生成することです。これは技術的には正しいものの、「良い/有用な」ドキュメントのようには見えません。

編集：私はUMLがXSDよりも優れている可能性があることを発見しました。 XML→XSD→UML（または別のダイアグラムのパラダイム）から素早く移行する方法はありますか？

Answer 1

私たちのシステムの1つでは、実際には2つのモデルが使用されています.1つはすべて完成して成熟し、もう1つは社内システムと外部パーティの契約のようなサービスで使用されます。自動生成されたマッパーとフィラーを作成しました。これにより、外部システムのデータ契約を破ることなく、オブジェクトモデルの内部表現と構造を変更することができました。