.. _label-uc-service-add:

Use-Case: Add a service
***********************************************************************

.. Description of a use case
.. The description must be formulated as seen from system (not: actors)
.. Describes those changes an (outside) actor can notice
.. Short and abstract as possible, as long as necessary.
.. Each use case must have at least one actor involved
.. Each use case must have a trigger and a result


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

A service is added.

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

Staff


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

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


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

- A new service is available for customers/staff.

- Contracts can be created from the new service.


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

- Title
- Description
- Service terms (various data about what special options the new
  service provides, constraints, etc.).


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

- Message about service creation.
- Log message


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

- Submitting user must be authorized to perform the operation.


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

- The new service is able to create contracts.


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


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

- System receives customer ID, service ID and any optional parameters
  specifying the contract to create.
- System creates a unique service ID.
- Passed in terms, title, and description are validated.
- If passed-in parameters are invalid, user is offered a possibility
  to fix the invalid data.
- System creates the new service.


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



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


.. raw:: latex

      \pagebreak[4]