Professional Documents
Culture Documents
Project Name
Deliverable Review Process and Acceptance Criteria
Date: (mm/dd/yyyy)
1. Revision History
Revision # Revision Date Description of Change Author
2. Distribution
Recipient Name Recipient Organization Distribution Method
Table of Contents
1 Purpose and Scope..................................................................................................................................1 2 Goals of the Deliverable Review Process..............................................................................................1 3 Glossary of Terms..................................................................................................................................2 4 Meeting Participants, Roles, and Responsibilities.................................................................................3 5 Review Process.......................................................................................................................................3 5.1 Review Process Flow....................................................................................................................3 5.2 Review Process Steps....................................................................................................................5 6 Review Dispositions...............................................................................................................................7 7 Exit Criteria for Reviews........................................................................................................................8 8 Acceptance Process for Project Deliverables.........................................................................................8 9 Acceptance Criteria for Milestones and Deliverables.........................................................................12 10 Approvals..........................................................................................................................................18 Appendix A: Log of Recommended Actions/Changes..........................................................................19 Appendix B: Review Verification Form...............................................................................................20 Appendix C: Request for Acceptance Form..........................................................................................21
For detailed information about the peer review process, refer to the Guidelines for Agency Peer Reviews located on the IRMC web page in the IRMC Approved Principles, Policies, and Standards section, Project Reporting category.
products
Deliverable Review Process and Acceptance Criteria Provide reviewers with a common understanding of the review criteria and the deliverable; and Serve as a criterion for the (Agency name) Deliverable Acceptance Process.
3 Glossary of Terms
Following are definitions of commonly used terms in this document: Deliverable: A non-technical or technical component item to be reviewed. Deliverable Owner: The person responsible for the deliverable and the initiation of the review. Document Control: The organization responsible for documentation filing procedures. Item: A thing written down at the Review Process meeting. This consists of recommended action items, point clarifications, and improvement suggestions. Meeting: A forum used to formally present the deliverable during which all participants are able to communicate and interact with each other at the same time. Moderator: The person who leads the meeting and is responsible for the overall review meeting. Peer: A member of the agency staff who is of equal standing with the author of the work document. Peer review: A formal peer meeting held to allow discussion of issues, alternatives, options, and work document approval. Review process: The structured process to review the deliverable; meet to allow discussion of recommended changes, actions, alternatives to improve the quality of the deliverable and reach a consensus on the disposition of the deliverable; record the feedback; and verify completion of the review; and archive the deliverable and review forms. Review criteria: The stated requirements, policies, standards, procedures, methods, and guidelines applicable to the deliverable. Reviewer: A review meeting participant who evaluates the deliverable against an established review criteria. Quality Assurance: (Product) Conformance to technical and business functional requirements to ensure defect-free products (completeness of software or system features and
Deliverable Review Process and Acceptance Criteria functions, error-free operation). (Process) Verification and validation of project activities and resultant artifacts with respect to established policies, standards, procedures, methods, and guidelines for software development. Quality Assurance (QA) representative: The person responsible for verifying compliance to the established Quality Assurance policies, standards, procedures, methods, and guidelines for the project or the agency. Scribe: A peer review meeting participant who records items identified at the meeting. Software verification and validation (SVV): A disciplined Quality Assurance approach used to assess software products throughout the Software Lifecycle Process. Verification is defined as the process of determining whether products of a given phase of the software development process fulfill the requirements established during the previous phase, and validation is defined as the process of evaluating software at the end of the software development process to ensure compliance to software requirements. Work document: The material to be reviewed.
5 Review Process
This section details the review process to initiate, conduct, and finalize reviews. Note that the deliverables may be partitioned into units to allow for incremental reviews. The deliverable reviews are complete after all incremental reviews have been held.
(4) Review deliverable, make notes (R); become familiar with deliverable, review criteria, & meeting format (M)
(7) Approved
(9) Rework
Owner
Deliverable Owner Deliverable Owner
3.
Deliverable Owner
4.
Reviewers, Moderator
4.1
Reviewers
4.2
Moderator
5.1 5.2
Introduce meeting goals and expectations Solicit feedback in manner appropriate to deliverable, review criteria, and meeting format. Document suggested changes and actions. Summarize review results. Determine and document review disposition Reach consensus on review disposition: Approved, Approved with changes, Rework Record disposition of the review.
6.2
Moderator
7.1.1
7.1.2
7.1.3
7.1.4
File Log of Recommended Actions/Changes Form and Review Verification Form in the Project Library.
8.2
QA Representative (QA/Project Manager) QA Representative (QA/Project Manager) QA Representative (QA/Project Manager) QA Representative (QA/Project Manager) QA Representative (QA/Project Manager) QA Representative (QA/Project Manager)
8.3
8.3.1
8.3.2
8.3.3
8.3.4
File Log of Recommended Actions/Changes Form and Review Verification Form in the Project Library.
6 Review Dispositions
The Review Team recommends one of the following dispositions at the review meeting conclusion to the Deliverable Owner: Approve: the deliverable is approved as is by the review team. Approve with Recommended Changes: if 1) all recommended changes and actions can be easily addressed and 2) the rework and actions are understood by both the reviewers and the Deliverable Owner and both parties agree that no further reviews are needed, the Deliverable Owner will make the changes and resolve the actions, and the QA Representative will verify the closure of these items.
Deliverable Review Process and Acceptance Criteria Rework: if recommended changes are required that significantly alter the deliverable, the deliverable will enter the rework phase, and the same group of participants will be asked to review the reworked document.
The following project deliverables are subject to acceptance within the context of the above milestones.
Deliverable Review Process and Acceptance Criteria Milestone Project Phase Concept Complete Deliverables Project Initiation and Implementation Document, Software Project Management Plan Software Requirements Specification Template Software Design Specification Application, Software Test Plan, Software Transition Plan, Training Plan, Users Handbook, Business Continuity Plan Application, Software Test Plan, Software Transition Plan, Training Plan, Users Handbook, Business Continuity Plan Closeout Review, Lessons-learned
Phase Requirements Complete Phase Design Complete Phase Application Ready For Pilot
Phase Complete
The following table defines the sequence of activities that must be performed in support of the acceptance process and who is responsible for those activities. Activity Define acceptance criteria for milestones and deliverables in the current project phase Identify and plan for verification and validation activities necessary to support acceptance criteria for deliverables subject to acceptance Complete project deliverables for milestone Ensure completion of any necessary verification and validation activities for deliverables Individual(s) Responsible QA Manager, Project Manager, IS Sponsor, and Business Sponsor(s) for current phase QA Manager and Project Manager
Project team members responsible for project deliverable QA Manager and Project Manager
Deliverable Review Process and Acceptance Criteria Activity Complete the Request for Acceptance form (Appendix A, first three sections). Refer to Section 4, Acceptance Criteria and Approval Required for Document Deliverables, for guidelines on document content and approvers. Forward the Request for Acceptance form attached to the deliverables for the milestone and any outputs from verification and validation activities to the list of approvers for the milestone and its deliverables . Schedule and conduct a meeting for approvers to review the milestone and its deliverables with respect to their acceptance criteria. During acceptance review meeting, sign-off on acceptance and include any desired comments on signature page for milestone/deliverables. (Note: Rejected deliverables are returned to the deliverable owner to rework along with the Request for Acceptance forms and will be reviewed for acceptance again once the necessary changes have been made. Reasons for rejection are documented on the signature form. If sign-off is not obtained within five (5) business days, then the project will proceed as though acceptance were obtained, and an issue will be logged to escalate the official acceptance.) Return Request for Acceptance Signature page to Project Manager Submit completed Request for Acceptance form and signature pages to QA manager for inclusion in the Project Notebook File Request for Acceptance form and signature pages in Project Notebook Place accepted deliverables in the Project Notebook QA Manager, Project Manager, and Business Sponsor(s) for current phase Project Manager Individual(s) Responsible Project Manager
Project Manager
Project Manager
QA Manager, Project Manager, IS Sponsor, and Business Sponsor(s) for current phase
QA Manager QA Manager
10
Deliverable Review Process and Acceptance Criteria Activity Ensure the new version of the deliverable is in the Project File repository and is marked as the current version Report overdue Request for Acceptance signature pages as issues on status reports to management Individual(s) Responsible QA Manager
Project Manager
11
Business process Business requirements Use cases Functional requirements Data requirements Non-functional requirements
Deliverable Review Process and Acceptance Criteria Milestone Deliverable Acceptance Criteria its prioritized requirements for correctness, completeness, and consistency with respect to the sponsor organizations business processes and business needs within the scope established in the Project Initiation and Implementation Document. The application development team has reviewed the Specification to ensure its sufficiency for beginning application design and to determine which requirements can be met within the constraints of the current project phase. The software test team has reviewed the Specification to ensure that all requirements are testable. The project manager has reviewed the Specification to ensure that all requirements are traceable to the scope, goals, and objectives established in the Project Initiation and Implementation Document. Phase Design Complete Software Design Specification The Software Design Specification describes how the application should function and be constructed to provide the capabilities defined in the Software Requirements Specification. This document includes:
Screen flows Screen designs Form and letters design Report designs Logical data model Physical data model User roles Security model Data mapping Detailed system interface designs
The Design Team has reviewed the Specification for correctness, completeness, and consistency with respect to the prioritized requirements established in the Software Requirements Specification.
13
Deliverable Review Process and Acceptance Criteria Milestone Deliverable Acceptance Criteria The business team has reviewed the specification to ensure that all requirements are fully represented in the design and that the design includes no items that are not part of the established requirements. The application development team has reviewed the Specification to ensure its sufficiency for beginning application development and to validate the feasibility of implementing the design within the constraints of the current project phase. The software test team has reviewed the Specification to ensure that the design is testable. Phase Application Ready For Pilot Software Test Plan The completed application was delivered into the test environment with functionality as specified in the Software Requirements Specification, Supplemental Specification for Nonfunctional Requirements, and Software Design Specification. The completed application passed through system testing with the following results: 1. All test cases completely executed for functional modules with a system test priority ranking between 1 and 3 inclusive 2. Zero severity 1 (critical) defects 3. Zero severity 2 (major) defects in business priority 1 functional modules 4. No more than 2 severity 3 defects (minor) per business priority 1 functional module and no more than 20 severity 3 defects total in business priority one functional modules 5. No more than 1 severity 2 defect per business priority 2 functional module and no more than 5 severity 2 defects total in business priority 2 functional modules 6. No more than 5 severity 3 defects per business priority 2 functional module and no more than 40 severity 3 defects total in business priority 2 functional modules In the above criteria, business priority refers to the business priority assigned to a functional module in
14
Deliverable Review Process and Acceptance Criteria Milestone Deliverable Acceptance Criteria the Software Requirements Specification, where priority 1 is business critical, priority 2 is moderately important, and priority 3 is optional. Severity 1, or Critical, defects include issues that result in degraded system performance beyond stated performance criteria, deny access to functionality, and/or corrupt data or display data incorrectly. Severity 2, or Major, defects include issues that prevent a user from correctly completing a task in the system, but can be managed by a workaround, and/or issues that promote data errors or reduce data quality substantially. Severity 3, or Minor, defects include issues that interfere with, but do not prevent a user from performing normal tasks. These are frequently usability or performance issues or defects that cannot be reliably reproduced. These can also be issues that represent an inaccuracy in the application but have no impact on functionality or performance, such as spelling errors, inconsistent fonts, etc. For user acceptance testing, the completed application was delivered in the same condition or better as when it was delivered with the test fixes required to meet the system test acceptance criteria described above. The completed application passed through all acceptance testing scenarios with no severity 1 defects in any functional module and no severity 2 defects in any business priority 1 functional module (priorities and severities as defined above). Acceptance testers agree that the application can move into pilot rollout with all the known nonminor defects or with a limited number of defect fixes that can be completed and tested by the project team in no more than two (2) business days. The accepted application has been moved from the test environment to the pilot environment with all test data removed and is functioning properly (as good as or better than it was during acceptance test).
15
Deliverable Review Process and Acceptance Criteria Milestone Phase Application Ready For Pilot Deliverable Users Handbook Acceptance Criteria The Users Handbook describes in detail the procedures for using all of the functionality provided in the application in terms understandable to the typical user. The Software Transition Plan describes the tasks and activities that need to take place to efficiently and effectively move the application from the development or Pilot environment to the production, operations and maintenance environment and to integrate use of into the business processes of the impacted organization(s). The Plan includes deployment schedules, resource estimates, identification of special resources and staffing. The transition plan also defines management controls and reporting procedures, as well as the risks and contingencies. An impact statement outlining the potential impact of the transition to the existing infrastructure, operations, and support staff and to the user community is included. The Plan has been reviewed and approved by the operations, maintenance, and support organization, including Technical Services. Phase Application Ready For Pilot Phase Application Ready For Pilot Training Plan The Training Plan describes what training will provided to users to prepare them to use the application and how this training will be performed. The Business Continuity Plan describes how business functions supported by will be performed in the event that the application is unavailable for a period of time. Any application issues that the Design Team and Pilot users identified as needing to be addressed prior to statewide rollout have been addressed. The application still meets or exceeds the acceptance criteria established for the Phase Application Ready For Pilot milestone.
Application
16
Deliverable Review Process and Acceptance Criteria Milestone Phase Application Ready For Statewide Rollout Phase Application Ready For Statewide Rollout Phase Application Ready For Statewide Rollout Phase Application Ready For Statewide Rollout Phase Complete Deliverable Users Handbook Acceptance Criteria The Users Handbook was updated to include any changes necessary to support application changes made after the Pilot. The Software Transition Plan was updated to include any changes necessitated by problems with the Pilot rollout. The Training Plan was updated to include any changes necessitated by problems with the Pilot training. The Business Continuity Plan was updated to include any changes necessitated by problems with the evaluation of business continuity procedures during the Pilot. All project activities defined in the Project Initiation and Implementation Document and any approved change requests have been completed. All users have been trained and provided access to the application as specified in the Software Transition Plan and Training Plan. The Project Closeout Review document includes all project outcomes, costs, and lessons learned for the current project phase.
17
10 Approvals
The signatures below indicate the approval of the (Agency) (Project Name) Deliverable Review Process and Acceptance Criteria process and document.
Signature _____________________________
Date _______________
Signature _____________________________
Date _______________
Signature _____________________________
Date _______________
18
Assigned To
Actions/Changes
Resolution
Verify Closure
19
Deliverable/Product Name and Purpose: Deliverable/Product Owner: Revision/Version Number: Reason for Review:
Verification:
_______________________ Date
20
Section 3 Signatures: (List individuals whose signatures are required for deliverable in Section 2. Project Manager will input date of signature.) Approval ___________________________ ___________________________ ___________________________ Date ________________ ________________ ________________
21
Signature Name
Date Title
Rejection Comments: Insert comments explaining rejection of deliverable and the date of rejection: Date: ______________ Comment:
General Comments: Insert any comments and date of comment: Date: ______________ Comment:
22