.. _label-uc-user-add:

Add a User Account
***********************************************************************

Short Description
-----------------------------------------------------------------------

A user account and connected user data entities are added.

Actor(s)
-----------------------------------------------------------------------

Officer


Trigger(s)
-----------------------------------------------------------------------

- Imports (adding existing data)
- Web form(s) submitted by authorized user


Result(s)
-----------------------------------------------------------------------

- A new user account was created in system with a new unique user ID.

- The password has not been set.

- Depending on the user role assigned, user data entities like
  'Officer' or 'Customer' were automatically created.


Incoming Data
-----------------------------------------------------------------------

- Real name
- Email address / mobile phone number


Outgoing Data
-----------------------------------------------------------------------

- Message about user account creation
- Email to user about user account creation
- Log message


Precondition(s)
-----------------------------------------------------------------------

- Submitting user must be authorized to perform the operation.


Postcondition(s)
-----------------------------------------------------------------------

- Anonymous user can use a 'Request Password' form to
  retrieve a new password which is being sent to the email address
  stored in the user account. This process is described in
  onther use case (to be added).


Invariant(s)
-----------------------------------------------------------------------


Essential Steps
-----------------------------------------------------------------------

- System receives parameters specifying the user account to create.
- System creates a unique user ID.
- Passed in parameters are validated.
- If passed-in parameters are invalid, user is offered a possibility
  to fix the invalid data.
- System creates the new user account and connected user data entities.


Open Issues
-----------------------------------------------------------------------



Remarks
-----------------------------------------------------------------------


.. raw:: latex

      \