Skip to main content

4.4. Application Administrator - Create users

Id 4.4.
Description As a Application Administrator,

I must be able to create user accounts and assigning them the appropriate roles,

So that I can control access to the system and ensure that each user has the correct permissions based on their responsibilities.
Priority High
Actors Application Administrator
API Calls GET /admin/api-users
POST /admin/api-users
Linked Processes
Status Implemented

Preconditions

  1. The User must be authenticated and have the Application Administrator role.
  2. The system must have a list of predefined roles available for assignment.

Postconditions

  1. The user list is updated with the new accounts.
  2. All assigned roles are correctly enforced by the system

Main flow

  1. he Application Administrator retrieves a list of existing users with their details and roles (GET).
  2. The Application Administrator uses an API to add a new user by entering required details (e.g., name, email) and assigning roles (POST).
  3. The system validates the input data.
  4. The system saves the changes and updates the user list.

Exceptions

[400 Bad Request] Invalid input:

If mandatory fields are missing or invalid, the system returns an error message.

[409 Already Exists] Duplicate User

If the Application Administrator attempts to add a user with an email already registered, the system returns an error and prevents duplicate creation.

[500 Internal Server Error] System Error

If the system fails to save changes due to an internal error, it displays an appropriate message and logs the error for further investigation.