= V2 Dashboard =

[[V2Master]] | [[V2HighLevelDesign]]

  <<TableOfContents>>

= Requirements =

The V2 Dashboard has two parts:

 1. ''Recent Project Activity'' - A list of recently created and updates items of the entire system
 1. ''My Notifications'' - A list of new and updated items associated with the current user

There should be separate menu items for each of these transactions.


= Recent Project Activity =

== Display Screen ==

 1. The Recent Project Activity should be a screen with:
    1. ''Add Items to Clipboard / Dossier'' block
    1. A row for each item which (see below for the columns)
    1. ''Number of Days'' field, with a default value from the system settings
    1. A refresh button

 1. Each item, e.g. row in the block, has the following fields:
    1. ''Sel'' - Select check box for adding items to the Clipboard or Dossier
    1. ''Type'' - The item type (Revision, Task, etc.)
    1. ''Operation'' - The text ''New'' or ''Update'', as appropriate
    1. ''Associated Object'' - Link to the object to which the item is linked. Could be empty 
    1. ''Code'' - Link to the item's detail screen
    1. ''Description'' - Title, description or subject/start of note text (as appropriate)
    1. ''Folder'' - The folder where the item or it's associated object is located
    1. ''Issuer'' - The issuer or creator of the item. Might not be available for all item types.
    1. ''Who'' - User that performed the new or update operation
    1. ''Date'' - Date [and time?] of the item creation or update

Notes:

 1. It may not be possible to fill all columns for all item types
 1. The columns and column order should be reviewed
 1. The order of the items is the latest operation at the top, follower by earlier items 

== Configuration ==

 1. The exact contents of a user's Recent Project Activity screen is defined in the user's profile.
 1. There is a configuration screen, consisting of multiple configuration entries.
 1. Each configuration entry contains the following fields:
    1. ''Type'' - A select box for the component type, which is one of:
       1. All - All possible item type
       1. Revisions
       1. Revision Files
       1. Tasks
       1. Transmittals
       1. Users
       1. Notes
    1. ''New'' checkbox - If selected then new entries are displayed 
    1. ''Update'' checkbox - If selected then update entries are displayed
    1. ''Folder'' select - The folders, including sub-folders, where the items are located. 
       1. Defaults to ''All'', which means all folders that the user has access to

Notes:

 1. New configuration entries can be created
 1. Existing configuration entries can be deleted
 1. There must be at least one configuration entry. The last entry cannot be deleted

The default configuration is:

  1. Single configuration entry
  1. ''Type'' - ''All''
  1. ''New'' checkbox - selected
  1. ''Update'' checkbox - not selected
  1. ''Folder'' select - ''All'' selected

== Simplified Configuration ==

 1. The configuration is not part of the user profile
 1. The configuration can be changed on the Recent Project Activity screen, pressing the refresh button re-displays the screen
 1. The current configuration can be saved by pressing the "Save Configuration" button, or it will be silently stored if the refresh button is pressed.
 1. If the user has a saved configuration, it is used as default on a new Recent Project Activity screen
 1. A configuration contains a type list (see above) without the ''all'' type, at least one actions from ''New'' and ''Update'', at least one folder (can be the root folder)
 1. If it is really needed, we could add a name to a configuration and a user could have more than one configuration, which can be selected on the Recent Project Activity screen.

= My Notifications =

  1. The ''My Notifications'' screen is similar to the ''Recent System Events''
     1. The display is the same
     1. The configuration has the following differences:
        1. The configuration includes a ''Send Email'' checkbox 
           1. This replaces the current note email checkbox in the user profile
  1. The exception is that the notifications are limited to items that are ''associated'' with the user
     1. Where the user is a subscriber (e.g. issuer, recipient, subscriber)
     1. Is the ''who'' of a ''next up'' workflow step [to be defined when workflows are designed]