UC AWOB CM 03 Manage Consortium Project

MPDL,GAVO

R0.8

=CM_03_Manage_Consortium_Projects=

Usage Scenarios

 * 1) A working group discusses projects and decides who leads which project.
 * 2) Once a project is agreed on the WG chair or the PI of the project announces it to consortium.
 * 3) Depending on consortium policy one of the followings may occur
 * 4) A steering committee explicitly approves the project
 * 5) The project is in progress as long as no complaint from consortium members.
 * 6) There is a conflict with other projects and the steering committee resolves the conflict.
 * 7) If approved explicitly or no conflict a project is in progress.

Project Statuses in consortium.
A project can have more than one status since members of a consortium or a WG are interested in different project

information. Therefore, a status is defined for each context or scope.

Statuses in different contexts.


 * 1) Project’s own status:
 * 2) Provide information to whether the project’s status to the project members, WG or consortium members if relevant.
 * 3)  differs from AWOB project status ‘open’ and ‘closed’
 * 4)  A piece of information. No workflow is defined
 * 5) Enumeration
 * 6) Pending
 * 7) In progress
 * 8) Completed
 * 9) Even if a project status is either completed, or cancelled, the project is still editable not like in task.
 * 10) Cancelled
 * 11) Status in WG context: ‘WG project status’
 * 12) It is to share information with all members of a given WG that a project proposed, accepted/approved, or rejected/disapproved.  For example, a proposed project is discussed in the WG before announcing it to consortium, and the WG members can request to join the project.
 * 13) Proposed
 * 14) Accepted/Approved
 * 15) Rejected/Disapproved
 * 16) Withdrawn
 * 17) Status in Consortium context: ‘consortium project status’
 * 18) Proposed
 * 19) Accepted/Approved
 * 20) Rejected/Disapproved
 * 21) Withdrawn

WG Project vs project in conceptual model.
A WG can have 0…N number of WG projects. A WG project is a composite association b/w a WG and its project. It has a

pointer to a project, and has an attribute ‘status’ (henceforth called ‘WG project status’ to distinguish).

Consortium Project vs project in conceptual model.
Similar to a WG project, a consortium project is a composite association b/w a consortium and a project. As in WG project it has a pointer to a project and an attribute ‘status’ (henceforth called ‘Consortium project status’ to distinguish). There are two scenarios to create a consortium project in a consortium:
 * 1) Create a project in a WG, and announce it to consortium. In conceptual model terms, it means that for each project there are two associations, one with a WG project, the other, with  a Consortium project:  In this scenario, a project may have three different statuses:
 * 2)  Project’s own status
 * 3) Status in WG context: WG project status
 * 4) Status in Consortium context: consortium project status
 * 5) Create a project directly in consortium level even if there are WGs in consortium. (See UC CM_03_1_Create_Project_In_Consortium) In this scenario, a project may have two different statuses:
 * 6)  Project’s own status
 * 7) Status in Consortium context: consortium project status

Actors

 * 1) consortium lead
 * 2) consortium manager
 * 3) Consortium Project Manager

Preconditions

 * 1) The system status of consortium is open.

Steps

 * 1) From page showing Consortium project list actor chooses an option to add a Consortium project (or create project).
 * 2) Actor is sent to standard "create project page".UC_AWOB_PM_01SPEC_Create_Project
 * 3) Short Name(mandatory) - indicate required field, explain rule if exists (eg., white space allowed? max length? something like info button)
 * 4) Title (optional)
 * 5) Goal (optional)
 * 6) Project status(mandatory):
 * 7) Enumeration
 * 8) Pending(default)
 * 9) In progress
 * 10) Completed:
 * 11) Cancelled
 * 12) Actor submits one of the followings:
 * 13) go to ‘Overview’ of the workspace of the new project.
 * 14) go back wherever it was.
 * 15) Cancel
 * 16) the system validates the request.
 * 17) Check whether all the mandatory fields are provided by the actor.
 * 18) The validation rules are similar to those implemented for standalone project.
 * 19) Uniqueness: Depending on what the project url consists of,  unique awob-wide
 * 20) If valid
 * 21) the system creates a new consortium project (see Post conditions.).
 * 22) If not valid
 * 23) the system shows the error messages: what's missing, or what's wrong with given values.

