User management in Muscat is essential for controlling read and write access to the data. It not only needs to be highly secure and robust, but also flexible because the user access policy can change over time and the corresponding adjustments must be simple to do. Muscat uses the standard Ruby on Rails plugins for this, namely:
- Devise used for the authentication and the login
- Rolify used for creating different kinds of roles and assigning them to users
- CanCan used for defining abilities and access to users with different kinds of roles
Each class in the data model has an ownership field for controlling the access rights in each instance. This means that, for example, each manuscript description has an owner, as does each entry in the authority data. With this in hand it is possible to define roles and for each role to define abilities for each class. For example, we can configure Muscat in order to have:
- unregistered guest user access (potentially without login) that can only search and view the data but modify nothing; access to some resources can be forbidden if desired
- registered guest user access with read only access and write access for adding comments to resources (see below)
- cataloguer user access that can create new source descriptions (which they will own) but not modify or delete any entries they do not own
- editor user access who can also edit resources, including authorities, owned by other users
- admin user access with full rights, including ownership and user management
These are only examples and the number of roles can be extended and refined as desired. Muscat also implements a concept of user workgroups. Traditionally, these would represent the working group of a country but it does not have to. In Muscat, access rights for a workgroup are given using library sigla, for example D-B, D-Bsa, D-NEZsn. They can also be specified using patterns with wildcards. For example, a workgroup can receive access to all libraries in Geneva with the expression ^CH-G*, or to all libraries in Brazil with the pattern ^BR-*.
All resources in Muscat have an embedded comment field for registered users to provide feedback messages. A message remains attached to the resources (e.g., the manuscript description) together with follow-up messages, making it a discussion-like feature. The messages can be deleted when necessary.
When a message is added to a resource its owner will automatically receive an email notification about it. It is also possible to configure Muscat for the message also to be send to other email addresses, for example to editors or administrators that are in charge of a particular resource set (e.g., personal name authorities).
A dashboard in Muscat provides the users with an overview of the latest activity. For each of the main resources (sources, personal names, secondary literature and institution) a list of the latest changes is given. Users can choose to see their changes or all the changes. They can also opt to see the latest additions (recently created) or the latest modifications (recently updated).
For people wishing to follow additions and modifications in Muscat, it is time-consuming and unrealistic to have to keep checking it occasionally to see if a source or another entry has been added or modified. The version of Muscat (5.0) includes the ability to create alerts following the creation or modification of entries. Alerts are set with patterns and fields. For example, a user might want to create an alert for sources matching a certain library sigla and/or a shelfmark, or sources composed by a certain composer. Once this is set in the user profile, the user receives weekly notifications with a list of created and modified entries matching the alert.
Mentions in comments
Comments are more interactive in Muscat 5.0 with the option to use @mentions for addressing other Muscat users directly. Typing the @ will trigger a list of users to be displayed. Users mentioned in a comment will be notified by e-mail and will also receive further notification when additional comments are entered for a resource.