initialize repository; add docker config; migrate configuration to new specsHEADmaster

1 files changed, 126 insertions, 0 deletions

diff --git a/public/readme.txt b/public/readme.txt
new file mode 100644
index 0000000..22700d4
--- /dev/null
+++ b/public/readme.txt
@@ -0,0 +1,126 @@
+Kallassa Application
+---
+
+Η εφαρμογή εκτελεί διεργασίες UI και DO
+- μια UI διεργασία προετοιμάζει το User Interface για την επικοινωνία/input του Χρήστη
+- μια DO διεργασία επεξεργάζεται το input του Χρήστη και γράφει στην DataBase
+
+Γενικά το input μιας διεργασίας UI στέλνεται σε (και επεξεργάζεται από) μία συνονόματη διεργασία DO
+
+Όλες οι διεργασίες ξεκινούν φορτώνοντας τα
+-- config/parametres.php
+-- includes/sessions.php
+
+(πλην των περισσότερο 'στατικών' ui-login.php και ui-panel.php που φορτώνονται από το index.php)
+
+
+
+
+File names
+---
+
+ui-new-* : Prepare UI for new record
+do-new-* : Handle a new-record request (and write to DB)
+
+ui-upd-* : Prepare UI for updating (edit) a record
+do-upd-* : Handle an update-record request (and write to DM)
+
+ui-inf-* : Informative page (may has buttons to call a UI-NEW or UI-UPD)
+ui-prn-* : Informations on print format (pdf)
+
+
+
+
+Files so far:
+---
+
+ui-new-item   : UI for a new item
+  -> ajax.php?do=
+  -> ajax.php?do=
+
+ui-upd-ccode  : update ccode parameters (set local name for category)
+do-upd-ccode  : proccess the request (and write new json to database)
+
+ui-inf-items  :
+
+
+
+
+
+
+
+Προσωρινοί πινακες - θα φτιαχτούν με
+---
+
+CREATE TABLE new_tbl LIKE orig_tbl; (if not exist - ή θα προηγηθεί drop)
+Ένας για κάθε (τελική/χρησιμοποιούμενη) κατηγορία
+Θα τοποθετούνται τα rows του βασικού πίνακα έτσι ώστε να έχουν ειδική αρίθμηση (ανά κατηγορία)
+πχ.
+τα αντικείμενα της κατηγορίας "Γυναικεία Φορεσιά : 2. Ζωνάρι"
+θα τοποθετούνται στον προσωρινό πίνακα "ti_11_2"
+κι έτσι κάθε ένα αντικείμενο θα έχει μια αρίθμηση (εντός της κατηγορίας του)
+ούτως ώστε να προκύπτει η αρίθμηση (αν πχ υπάρχουν 7 αντικείμενα): 1/7, 2/7 κ.ο.κ.
+
+
+
+
+Χρησιμοποιούμενες Δομές
+---
+
+ccode.json :
+[
+  {
+    "id"  : Κωδικός κατηγορίας
+    "tag" : Ονομασία (τελική) κατηγορίας
+    "cat" : Κύρια κατηγορια (Α)
+    "sub" : Υποκατηγορία (Β)
+    "div" : Υποδιαίρεση υποκατηγορίας (Γ)
+    "local" : Τοπική ονομασία
+    "idx" : inxex Προσωρινού στοιχείου (πχ πίνακας για αρίθμηση αντικειμένων ή για εικόνα αντικειμένου)
+                ( πχ
+                  ο προσωρινός πίνακας για την κατηγορία αα.1 θα έχει το όνομα tt_11_1
+                  ενώ η εικόνα του στοιχείου θα έχει την ονομασία 11_1-%id%.jpg
+                  και θα βρίσκεται στο φάκελο /img/11_1/
+                )
+  }
+]
+
+
+kallassa.json :
+[
+  {
+    "section" : Μονόλεξη ονομασία section (αγγλικός όρος, μπορεί να χρησιμοποιηθεί και σαν μεταβλητή σε php/js)
+    "label"   : Ονομασία (για το χρήστη)
+    "childs"  :
+          [
+            {
+              "nam" : "id",
+              "lab" : "Κωδικός εγγραφής",
+              "typ" : "auto"
+            },
+            {
+              "nam" : Μονόλεξη ονομασία πεδίου (αγγλικός όρος, μπορεί να χρησιμοποιηθεί και σαν μεταβλητή σε php/js)
+              "lab" : Ονομασία Πεδίου (για το χρήστη)
+              "typ" : Τύπος πεδίου (auto|text|textarea|select|integer|float)
+              "atr" : Ιδιότητες πεδίου (append-key|strict|required)
+              "len" : Μήκος πεδίου κατά το rendering στη φόρμα (συνήθως σε 12/ατα - αλλά υπάρχουν και επεκτάσεις πχ το 15 δηλώνει πλάτος 1/5)
+              "opt" : [   (για την περίπτωση select control)
+                        {
+                          "id"  : value επιλογής
+                          "tag" : label επιλογής
+                        }
+                      ]
+            }
+          ]
+  }
+]
+
+
+
+demo accounts
+---
+user                 pass       role
+--------------------|----------|----
+gx23100@gmail.com    1234       (9)
+thalmel21@gmail.com  1!2!12!!   (5)
+admin@kallassa.dev   1234!@!@   (7)