Post conditions
For valid request:


 * 1) The system creates a project(similar to Create project use case).
 * 2) It shows up on consortium project list immediately.
 * 3) Default consortium project status = ‘proposed’
 * 4) For setting consortium project status see CM_03_4_Change_Consortium_Project_Status
 * 5) It appears on the project list in the actor’s personal workspace.
 * 6) It appears on what's new of the affected consortium with category like ‘consortium projects’.
 * 7) It is notified to the members of the affected consortium by
 * 8) Email
 * 9) AWOB notification
 * 10) Depending on actor’s choice  the system  brings up
 * 11) ‘overview’ of new project if actor chose to go to ‘overview’ of the new project, or
 * 12) Consortium project list if actor chose to consortium project list.

Actors
Any consortium members can view consortium project list.


 * 1) consortium lead
 * 2) consortium manager
 * 3) Consortium Project Manager
 * 4) Consortium Member

Steps

 * 1) Actors browse consortium project list.
 * 2) See fig.

Post conditions

 * 1) For any consortium member following options are available:
 * 2) Request to join membership

CM_03_3_Edit_Project_Metadata_in_Consortium
Until R0.7 both project/consortium lead and manager were able to edit project/consortium/WG metadata. However, the use case is changed so that only Project Lead can change project metadata and the way to keep log of its metadata changes.

Actors

 * 1) Project Lead

Preconditions

 * 1) The selected project’s AWOB system status is ‘open’.
 * 2) The selected consortium’s AWOB system status is ‘open’.

Steps

 * 1) Actor can change the following metadata:
 * 2) Title
 * 3) Goal
 * 4) Status(project)
 * 5) Submit.

Post conditions
The system does the followings:
 * 1) Save the change.
 * 2) Display the change in what’s new of the selected project. (in a category like project info)
 * 3) Modify the layout of project overview. [ To discuss]
 * 4) Synchronize Consortium project list according to the change.
 * 5) The following is up to discussion
 * 6) Display the change in what’s new of the consortium where the project belongs to. (in a category like Consortium projects)[ To discuss]

CM_03_4_Change_Consortium_Project_Status
This use case applies for a project created in consortium level. For changing consortium project status of a project created in WG level, see UC_08_‘Consortium Project Status’
 * 1) mandatory only if project is announced or created in consortium level
 * 2) Enumeration(wording)
 * 3) Proposed(default): actor propose it to working group
 * 4) Accepted/Approved
 * 5) Rejected/Disapproved
 * 6) Withdrawn

This use case applies for a project created in consortium level. For changing consortium project status of a project created in WG level, see UC_08_6 Change Consortium Project Status of WG Created Project

Actors
In the consortium where a selected project is defined
 * 1) consortium lead
 * 2) consortium manager
 * 3) Project Lead who is also a  consortium project manager
 * 4) The additional condition for a Project Lead being at least a consortium project manager is to provide preventive measures against abusing the system. A consortium lead or manager can demote him/her to consortium member if there is a proof that he/she misbehaves in the consortium

Preconditions

 * 1) The selected project’s AWOB system status is ‘open’.
 * 2) The selected consortium’s AWOB system status is ‘open’.

Steps

 * 1) From consortium project list, actor changes ‘consortium project status’ of a project:

Post conditions

 * 1) The system saves the change.
 * 2) The change shows up in what’s new
 * 3) of the consortium where the project belongs to. (in a category like consortium projects)
 * 4) The following is up to discussion
 * 5) of the selected project. (in a category like project info or  overview)
 * 6) Synchronize consortium project list according to the change.
 * 7) Notify
 * 8) Whom
 * 9)  Either all consortium members or
 * 10)  consortium lead,
 * 11)  consortium manager,
 * 12)  Project Lead
 * 13) By
 * 14)  AWOB notification
 * 15)  email
 * 16) If the status is ‘completed/cancelled’
 * 17) Is the project still editable? Yes as long as  the awob system status of the project is open.

CM_03_5_Change_Project_Overview
This use case is the same as changing ‘overview’ a stand-alone project which is already implemented.

Actors

 * 1) Project Lead
 * 2) Project manager