Architecture Compliance Review Checklists

The following review checklists provide a wide range of typical questions that may be used in conducting Architecture Compliance reviews, relating to various aspects of the architecture. The organization of the questions includes the basic disciplines of system engineering, information management, security, and systems management. The checklists are based on material provided by a member of The Open Group, and are specific to that organization. Other organizations could use the following checklists with other questions tailored to their own particular needs.

The checklists provided contain too many questions for any single review: they are intended to be tailored selectively to the project concerned. The checklists actually used will typically be developed/selected by subject matter experts. They are intended to be updated annually by interest groups in those areas.

Some of the checklists include a brief description of the Architecture Principle that provokes the question, and a brief description of what to look for in the answer. These extensions to the checklist are intended to allow the intelligent re-phrasing of the questions, and to give the user of the checklist a feel for why the question is being asked.

Occasionally the questions will be written, as in RFPs, or in working with a senior project architect. More typically they are expressed orally, as part of an interview or working session with the project.

The checklists provided here are designed for use in individual architecture projects, not for business domain architecture or for architecture across multiple projects. (Doing an architecture review for a larger sphere of activity, across multiple business processes and system projects, would involve a similar process, but the checklist categories and their contents would be different.)

Hardware and Operating System Checklist

  1. What is the project’s lifecycle approach?
  2. At what stage is the project in its lifecycle?
  3. What key issues have been identified or analyzed that the project believes will drive evaluations of hardware and operating systems for networks, servers, and end-user devices?
  4. What system capabilities will involve high-volume and/or high-frequency data transfers?
  5. How does the system design impact or involve end-user devices?
  6. What is the quantity and distribution (regional and global) of usage, data storage, and processing?
  7. What applications are affinitized with your project by similarities in data, application services, etc.? To what degree is data affinitized with your project?
  8. What hardware and operating system choices have been made before functional design of key elements of the system?
  9. If hardware and operating system decisions were made outside of the project’s control:
    • What awareness does the project have of the rationale for those decisions?
    • How can the project influence those decisions as system design takes shape?
  10. If some non-standards have been chosen:
    • What are the essential business and technical requirements for not using corporate standards?
    • Is this supported by a business case?
    • Have the assumptions in the business case been subject to scrutiny?
  11. What is your process for evaluating full lifecycle costs of hardware and operating systems?
  12. How has corporate financial management been engaged in evaluation of lifecycle costs?
  13. Have you performed a financial analysis of the supplier?
  14. Have you made commitments to any supplier?
  15. Do you believe your requirements can be met by only one supplier?

Software Services and Middleware Checklist

  1. Describe how error conditions are defined, raised, and propagated between application components.
  2. Describe the general pattern of how methods are defined and arranged in various application modules.
  3. Describe the general pattern for how method parameters are defined and organized in various application modules. Are [in], [in/out], [out] parameters always specified in the same order? Do Boolean values returned by modules have a consistent outcome?
  4. Describe the approach that is used to minimize the number of round-trips between client and server calls, particularly for out-of-process calls, and when complex data structures are involved.
  5. Describe the major data structures that are passed between major system components.
  6. Describe the major communication protocols that are used between major system components.
  7. Describe the marshaling techniques that are used between various system components. Describe any specialized marshaling arrangements that are used.
  8. Describe to what extent the system is designed with stateful and stateless components.
  9. Describe how and when state is saved for both stateful and stateless components.
  10. Describe the extent to which objects are created, used, and destroyed versus re-used through object pooling.
  11. Describe the extent to which the system relies on threading or critical section coding.
  12. Describe the approach and the internal documentation that is used internally in the system to document the methods, methods arguments, and method functionality.
  13. Describe the code review process that was used to build the system.
  14. Describe the unit testing that has been used to test the system components.
  15. Describe the pre- and post-condition testing that is included in various system modules.
  16. Describe the assertion testing that is included with the system.
  17. Do components support all the interface types they need to support or are certain assumptions made about what types of components will call other components either in terms of language bindings or other forms of marshaling?
  18. Describe the extent to which big-endian or little-endian data format problems need to be handled across different platforms.
  19. Describe if numbers or strings need to be handled differently across different platforms.
  20. Describe whether the software needs to check for floating-point round-off errors.
  21. Describe how time and date functions manage dates so as to avoid improper handling of time and date calculation or display.
  22. Describe what tools or processes have been used to test the system for memory leaks, reachability, or general robustness.
  23. Describe the layering of the systems services software. Describe the general number of links between major system components. Is the system composed of a lot of point-to-point interfaces or are major messaging backbones used instead?
  24. Describe to what extent the system components are either loosely coupled or tightly coupled.
  25. What requirements does the system need from the infrastructure in terms of shared libraries, support for communication protocols, load balancing, transaction processing, system monitoring, naming services, or other infrastructure services?
  26. Describe how the system and system components are designed for refactoring.
  27. Describe how the system or system components rely on common messaging infrastructure versus a unique point-to-point communication structure.

