📘

方式設計レビューで指摘された内容の原因を網羅的に分類

2025/03/06に公開

方式設計レビューで指摘された内容の原因を網羅的に分類しました。

  1. 要件・前提の不整合
    要件の誤解:ビジネス要件・システム要件の解釈ミス
    変更反映漏れ:仕様変更が正しく反映されていない
    前提条件の認識違い:ステークホルダー間で前提条件の認識がずれている
    想定外の要件発生:設計時点で考慮されていなかった要件が発生
  2. 設計品質の問題
    非機能要件の考慮不足:性能、可用性、セキュリティ、スケーラビリティの設計が不足
    冗長・複雑な設計:シンプルにできる設計が不必要に複雑
    整合性の欠如:各設計要素が一貫性を持っていない
    技術選定ミス:システム要件に適した技術選定ができていない
    実装可能性の未検証:実装難易度が高い設計になっているが、技術的検証が行われていない
    拡張性の考慮不足:将来の拡張性や変更容易性が考慮されていない
    データ設計の不備:データ構造、スキーマ、トランザクション処理の考慮不足
    セキュリティ対策不足:アクセス制御、暗号化、監査ログの不足
    エラーハンドリングの不備:異常系の処理が考慮されていない
    運用・監視設計の不足:障害監視、ログ管理、バックアップの考慮不足
  3. コミュニケーション・プロセスの問題
    関係者間の認識齟齬:設計意図が十分に説明・共有されていない
    レビュー参加者の不足:適切な専門家や関係者がレビューに参加していない
    ドキュメントの不備:設計書の記述が曖昧・不足している
    レビュー基準の不明確さ:レビューの観点が曖昧で、指摘内容がばらつく
    確認・合意プロセスの欠如:設計内容が適切に確認・合意されていない
  4. スケジュール・リソースの問題
    設計時間の不足:十分な時間を確保できず、検討不足のまま進められた
    リソース不足:経験不足のメンバーや人手不足により、設計の質が下がる
    優先度の誤り:他のタスクを優先しすぎて、設計レビューの質が落ちる
    フィードバック反映の遅れ:指摘を受けても修正が間に合わない
  5. 開発・運用の観点不足
    開発工程との連携不足:実装時の影響や開発プロセスが考慮されていない
    テスト容易性の考慮不足:ユニットテスト・統合テストの観点が考慮されていない
    運用コストの考慮不足:運用負担が増える設計になっている
  6. 組織・文化的な要因
    過去の慣習に依存:最新の技術やベストプラクティスを取り入れていない
    指摘しづらい雰囲気:レビューでの指摘が遠慮される文化がある
    学習・改善の機会不足:過去の設計ミスの学習やフィードバックの活用ができていない

Discussion