(SPEC) Redesign the first screen
UI prototypes for this blueprint: http://
Blueprint information
- Status:
- Complete
- Approver:
- Johannes Wettinger
- Priority:
- Medium
- Drafter:
- Davide Casciato
- Direction:
- Needs approval
- Assignee:
- Davide Casciato
- Definition:
- Approved
- Series goal:
- Accepted for 1.3
- Implementation:
- Implemented
- Milestone target:
- None
- Started by
- Davide Casciato
- Completed by
- Johannes Wettinger
Related branches
Sprints
Whiteboard
1. REQUIREMENTS & SPECIFICATION
Topic of this blueprint is the redesign of the AssistantDialog which opens up after starting the application. Reasons for the redesigning are:
- One important function (aspects-manager) is not available in the first screen.
- There are currently too many redundant information and functions in the assistant (aspects-manager in each mode).
- Some features are not necessary (open existing review in the instant review mode).
- Currently, you have to click too many times to achieve certain goals (open an existing review via file chooser).
Summary of reasons: The redesigning of the startup screen is necessary to improve the usability of the assistant.
Resulting requirements:
- improving the first screen within it's functions and design.
- summarizing redundant views (information and functions).
- removing superfluous features.
- redesigning for faster usage.
----
2. USE CASES
2.1. SCHEDULE NEW REVIEW
[ACTORS]
Moderator
[PRECONDITION]
- The application is running
- The assistant dialog is shown
[NORMAL FLOW OF EVENTS]
(1) While the actors cursor hovers over the 'Schedule new review'-button the description text for this function is shown in the header of the assistant dialog
(2) The actor clicks on 'Schedule new review'
(3) A new review is created
(4) The mainframe in the so called moderator mode is shown
[POSTCONDITION]
A new review in the moderator mode has been arranged.
[ALTERNATIVE FLOWS OF EVENTS]
none
--
2.2. SCHEDULE NEW REVIEW ON QUICKSTART
[ACTORS]
Moderator, Scribe
[PRECONDITION]
- The application is running
- The assistant dialog is shown
[NORMAL FLOW OF EVENTS]
(1) While the actors cursor hovers over the 'Quickstart'-button the description text for this function is shown in the header of the assistant dialog.
(2) The actor clicks on 'Quickstart'
(3) The actor enters his personal information and confirms his input.
(4) A new review is created
(5) The mainframe in the so called instant review mode is shown
[POSTCONDITION]
A new review in the instant review mode has been arranged.
[ALTERNATIVE FLOWS OF EVENTS]
(3a) The actor selects himself out of the address book and confirms
--
2.3. OPEN EXISTING REVIEW
[ACTORS]
Scribe
[PRECONDITION]
- The application is running
- The assistant dialog is shown
[NORMAL FLOW OF EVENTS]
(1) While the actors cursor hovers over the 'Open existing review'-button the description text for this function is shown in the header of the assistant dialog.
(2) The actor clicks on 'Open existing review'
(3) The assistant dialog will change it's contents (See:prototype6
(4) The actor selects his role in this review out of the combobox
(5) The components below the mode selection are enabled
(6) The actor selects one file via file chooser and confirms his selection by clicking on the 'open'-button
(7)The selected review opens up in the mainframe
[POSTCONDITION]
The selected review in the mainframe has been opened up.
[ALTERNATIVE FLOWS OF EVENTS]
(6.b) The actor clicks on one review of the listed review-file-links.
--
2.4. SELECT LANGUAGE
[ACTORS]
User
[PRECONDITION]
- The application is running
- The assistant dialog is shown
[NORMAL FLOW OF EVENTS]
(1) While the actors cursor hovers over the 'Select language'-button the description text for this function is shown in the header of the assistant dialog.
(2) The actor clicks on 'Select language'
(3) A pop-up with the selectable languages opens up
(4) The user selects one of them and confirm his selection by clicking on the 'confirm'-button.
(5) Regarding to his choice, the application will be updated after a restart of the application.
[POSTCONDITION]
The application will start in the selected language after a restart of the program.
[ALTERNATIVE FLOWS OF EVENTS]
(4.b) The user uses the 'cancel'-button or closes the pop-up.
--
2.5. OPEN ASPECTS MANAGER
[ACTORS]
User
[PRECONDITION]
- The application is running
- The assistant dialog is shown
[NORMAL FLOW OF EVENTS]
(1) While the actors cursor hovers over the 'Open aspects manager'-button the description text for this function is shown in the header of the assistant dialog.
(2) The actor clicks on 'Open aspects manager'
(3) The aspects manager opens up in a new window.
[POSTCONDITION]
The focused and maximized aspects manager is shown. The application stays in it's state. This means that the empty mainframe with the assistant dialog is allready open but not focused.
[ALTERNATIVE FLOWS OF EVENTS]
none
----
3. DESIGN & TECHNICAL SOLUTION
The whole assistant dialog will be re-implemented. After removing the class 'org.revager.
AssistantDialog (extends AbstractDialog) - the assistant dialog itself which contains one of the following panels
FirstScreenPanel (extends AbstractDialogP
OpenReviewPanel (extends AbstractDialogP
AddAttendeePanel (extends AbstractDialogP
The AbstractDialogPanel contains the following property 'private AbstractDialog parent' as well as the following constructor and method
public AbstractDialogP
public void setHint(String hintText) { parent.
and will be located inside the 'org.revager.gui' package. By this strategy we can access the description text area inside the dialog itself.
Inside the AssistantDialog class there is one private property for each "screen class".
----
4. UNIT TESTING
For this feature there is no unit testing because it is part of the user interface only.
----
5. SYSTEM TEST
This feature is tested by running each of the Use Cases defined above. The results of the execution(s) of this test will be recorded here.
5.1. TEST PROTOCOL 2010-05-27
[USE CASE 2.1]
Ok, no errors (normal flow of events)
[USE CASE 2.2]
Ok, no errors (normal flow of events)
[USE CASE 2.3]
Ok, no errors (normal flow of events)
[USE CASE 2.4]
Ok, no errors (normal flow of events)
[USE CASE 2.5]
Ok, no errors (normal flow of events)