= Authentication and Authorization module user stories =
[[TOC()]]

Definitions:
 * Data:
   * structural elements:  entities (table), fields (columns), and user interface screens
   * objects or rows:  instances of entities
 * Users:
   * anonymous user: users who are not logged in
   * authenticated user: users that have registered to the system
   * adminstrator: special authenticated user who may manage overall permissions for the MOLGENIS app.
 * Permission:
   * read permission: ability to view the data
   * write permissions: ability to edit the data
   * execute: ability to use data inside processing
   * ownership: ability to add or remove data or set permissions
   * sharing permissions: that is row-level security which is defined as defining permissions per data row/object.

== As an administrator I want to set read, write, execute and ownership permissions on entities including entities, fields, rows and screens. ==
Acceptance criteria:
 * I can define that entity Sample is editable by the group 'Students' except the column 'Name' and only within the screen 'Lab'.
 * I can define that entity Investigation is viewable to group 'Lab workers' but only column Name so that it can be used in 'xrefs'.
 * I can define that entity Protocol can be edited by 'Lab technicians' except in the screen 'All protocols'.
 * Please add!

Tickets:

 * Create an interface MolgenisElement. Make Entity, Field, ScreenModel implement MolgenisElement.
 * Create an interface Authorizable with fields owner: xref->!MolgenisUser, shareRead: xref->!MolgenisGroup, shareWrite: xref->!MolgenisGroup.
 * Extend Permission enum in DatabaseLogin to cover read, write, execute and ownership.

== As an administrator I want to be able to manage users and groups. ==
Acceptance criteria:
  *

Tickets:
 * Create a user interface to manage users and groups that is accessible to the administrator only.

== As authenticated user I want to create my private groups of users and for objects that I own add permissions on users or groups. ==

Acceptance criteria:
 * I want to indicate for each of the Investigations I own what groups are allowed to edit and view.
 * I want to be able to transfer ownership of a data objects to another user
 * I want to be able to transfer ownership on all my data object to another user
 * I want to say that my friend Peter can see all Protocols that I own but not all my ObservedValue except those ObservedValue I marked as 'public'.
 * If multiple permissions apply the narrower ones override the broader ones. 
 * Please add!

Tickets:

 * Rename !MolgenisRole to !MolgenisGroup.
 * Connect !MolgenisUsers to !MolgenisGroups using a many-many relationship. Figure out how to do that best: mref, explicit bridge table, inheritance, ...
 * Create a table that contains !MolgenisElements and connects them with !MolgenisUser's and Permissions.
 * Make Molgenis check permissions via central class. (To be refined.)
 * Create a user interface to manage permissions for the entities owned by the user that is logged in.

== As an administrator I want to have the possibility to forward permissions from an entity to others. ==
Acceptance criteria:
 * I want that I can automatically derive my permissions on 'Sample' from the sharing permissions that are set on Investigation
 * Please add!

Tickets:
 * Create a function as part of the admin interface to forward permissions from an entity to others that are connected with it (xref, mref).

== As a anonymous user I want to see all the entities I am entitled to see without logging in. ==
Acceptance criteria:
 * Please add!

Tickets:
 * Make sure that every database instance has a special 'anonymous' user
 * Make the login class to log in this public user by default.

== As an investigator I want to be able to share the permissions on all entities belonging to my investigation with other users or groups. ==
Acceptance criteria:

 * I, Erik, can give my co-workers Despoina and Robert read-only access to all the features, values and targets belonging to my investigation AnimalDB.
 * Please add!

Tickets:

 * See above.