Applications Checklists

Infrastructure (Enterprise Productivity) Applications

  1. Is there need for capabilities that are not provided through the enterprise’s standard infrastructure application products? For example:
    • Collaboration
      • Application sharing
      • Video conferencing
      • Calendaring
      • Email
    • Workflow management
    • Publishing/word processing applications
      • HTML
      • SGML and XML
      • Portable document format
      • Document processing (proprietary format)
      • Desktop publishing
    • Spreadsheet applications
    • Presentation applications
      • Business presentations
      • Image
      • Animation
      • Video
      • Sound
      • CBT
      • Web browsers
    • Data management applications
      • Database interface
      • Document management
      • Product data management
      • Data warehouses/mart
    • Program management applications
      • Project management
      • Program visibility
  2. Describe the business requirements for enterprise infrastructure application capabilities that are not met by the standard products.

Business Applications

  1. Are any of the capabilities required provided by standard products supporting one or more line-of-business applications? For example:
    • Business acquisition applications
      • Sales and marketing
    • Engineering applications
      • Computer-aided design
      • Computer-aided engineering
      • Mathematical and statistics analysis
    • Supplier management applications
      • Supply chain management
      • Customer relationship management
    • Manufacturing applications
      • Enterprise Resource Planning (ERP) applications
      • Manufacturing execution systems
      • Manufacturing quality
      • Manufacturing process engineering
      • Machine and adaptive control
    • Customer support applications
      • Airline logistics support
      • Maintenance engineering
    • Finance applications
    • People applications
    • Facilities applications
    • Information systems applications
      • Systems engineering
      • Software engineering
      • Web developer tools
      • Integrated development environments
      • Lifecycle categories
      • Functional categories
      • Specialty categories
    • Computer-aided manufacturing
    • e-Business enablement
    • Business process engineering
      • Statistical quality control
  2. Describe the process requirements for business application capabilities that are not met by the standard products.

Application Integration Approach

  1. What integration points (business process/activity, application, data, computing environment) are targeted by this architecture?
  2. What application integration techniques will be applied (common business objects [ORBs], standard data definitions [XML, etc.], common user interface presentation/desktop)?

Information Management Checklists

Data Values

  1. What are the processes that standardize the management and use of the data?
  2. What business process supports the entry and validation of the data? Use of the data?
  3. What business actions correspond to the creation and modification of the data?
  4. What business actions correspond to the deletion of the data and is it considered part of a business record?
  5. What are the data quality requirements required by the business user?
  6. What processes are in place to support data referential integrity and/or normalization?

Data Definition

  1. What are the data model, data definitions, structure, and hosting options of purchased applications (COTS)?
  2. What are the rules for defining and maintaining the data requirements and designs for all components of the information system?
  3. What shareable repository is used to capture the model content and the supporting information for data?
  4. What is the physical data model definition (derived from logical data models) used to design the database?
  5. What software development and data management tools have been selected?
  6. What data owners have been identified to be responsible for common data definitions, eliminating unplanned redundancy, providing consistently reliable, timely, and accurate information, and protecting data from misuse and destruction?

Security/Protection

  1. What are the data entity and attribute access rules which protect the data from unintentional and unauthorized alterations, disclosure, and distribution?
  2. What are the data protection mechanisms to protect data from unauthorized external access?
  3. What are the data protection mechanisms to control access to data from external sources that temporarily have internal residence within the enterprise?

