Changeset 10742 for main/eko-disco-specs

Timestamp:

14 Nov 2013, 07:46:13 (11 years ago)

Author:

Henrik Bettermann

Message:

Express relations more mathimatically. Relations can now be 'read' in both directions.

File:

• main/eko-disco-specs/trunk/data.rst (modified) (16 diffs)

main/eko-disco-specs/trunk/data.rst

@@ -50 +50 @@
 
 Connected to: :ref:`label-customer` (1:1),
-:ref:`label-contact-address` (1:|n0|), :ref:`label-contact-email`
-(1:|n0|), :ref:`label-contact-phone` (1:|n0|)
+:ref:`label-contact-address` (1:p), :ref:`label-contact-email`
+(1:n), :ref:`label-contact-phone` (1:p)
 
 Used in the following use cases:
@@ -64 +64 @@
 addresses we store some timestamp that indicates when the respective
 email address was last checked successfully (thus marking it a 'valid'
-one).
-
-Connected to: :ref:`label-contact-data` (|n0|:1),
-:ref:`label-timestamp` (1:|m0|).
+one). No timestamp means, the email address has never been checked.
+
+Connected to: :ref:`label-contact-data` (n:1),
+:ref:`label-timestamp` (1:q)
 
 Used in the following use cases:
@@ -79 +79 @@
 Mobile phone number which is capable of receiving sms text messages.
 
-Connected to: :ref:`label-contact-data` (|n0|:1)
+Connected to: :ref:`label-contact-data` (n:1)
 
 Used in the following use cases:
@@ -104 +104 @@
 become due, a respective :ref:`label-transaction` is triggered.
 
-Contracts can have multiple :ref:`label-contract-addon`.
-
-Connected to: :ref:`label-service` (|n0|:1), :ref:`label-customer` (|n0|:1),
-:ref:`label-contract-addon` (1:|n0|), :ref:`label-transaction` (|n0|, |m0|)
+Contracts can have multiple :ref:`label-contract-addon`\ s.
+
+Connected to: :ref:`label-service` (p:1), :ref:`label-customer` (p:1),
+:ref:`label-contract-addon` (1:p), :ref:`label-transaction` (p:q)
 
 Used in the following use cases:
@@ -121 +121 @@
 parameters. Contract addons are created by :ref:`label-contract`\ s.
 
-Connected to: :ref:`label-contract` (|n0|:1)
+Connected to: :ref:`label-contract` (p:1)
 
 
@@ -149 +149 @@
 - get help if problems arise
 
-- retrieve bills.
-
-- reset their passwords if forgotten.
+- retrieve bills
+
+- change their passwords
 
 Customers can order :ref:`label-service`\ s and pay these (kinds of
@@ -160 +160 @@
 instance when postal addresses change), and by staff members.
 
-Connected to: :ref:`label-contract` (1:|n0|),
-:ref:`label-contact-data` (1:1), :ref:`label-login-credentials` (1:1).
+Connected to: :ref:`label-contract` (1:p),
+:ref:`label-contact-data` (1:1), :ref:`label-login-credentials` (1:1)
 
 
@@ -174 +174 @@
 for instance describing a location in words.
 
-Connected to: :ref:`label-meter` (1:1)
+Connected to: :ref:`label-meter` (1:p)
 
 
@@ -187 +187 @@
 Passwords can be reset on request.
 
-Connected to: :ref:`label-customer`
+Connected to: :ref:`label-customer` (1:1)
 
 
@@ -206 +206 @@
 at a given time.
 
-Connected to: :ref:`label-contract` (|n0|:\ |m0|),
-:ref:`label-meter-value` (1:|m0|), :ref:`label-location` (1:n)
+Connected to: :ref:`label-contract` (b:1),
+:ref:`label-meter-value` (1:n), :ref:`label-location` (p:1)
 
 
@@ -238 +238 @@
 prepared to collect meter data from external devices.
 
-Connected to: :ref:`label-meter` (|n0|:1), :ref:`label-timestamp` (1:1),
-:ref:`label-user`.
+Connected to: :ref:`label-meter` (p:1), :ref:`label-timestamp` (1:1),
+:ref:`label-user` (p:1)
 
 
@@ -274 +274 @@
 Services also serve as factories for :ref:`label-contract`\ s.
 
-Connected to: :ref:`label-contract` (1:|n0|),
+Connected to: :ref:`label-contract` (1:p)
 
 Used in the following use cases:
@@ -292 +292 @@
 
 Connected to: :ref:`label-meter-value` (1:1),
-:ref:`label-contact-email` (1:1)
+:ref:`label-contact-email` (p:1)
 
 
@@ -310 +310 @@
 is consumed, purchased, or (pre-)paid by the respective customer.
 
-Connected to: :ref:`label-customer` (1:|n0|), :ref:`label-service`
-(|n0|:1)
+Connected to: :ref:`label-customer` (p:1), :ref:`label-service`
+(p:1)
 
 Used in the following use cases:
@@ -334 +334 @@
 Users can be blocked or removed from the system.
 
-Connected to: :ref:`label-login-credentials`.
+Connected to: :ref:`label-login-credentials` (1:1), :ref:`label-user-role` (p:q)
 
 
@@ -344 +344 @@
 A role assigned to a group of :ref:`label-user`\ s.
 
-Connected to: :ref:`label-user` (1:|n0|).
-
-
-.. [#] Relation types: (1:1): One-to-one, (1:n): One-to-many, (n:1):
-       many-to-one, (n:m): many-to-many. ``n`` and ``m`` mean some
-       value ``1..n``. To indicate zero or more (``0..n``) relations,
-       we use |n0| and |m0| respectively.
+Connected to: :ref:`label-user` (p:q)
+
+
+.. [#] Relation types: (1:1): one on one, (1:n): one on many, (n:1):
+       many on one, (n:m): many on many, (1:p): one on many or none,
+       (p:1): many or none on one, (p:q): many or none on many or none,
+       (1:b): one or none on one, (b:1): none or one on one
+
+       In mathematical terms:
+
+       n and m are elements of {1, 2, ...},
+       p and q are elements of {0, 1, 2, ...},
+       b is element of {0, 1}
+
+