SARA Report Software Architecture Review and Assessment
Total Page:16
File Type:pdf, Size:1020Kb
SARA Report Software Architecture Review and Assessment (SARA) Report Version 1.0 © SARA W.G., 1999-2002 1 Version 1.0 SARA Report Revision History Date Version Description Author 03 May 1999 0.1 Creation at the Burlington meeting Philippe Kruchten 04 May 1999 0.2 Add material from the 3 subgroups on: - Social aspects Rick Kazman, A. Ran - Workflow H. Obbink, Ph. Kruchten R. Hilliard, T. Mikkonen - Foundations 09 September 0.3 Add material from the 3 subgroups on: Alexander Ran, Herman Postema, Gr1, Analysis framework for ASR’s section 8.1 Wojtek Kozaczynski, Henk Obbink Gr2, Architecture Description Document Chapter 6 Ed. Kahan, Juergen Mueller Gr3, Review typology section 5.3 04 October 04 Added revised material from Juergen Henk Obbink on Architecture impact matrices Jan 26, 2000 05 Includes new material on workflow, Rick Kazman, Ed Kahan foundations, methods & techniques Jan 26, 2000 06 Adds section on pragmatics, reformats Rick Kazman Jan 27, 2000 07 Cleaning up the document Henk Obbink, Steve Heise, Ed Kahan 28 February 07a Revision to Section 4 Conceptual Rich Hilliard 2000 Framework May 10-11, 07b Munich review: modified Conceptual R. Hilliard, A.Ran, L. 2000 Framework, Review input and Dominick, N. Werner, F. outcomes, Workflow, Pragmatics Paulisch, R. Kazman, T. Mikkonen, H. Obbink May 11, 2000 08 Create master document and Ph.Kuchten, A Ran, R. Hilliard subdocuments Propose alternate strategy for section on method and techniques September 06, 09 Reviewed the version 0.8 and the H..Obbink, A.Ran, 2000 suggested changes are in the file. W.Kozaczynski, Lutz Sections 1-7 have been changed. Dominique, H. Postema August 27, 2001 0.95 Amsterdam meeting Ph. Kruchten, R. Hilliard, H..Obbink, A.Ran, W. Tracz, General clean up; Define template for W.Kozaczynski, H. Postema technique; November 1, 0.96 Technical Presentation Edit Will Tracz 2001 © SARA W.G., 1999-2002 2 Version 1.0 SARA Report November 21, 0.96a Revision of Chapter 4 A.Ran 2001 January 28th, 0.97 Incorporated templates Philippe Kruchten 2002 Dealt with several comments from a reviewer, a colleague of Henk Fixed external references. Added Siemens’s example 4 February 2002 0.98 Fixed Glossary and definitions. Rich Hilliard 6 February 2002 1.0 Issue version 1.0 for ICSE Workshop Philippe Kruchten © SARA W.G., 1999-2002 3 Version 1.0 SARA Report Table of Contents 1 Acknowledgments................................................................................................................... 7 2 Objectives ............................................................................................................................... 7 3 Document Structure................................................................................................................ 8 4 Conceptual Framework for Architectural Review.................................................................. 8 4.1 The Context of Architecture Design............................................................................... 8 4.2 Main Concepts of Software Architecture for Software Architecture Review ................ 9 4.2.1 Scope....................................................................................................................... 9 4.2.2 Concerns ............................................................................................................... 10 4.2.3 Requirements ........................................................................................................ 10 4.2.4 Component Domains ............................................................................................ 10 4.2.5 Structures .............................................................................................................. 10 4.2.6 Views .................................................................................................................... 10 4.2.7 Texture .................................................................................................................. 10 4.2.8 Concepts................................................................................................................ 11 4.3 Finding and Structuring ASR........................................................................................ 11 4.4 Finding the Architecturally Significant Decisions (ASDs) .......................................... 12 4.5 Software Architecture Review Reference Model ......................................................... 13 5 Review Inputs....................................................................................................................... 17 5.1 Introduction................................................................................................................... 17 5.2 Review Objectives........................................................................................................ 17 5.3 Review Scope................................................................................................................ 18 5.4 Architectural Artifacts.................................................................................................. 18 5.4.1 System Description ............................................................................................... 18 5.4.2 Architecture Descriptions..................................................................................... 18 5.4.3 Architectural Decisions......................................................................................... 19 5.4.4 Reused Solutions................................................................................................... 19 5.4.5 Guidelines and Rules ............................................................................................ 19 5.4.6 Architecture Supporting Evidence........................................................................ 20 5.5 Other Relevant Inputs ................................................................................................... 20 5.5.1 Architecturally Significant Requirements (ASRs)................................................ 20 5.5.2 Product Strategy and Product Planning ................................................................ 20 5.5.3 Requirements ........................................................................................................ 21 5.5.4 Standards and Constraints..................................................................................... 21 5.5.5 Quality Assurance Policies ................................................................................... 22 5.5.6 Risk Assessment Artifacts .................................................................................... 22 6 Review Outcomes ................................................................................................................. 23 6.1 Introduction................................................................................................................... 23 6.2 Assessment Report........................................................................................................ 23 6.2.1 Objectives ............................................................................................................. 23 6.2.2 Scope..................................................................................................................... 23 6.2.3 Methodology......................................................................................................... 23 © SARA W.G., 1999-2002 4 Version 1.0 SARA Report 6.2.4 Evaluation Criteria for Architecture ..................................................................... 24 6.2.5 Employed Architectural Foundation and Approach ............................................. 24 6.2.6 Architecture Analysis, Findings and Recommendations...................................... 24 6.3 Additional Review Outcomes....................................................................................... 25 6.3.1 Executive Summary.............................................................................................. 25 6.3.2 Architecture Review Plan Update and Lessons Learned...................................... 26 7 Architecture Review Workflow............................................................................................ 26 7.1 Inception Activities....................................................................................................... 27 7.1.1 Identify Type of Review and Its Business Objectives.......................................... 27 7.1.2 Identify Key Stakeholders and Review Scope...................................................... 28 7.1.3 Identify (Initial) Set of Detailed Review Objectives ............................................ 28 7.1.4 Prepare Review Plan and Obtain Approval .......................................................... 28 7.2 Review Activities.......................................................................................................... 29 7.2.1 Identify, Describe and Prioritize ASRs................................................................. 29 7.2.2 Identify/develop architecture description ............................................................. 29 7.2.3 Analyze Architecture Description Against ASRs................................................. 30 7.3 Post-Review Activities..................................................................................................30 7.3.1 Summarize Findings and Review Them with Architecture Owners .................... 30 7.3.2 Present Review Report and Recommendations