【ドキュメント不良】部署削除機能のシーケンス図の可読性が低い #18

Closed
opened 2026-09-09 05:00:42 +00:00 by 26-y-okumura-kyoeisystems · 0 comments

【事象】
部署削除機能のシーケンス図において、
・ライフラインが重なっている箇所がある
・複数のクラスに重なってメソッド名が記載されている

【原因】
図の作成時にModel を Service より左、Entity を Repository より左に配置した。これは Model および Entity を呼び出しの主体ではなくデータとして扱うという層の帰属を根拠としたものであり、呼び出し順とは一致しないため。

【対策】
層のグループ分け(presentation 系を Controller の左、DataAccess 系を右)は維持する。そのうえで、独自に追加した層内の並び順規則を撤廃し、グループ内は呼び出し順および呼び出し関係の近さによって配置する。

【事象】 部署削除機能のシーケンス図において、 ・ライフラインが重なっている箇所がある ・複数のクラスに重なってメソッド名が記載されている 【原因】 図の作成時にModel を Service より左、Entity を Repository より左に配置した。これは Model および Entity を呼び出しの主体ではなくデータとして扱うという層の帰属を根拠としたものであり、呼び出し順とは一致しないため。 【対策】 層のグループ分け(presentation 系を Controller の左、DataAccess 系を右)は維持する。そのうえで、独自に追加した層内の並び順規則を撤廃し、グループ内は呼び出し順および呼び出し関係の近さによって配置する。
26-y-okumura-kyoeisystems added the
バグ起票
label 2026-09-09 05:00:42 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: 2026_9_AI_4D_depProject_YUASA/EM-System#18
No description provided.