Skip to content

Detailed Epic - User Management

User View

AS a user administrator I WANT to register collaborators and PDMs on the platform SO THAT I can manage the platform's users.

Business Narrative

An administrator needs a feature that allows them to register, edit, and deactivate collaborators and PDMs, recording information such as name, email, role, and PDM.

A collaborator is a user who will have a PDM linked to them and will be able to create feedback requests.

A PDM is a user who may or may not have a PDM linked to them. If they have a PDM associated with them, they will also be considered a collaborator and can create feedback requests. However, if they do not have a PDM associated with them, they cannot create feedback requests.

Screen Flow

USER LIST

  1. The administrator accesses the user list, which, in addition to the list, contains a button to create a new user.
  2. The list contains all registered users with their name, email, and type, as well as access to edit and delete/deactivate functions.

NEW USER

  1. By clicking the button to create a new user, the administrator accesses the new user registration screen.
  2. The administrator fills in the fields: name, email, user type (collaborator or PDM), role, and the collaborator's PDM login.
  3. If the user type is PDM, the PDM login field is not mandatory.
  4. All other fields are mandatory.
  5. To create a collaborator, it is mandatory to inform a PDM. In the case of a PDM, they may or may not have their own PDM.
  6. The administrator clicks the "Register" button.
  7. The system saves the user's information and records the creation date.
  8. The system displays a registration confirmation message.

EDIT USER

  1. To edit a user, the administrator accesses the registered user list and selects the desired user.
  2. The system displays the screen filled with the selected user's information.
  3. The administrator changes the desired information and clicks the "Save" button.
  4. The system saves the changes and records the edit date.

DELETE USER

  1. To delete/deactivate a user, the administrator accesses the registered user list and selects the desired user.
  2. The system displays a deletion/deactivation confirmation message.
  3. The administrator clicks the "Delete/Deactivate" button.
  4. The system deletes/deactivates the user and records the deletion/deactivation date.

Non-Functional Requirements

  • The registered user list must have pagination behavior.

Acceptance Criteria

  • The system must allow the registration of collaborators and PDMs.
  • The system must allow the editing of user information.
  • The system must allow the deletion/deactivation of users.
  • The system must record the creation, edit, and deletion/deactivation dates.
  • The system must display a confirmation message after registering, editing, or deleting/deactivating a user.

Stories Overview

mmd

Registration of Collaborators and PDMs

  1. User Listing

    • Implement endpoint to list users
    • Implement pagination and filters
    • Develop user interface for listing

  2. User Registration

    • Implement endpoint for user registration
    • Implement data validations (unique email, required fields)
    • Develop user interface for registration
    • Implement an endpoint that lists only PDMs to populate the PDM selection combobox

  3. User Editing

    • Implement endpoint for user editing
    • Implement data validations
    • Develop user interface for editing

  4. User Deactivation

    • Implement endpoint for user deactivation
    • Implement soft delete
    • Develop user interface for deactivation