Hosting, Data Types, and Sharing

  1. What is the discipline for managing sole-authority data as one logical source with defined updating rules for physical data residing on different platforms?
  2. What is the discipline for managing replicated data, which is derived from operational sole-authority data?
  3. What tier data server has been identified for the storage of high or medium-critical operational data?
  4. What tier data server has been identified for the storage of type C operational data?
  5. What tier data server has been identified for the storage of decision support data contained in a data warehouse?
  6. What Database Management Systems (DBMSs) have been implemented?

Common Services

  1. What are the standardized distributed data management services (e.g., validation, consistency checks, data edits, encryption, and transaction management) and where do they reside?

Access Method

  1. What are the data access requirements for standard file, message, and data management?
  2. What are the access requirements for decision support data?
  3. What are the data storage and the application logic locations?
  4. What query language is being used?

Security Checklist

  1. Security Awareness: Have you ensured that the corporate security policies and guidelines to which you are designing are the latest versions? Have you read them? Are you aware of all relevant computing security compliance and risk acceptance processes? (Interviewer should list all relevant policies and guidelines.)
  2. Identification/Authentication: Diagram the process flow of how a user is identified to the application and how the application authenticates that the user is who they claim to be. Provide supporting documentation to the diagram explaining the flow from the user interface to the application/database server(s) and back to the user. Are you compliant with corporate policies on accounts, passwords, etc.?
  3. Authorization: Provide a process flow from beginning to end showing how a user requests access to the application, indicating the associated security controls and separation of duties. This should include how the request is approved by the appropriate data owner, how the user is placed into the appropriate access-level classification profile, how the user ID, password, and access is created and provided to the user. Also include how the user is informed of their responsibilities associated with using the application, given a copy of the access agreement, how to change password, who to call for help, etc.
  4. Access Controls: Document how the user IDs, passwords, and access profiles are added, changed, removed, and documented. The documentation should include who is responsible for these processes.
  5. Sensitive Information Protection: Provide documentation that identifies sensitive data requiring additional protection. Identify the data owners responsible for this data and the process to be used to protect storage, transmission, printing, and distribution of this data. Include how the password file/field is protected. How will users be prevented from viewing someone else’s sensitive information? Are there agreements with outside parties (partners, suppliers, contractors, etc.) concerning the safeguarding of information? If so, what are the obligations?
  6. Audit Trails and Audit Logs: Identify and document group accounts required by the users or application support, including operating system group accounts. Identify and document individual accounts and/or roles that have superuser type privileges, what these privileges are, who has access to these accounts, how access to these accounts is controlled, tracked, and logged, and how password change and distribution are handled, including operating system accounts. Also identify audit logs, who can read the audit logs, who can modify the audit logs, who can delete the audit logs, and how the audit logs are protected and stored. Is the user ID obscured in the audit trails?
  7. External Access Considerations: Will the application be used internally only? If not, are you compliant with corporate external access requirements?

System Management Checklist

  1. What is the frequency of software changes that must be distributed?
  2. What tools are used for software distribution?
  3. Are multiple software and/or data versions allowed in production?
  4. What is the user data backup frequency and expected restore time?
  5. How are user accounts created and managed?
  6. What is the system license management strategy?
  7. What general system administration tools are required?
  8. What specific application administration tools are required?
  9. What specific service administration tools are required?
  10. How are service calls received and dispatched?
  11. Describe how the system is uninstalled.
  12. Describe the process or tools available for checking that the system is properly installed.
  13. Describe tools or instrumentation that are available that monitor the health and performance of the system.
  14. Describe the tools or process in place that can be used to determine where the system has been installed.
  15. Describe what form of audit logs are in place to capture system history, particularly after a mishap.
  16. Describe the capabilities of the system to dispatch its own error messages to service personnel.

System Engineering/Overall Architecture Checklists

