User management

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:

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:

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-*.

User feedback

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.

comments for a source
Example of user feedback and follow-up conversation with the message input field at the bottom

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).

Excerpt of the Muscat dashboard providing an overview of the latest additions or modifications


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.