ZEN Project Glossary
From ZenWiki
Contents |
Acronyms for Institutions
- SEI - Software Engineering Institute
- MSE - Master of Software Engineering
- CMU - Carnegie Mellon University
- SMART - Service Migration And Reuse Technique
- SMIG - Service Migration Interview Guide (Refer to ZEN Tool Glossary below)
Architecture related acronyms
- QAW - Quality Attribute Workshop
- ACDM - Architecture Centric Development Method
Planning related acronyms
- ETVX - Entry Task Validation eXit
- PERT - Program evaluation and review technique
MSE acronyms
- MOSP - Middle Of Semester Presentation
- EOSP - End Of Semester Presentation
ZEN Tool Glossary
- SMIG - Service Migration Interview Guide. The SMIG contains the following information in a hierarchical format
- Categories of topics to be discussed with the stakeholders
- Questions to be asked during a SMART Interview phase under each category
- Predefined answer(s) for each question. There need not be an answer at all, or there can more than one answer for each question
- Each pre-defined answer has 0..n risk factors associated with it.
- Each risk factor has 1..n mitigation strategies
- ZEN Tool - The software product delivered to the SEI. Performs functions in both client and server roles.
- ZEN Client - The set of functions within the ZEN Tool which will be used by the SEI personnel while on engagements. Functionality includes interview capturing software and report generation. The ZEN client forms the client portion of the ZEN tool.
- ZEN Server - The set of functions within the ZEN Tool which will be used as a repository for engagement information. Functionality includes report generation, SMIG maintenance, tag maintenance, and synchronization. The ZEN server forms the server portion of the ZEN tool. The ZEN client communicates with the ZEN server for various activities
- ZEN Users - The set of users authorized by the SEI to work on the SMART process. This includes technical and non-technical users
- Interviewer - This person uses the ZEN Client before and during engagement interviews. He can perform the following:
- Download engagement file
- Record answers to SMIG questions
- Apply tags to SMIG questions
- Record comments on SMIG questions
- Browse through the SMIG
- Record data in the Service and Component Tables
- Analyst - This person uses the ZEN Client and the ZEN Server after an engagement. She can perform the following:
- Upload interview data from the ZEN Client to the ZEN Server
- Consolidate multiple sets of data from the same engagement on the ZEN Server
- Download consolidated interview data from the ZEN Server to the ZEN Client
- Produce reports on the ZEN Client and/or the ZEN Server
- Admin - This person uses the ZEN Client and the ZEN Server. This person need not be a technical user. Any user who is aware of basic computer usage and who is slightly knowledgeable about the SMART process can be considered as an Admin. He can perform the following:
- Create & set up engagement files on the ZEN Server
- Create, modify, and delete custom tags
- Associate a custom list of tags with a particular engagement file
- Modify the SMIG in the following ways:
- Add a question
- Modify a question
- Delete a question (this does not actually delete the question, it simply marks it as inactive)
- Maintainer - TBD.
- Interviewer - This person uses the ZEN Client before and during engagement interviews. He can perform the following:
- Engagement - A set of interviews with a client company during which the feasibility of migrating a legacy system to a SOA architecture is determined. Involves the following phases (some of which are performed multiple times):
- Interview - A question and answer session with client representatives. The client representatives can vary in role from managers to developers. This is to ensure as much information is captured about the legacy system. Involves use of the Interview set of functions of the ZEN Client. Once this phase is complete, the Engagement shifts to the Analysis phase.
- Analysis - A review session covering all data captured to date. The purpose of this phase is to identify risks for the migration. Involves use of the reporting functions of both the ZEN Server and the ZEN Client. If further information is needed to make a final recommendation, the Engagement shifts back to the Interview phase. If a final recommendation can be made, the Engagement shifts to the Final Report phase.
- Final Report - A consolidation session where a final evaluation of the risks for the SOA migration is created and delivered to the client. Involves use of the reporting functions of both the ZEN Server and the ZEN Client.
- Engagement File - This file is initially created prior to an engagement and includes all information pertinent to the engagement. This includes:
- SMIG
- Any existing consolidated interview data
- Custom tags
- Interview Data - This represents all data captured during an Interview phase of an Engagement. Includes answers to SMIG questions, comments, and applied tags. Also includes all Service and Component table data captured. These pieces are defined as follows:
- Answers - Each question in the SMIG currently has associated predefined answers in multiple choice format. When the client answers a question during the Interview phase, the Interviewer will select the closest predefined answer.
- Comments - Because each question in the SMIG has predefined answers, often clients will answer in a way that does not fully fit one of the predefined answers. Therefore, the Interviewer may record comments on each question which notes the actual answer and expands on any related issues considered pertinent.
- Tags - When applying a comment to a question, the Interviewer may feel that the answer to a particular question is very important in terms of the SOA migration, and may wish to mark the answer for easy reference during the Analysis phase. To do so, the Interviewer will apply one or more pre-defined tags to the question. The tags will be reflected in the reports generated in the Analysis phase. In addition, the tags are used to set up the Service/Component table interface.
- SMART Templates - In addition to the SMIG questions, the Interviewer will want to capture information which fall under the category of SMART template. The service table and component table are examples of SMART templates. (TBD: Are these the only two?) The ZEN Client will provide a secondary interface to capture this information (the format of this interface has yet to be determined).