General

  1. What other applications and/or systems require integration with yours?
  2. Describe the integration level and strategy with each.
  3. How geographically distributed is the user base?
  4. What is the strategic importance of this system to other user communities inside or outside the enterprise?
  5. What computing resources are needed to provide system service to users inside the enterprise? Outside the enterprise and using enterprise computing assets? Outside the enterprise and using their own assets?
  6. How can users outside the native delivery environment access your applications and data?
  7. What is the life expectancy of this application?
  8. Describe the design that accommodates changes in the user base, stored data, and delivery system technology.
  9. What is the size of the user base and their expected performance level?
  10. What performance and stress test techniques do you use?
  11. What is the overall organization of the software and data components?
  12. What is the overall service and system configuration?
  13. How are software and data configured and mapped to the service and system configuration?
  14. What proprietary technology (hardware and software) is needed for this system?
  15. Describe how each and every version of the software can be reproduced and re-deployed over time.
  16. Describe the current user base and how that base is expected to change over the next three to five years.
  17. Describe the current geographic distribution of the user base and how that base is expected to change over the next three to five years.
  18. Describe how many current or future users need to use the application in a mobile capacity or who need to work off-line.
  19. Describe what the application generally does, the major components of the application, and the major data flows.
  20. Describe the instrumentation included in the application that allows for the health and performance of the application to be monitored.
  21. Describe the business justification for the system.
  22. Describe the rationale for picking the system development language over other options in terms of initial development cost versus long-term maintenance cost.
  23. Describe the systems analysis process that was used to come up with the system architecture and product selection phase of the system architecture.
  24. Who besides the original customer might have a use for or benefit from using this system?
  25. What percentage of the users use the system in browse mode versus update mode?
  26. What is the typical length of requests that are transactional?
  27. Do you need guaranteed data delivery or update, or does the system tolerate failure?
  28. What are the up-time requirements of the system?
  29. Describe where the system architecture adheres or does not adhere to standards.
  30. Describe the project planning and analysis approach used on the project.

Processors/Servers/Clients

  1. Describe the client/server Application Architecture.
  2. Annotate the pictorial to illustrate where application functionality is executed.

Client

  1. Are functions other than presentation performed on the user device?
  2. Describe the data and process help facility being provided.
  3. Describe the screen-to-screen navigation technique.
  4. Describe how the user navigates between this and other applications.
  5. How is this and other applications launched from the user device?
  6. Are there any inter-application data and process sharing capabilities? If so, describe what is being shared and by what technique/technology.
  7. Describe data volumes being transferred to the client.
  8. What are the additional requirements for local data storage to support the application?
  9. What are the additional requirements for local software storage/memory to support the application?
  10. Are there any known hardware/software conflicts or capacity limitations caused by other application requirements or situations which would affect the application users?
  11. Describe how the look-and-feel of your presentation layer compares to the look-and-feel of the other existing applications.
  12. Describe to what extent the client needs to support asynchronous and/or synchronous communication.
  13. Describe how the presentation layer of the system is separated from other computational or data transfer layers of the system.

Application Server

  1. Can/do the presentation layer and application layers run on separate processors?
  2. Can/do the application layer and data access layer run on separate processors?
  3. Can this application be placed on an application server independent of all other applications? If not, explain the dependencies.
  4. Can additional parallel application servers be easily added? If so, what is the load balancing mechanism?
  5. Has the resource demand generated by the application been measured and what is the value? If so, has the capacity of the planned server been confirmed at the application and aggregate levels?

Data Server

  1. Are there other applications which must share the data server? If so, identify them and describe the data and data access requirements.
  2. Has the resource demand generated by the application been measured and what is the value? If so, has the capacity of the planned server been confirmed at the application and aggregate levels?

COTS (where applicable)

  1. Is the vendor substantial and stable?
  2. Will the enterprise receive source code upon demise of the vendor?
  3. Is this software configured for the enterprise’s usage?
  4. Is there any peculiar A&D data or processes that would impede the use of this software?
    • Is this software currently available?
  5. Has it been used/demonstrated for volume/availability/service-level requirements similar to those of the enterprise?
    • Describe the past financial and market share history of the vendor.

