Coding.md: UI defined

CODING.md

@@ -46,7 +46,7 @@ SAVE
 ----
 * Via wrapper api/save.php
 * SID must be supplied via FORM POST
-* The SID supplies the <formname> and the <redordid>
+* The SID supplies the <formname> and the <recordid>
 * form.render: plain/table/bootstrap
   * Client will handle the response of save.php.
   * Optional redirection initiated by client.
@@ -73,7 +73,83 @@ DELETE
    
      <button type="button" class="record-delete" data-sip={{SIP}} ><span class="glyphicon glyphicon-trash"></span></button>
 
-* 
+USER INTERFACE
+==============
+
+Button status
+-------------
+* Form modified:
+  * Buttons enabled: Save, Close, New, Delete
+  * Button disable: -
+  
+* Form not modified:
+  * Buttons enabled: Close, New, Delete
+  * Button disabled: Save
+
+Save Button 
+-----------
+* User presses the button
+  * Form is submitted to server
+    * Success: 
+       * Current formelements and data will be reloaded.
+       * Process server reponse 'redirect':
+           * 'client': No redirect.
+           * 'no': No redirect.
+           * 'url': Redirect to URL
+    * Failure: Happens on communication errors, if data validation fails, form actions fails or saving data fails. 
+       * Show error message.
+       * Client: Ignore server reponse 'redirect'. Client stays on current page.
+    
+
+Close Button
+------------
+* User presses the button
+  * Form not modified by user: Client redirects to previous page.
+  * Form modified by user: Ask User 'You have unsaved changes. Do you want to close?'
+    * Yes: Client redirects to previous page.
+    * No: Client stays on current page.
+    * Save & Close: 
+      * Client submits form to server.
+      * Success: Process server response 'redirect':
+        * 'client': Client stays on current page.
+        * 'no': No redirect.
+        * 'url': Redirect to URL
+      * Failure: Happens on communication errors, if data validation fails, form actions fails or saving data fails. 
+        * Show error message. 
+        * Client: No redirect. Ignore server reponse 'redirect'.
+
+Delete Button: Main record
+--------------------------
+* User presses the button. Ask User 'Do you really want to delete the record?
+  * Yes: 
+    * Delete record on server.
+    * Process server reponse 'redirect':
+      * 'client': Client redirects to previous page.
+      * 'no': Error message.
+      * 'url': Redirect to URL
+  * No:
+    * Client does not delete record on server.
+    * No redirect. Client stays on current page.
+
+New Button
+----------
+* User presses the button
+  * Form not modified by user: Client redirects to href url.
+  * Form modified by user: Ask User 'You have unsaved changes. Do you want to save first?'
+    * Yes:
+      * Form is submitted to server
+        * Success:
+          * Client: Ignore server reponse 'redirect'. Client redirects to href url.
+        * Failure: Happens on communication errors, if data validation fails, form actions fails or saving data fails. 
+           * Show error message.
+           * Client: Ignore server reponse 'redirect'. Client stays on current page.
+    * No: 
+      * Client does not save the modified record.
+      * Client redirects to href url.
+    * Cancel:
+      * Client does not save the modified record.
+      * Client stays on current page.
+  
   
 Debug / Log / Errormessages
 ===========================
@@ -155,4 +231,6 @@ Checkbox
         <label>
             <input type="checkbox">label 1
         </label>
-    </div>
\ No newline at end of file
+    </div>
+    
+    
\ No newline at end of file