System Engineering/Methods & Tools Checklist

  1. Do metrics exist for the current way of doing business?
  2. Has the system owner created evaluation criteria that will be used to guide the project? Describe how the evaluation criteria will be used.
  3. Has research of existing architectures been done to leverage existing work? Describe the method used to discover and understand. Will the architectures be integrated? If so, explain the method that will be used.
  4. Describe the methods that will be used on the project:
    • For defining business strategies
    • For defining areas in need of improvement
    • For defining baseline and target business processes
    • For defining transition processes
    • For managing the project
    • For team communication
    • For knowledge management, change management, and configuration management
    • For software development
    • For referencing standards and statements of direction
    • For quality assurance of deliverables
    • For design reviews and deliverable acceptance
    • For capturing metrics
  5. Are the methods documented and distributed to each team member?
  6. To what extent are team members familiar with these methods?
  7. What processes are in place to ensure compliance with the methods?
  8. Describe the infrastructure that is in place to support the use of the methods through the end of the project and anticipated releases.
    • How is consultation and trouble-shooting provided?
    • How is training co-ordinated?
    • How are changes and enhancements incorporated and cascaded?
    • How are lessons learned captured and communicated?
  9. What tools are being used on the project? (Specify versions and platforms). To what extent are team members familiar with these tools?
  10. Describe the infrastructure that is in place to support the use of the tools through the end of the project and anticipated releases.
    • How is consultation and trouble-shooting provided?
    • How is training co-ordinated?
    • How are changes and enhancements incorporated and cascaded?
    • How are lessons learned captured and communicated?
  11. Describe how the project will promote the re-use of its deliverables and deliverable content.
  12. Will the architecture designs “live” after the project has been implemented? Describe the method that will be used to incorporate changes back into the architecture designs.
  13. Were the current processes defined?
  14. Were issues documented, rated, and associated to current processes? If not, how do you know you are fixing something that is broken?
  15. Were existing/planned process improvement activities identified and associated to current processes? If not, how do you know this activity is not in conflict with or redundant to other Statements of Work?
  16. Do you have current metrics? Do you have forecasted metrics? If not, how do you know you are improving something?
  17. What processes will you put in place to gather, evaluate, and report metrics?
  18. What impacts will the new design have on existing business processes, organizations, and information systems? Have they been documented and shared with the owners?

Architecture Compliance Review Guidelines

Tailoring the Checklists

  • Focus on:
    • High risk areas
    • Expected (and emergent) differentiators
  • For each question in the checklist, understand:
    • The question itself
    • The principle behind it
    • What to look for in the responses
  • Ask subject experts for their views
  • Fix the checklist questions for your use
  • Bear in mind the need for feedback to the Architecture Board

Conducting Architecture Compliance Reviews

  • Understand clearly the objectives of those soliciting the review; and stay on track and deliver what was asked for. For example, they typically want to know what is right or wrong with the system being architected; not what is right or wrong with the development methodology used, their own management structure, etc. It is easy to get off-track and discuss subjects that are interesting and perhaps worthwhile, but not what was solicited. If you can shed light and insight on technical approaches, but the discussion is not necessary for the review, volunteer to provide it after the review.
  • If it becomes obvious during the discussion that there are other issues that need to be addressed, which are outside the scope of the requested review, bring it up with the meeting chair afterwards. A plan for addressing the issues can then be developed in accordance with their degree of seriousness.
  • Stay “scientific”. Rather than: “We like to see large databases hosted on ABC rather than XYZ.”, say things like: “The downtime associated with XYZ database environments is much greater than on ABC database environments. Therefore we don’t recommend hosting type M and N systems in an XYZ environment.”
  • Ask “open” questions; i.e., questions that do not presume a particular answer.
  • There are often “hidden agendas” or controversial issues among those soliciting a review, which you probably won’t know up-front. A depersonalized approach to the discussions may help bridge the gaps of opinion rather than exacerbate them.
  • Treat those being interviewed with respect. They may not have built the system “the way it should be”, but they probably did the best they could under the circumstances in which they were placed.
  • Help the exercise become a learning experience for you and the presenters.
  • Reviews should include detailed assessment activities against the architectures and should ensure that the results are stored in the Enterprise Continuum.
SiteLock