> Η μετάφραση παρέχεται για διευκόλυνση. Κανονιστικό είναι το αγγλικό πρωτότυπο. # Συμβάσεις ονοματοδοσίας **Προδιαγραφή του Μετα-Σύμπαντος** **Αναγνωριστικό εγγράφου:** MU-V2-ARCH-003 **Τίτλος:** Πρότυπο αρχιτεκτονικής μετα-μοντέλων - συμβάσεις ονοματοδοσίας **Κατηγορία εγγράφου:** κανονιστικό **Έκδοση:** 2.0 (προσχέδιο) **Κατάσταση:** προσχέδιο εργασίας **Κανονιστικές αναφορές:** Σύνταγμα του Μετα-Σύμπαντος (MUC), MMAS-Core **Πληροφοριακές αναφορές:** Versioning, Πρωτόκολλο Ομοσπονδίας του Μετα-Σύμπαντος (MUFP) **Πνευματικά δικαιώματα:** © Orkestron.AI **Άδεια:** Apache-2.0 --- # 1. Σκοπός Το έγγραφο αυτό ορίζει τους κανόνες ονοματοδοσίας που ισχύουν σε όλο το οικοσύστημα του Μετα-Σύμπαντος. Η συνεπής ονοματοδοσία βελτιώνει την ανευρεσιμότητα, τη σημασιολογική διαλειτουργικότητα, την ομοσπονδία, την αυτοματοποίηση και τη μακροπρόθεσμη συντηρησιμότητα. --- # 2. Πεδίο εφαρμογής Οι κανόνες αυτοί ισχύουν για: - τα πρότυπα του Μετα-Σύμπαντος· - τα μετα-μοντέλα· - τις δέσμες (bundles)· - τα στρώματα· - τα αντικείμενα· - τις ιδιότητες· - τις σχέσεις· - τα γεγονότα· - τα συμβόλαια· - τα προφίλ προβολής· - τους χώρους ονομάτων. Οι υλοποιήσεις ΜΠΟΡΕΙ να ορίζουν πρόσθετες τοπικές συμβάσεις, εφόσον αυτές παραμένουν συμβατές με την παρούσα προδιαγραφή. --- # 3. Αρχές ονοματοδοσίας Τα ονόματα ΟΦΕΙΛΟΥΝ να είναι: - μονοσήμαντα· - σταθερά· - αναγνώσιμα από ανθρώπους· - αναγνώσιμα από μηχανές· - ανεξάρτητα από την τεχνολογία· - σημασιολογικά ουσιώδη. Τα ονόματα ΟΦΕΙΛΟΥΝ να περιγράφουν έννοιες και όχι λεπτομέρειες υλοποίησης. --- # 4. Κανονική γλώσσα Τα αγγλικά ΟΦΕΙΛΟΥΝ να είναι η κανονική γλώσσα για όλα τα κανονιστικά ονόματα. Τοπικοποιημένες ετικέτες ΜΠΟΡΕΙ να παρέχονται ως μεταδεδομένα. Τα κανονικά αναγνωριστικά ΟΦΕΙΛΟΥΝ να παραμένουν ανεξάρτητα από τη γλώσσα. --- # 5. Αναγνωριστικό έναντι εμφανιζόμενου ονόματος Κάθε σημαντικό τεχνούργημα ΠΡΕΠΕΙ να διακρίνει ανάμεσα σε: - Αναγνωριστικό (σταθερό) - Εμφανιζόμενο όνομα (φιλικό στον άνθρωπο) Παράδειγμα: Αναγνωριστικό: employee.performance-review Εμφανιζόμενο όνομα: Employee Performance Review Τα εμφανιζόμενα ονόματα ΜΠΟΡΕΙ να αλλάζουν. Τα αναγνωριστικά ΠΡΕΠΕΙ να παραμένουν σταθερά. --- # 6. Κανονικό σημασιολογικό όνομα (CSN) Η διάκριση ανάμεσα σε αναγνωριστικό και εμφανιζόμενο όνομα γενικεύεται, για κάθε δημόσια έννοια, σε ένα **κανονικό σημασιολογικό όνομα (Canonical Semantic Name, CSN)**. Κάθε δημόσια έννοια ΟΦΕΙΛΕΙ να έχει και τα δύο: - ένα **ανθρώπινο / εμφανιζόμενο όνομα** - τοπικοποιημένο, φιλικό στον άνθρωπο και ελεύθερο να αλλάζει (για παράδειγμα "Salary Agreement")· - ένα αμετάβλητο **κανονικό σημασιολογικό όνομα (CSN)** - ένα σταθερό, ανεξάρτητο από την τεχνολογία αναγνωριστικό νοήματος (για παράδειγμα `employee.compensation.salaryAgreement`). Παράδειγμα: ```text Display Name : Salary Agreement CSN : employee.compensation.salaryAgreement ``` Το CSN είναι ανάλογο ενός πλήρως προσδιορισμένου ονόματος κλάσης ή ενός URI του RDF, αλλά είναι σκόπιμα **ανεξάρτητο από την τεχνολογία**: δεν δεσμεύεται σε καμία γλώσσα προγραμματισμού, σειριοποίηση ή μεταφορά. Εκφράζει τη θέση μιας έννοιας μέσα στη σημασιολογική της ιεραρχία και τίποτε άλλο. Κανόνες: - Κάθε δημόσια έννοια ΟΦΕΙΛΕΙ να έχει ακριβώς ένα CSN. - Ένα CSN ΟΦΕΙΛΕΙ να είναι αμετάβλητο μόλις δημοσιευθεί· η μετονομασία μιας έννοιας ΟΦΕΙΛΕΙ να αντιμετωπίζεται ως σημασιολογική αλλαγή κατά το [Versioning](Versioning.md) και ΟΦΕΙΛΕΙ να παράγει νέο CSN, ποτέ σιωπηλή επανεγγραφή του υπάρχοντος. - Όλες οι **αλληλεπιδράσεις ομοσπονδίας ΟΦΕΙΛΟΥΝ να ανταλλάσσουν CSN**. Το Πρωτόκολλο Ομοσπονδίας του Μετα-Σύμπαντος (MUFP) μεταδίδει CSN· ΔΕΝ ΠΡΕΠΕΙ να στηρίζεται σε εμφανιζόμενα ονόματα για την ταυτότητα. - Οι διεπαφές χρήστη ΠΡΕΠΕΙ να παρουσιάζουν το τοπικοποιημένο εμφανιζόμενο όνομα, επιλύοντάς το στο υποκείμενο CSN. - Τα εμφανιζόμενα ονόματα ΜΠΟΡΕΙ να διαφέρουν ανά γλώσσα, συμφραζόμενα και παρουσίαση· το CSN ΟΦΕΙΛΕΙ να παραμένει το ίδιο. Για να αποφεύγονται συγκρούσεις ονομάτων μέσα σε μια ομοσπονδία, ένα CSN ΠΡΕΠΕΙ να συνοδεύεται από το [σημασιολογικό αποτύπωμα](Versioning.md) της έκδοσης που ορίζει την έννοια. Μαζί, το CSN προσδιορίζει *ποια έννοια* και το αποτύπωμα *ποιο νόημα*, ώστε δύο σύμπαντα που χρησιμοποιούν το ίδιο CSN να μπορούν να διαπιστώσουν αν όντως συμφωνούν στη σημασιολογία του πριν βασιστούν σε αυτήν. --- # 6a. Γραμματική του CSN και σχήμα αναγνωριστικών Για να είναι τα CSN και τα αναγνωριστικά ελέγξιμα από μηχανή, η ενότητα αυτή δίνει την τυπική τους γραμματική. Ένα **κανονικό σημασιολογικό όνομα** ΟΦΕΙΛΕΙ να συμμορφώνεται με την ακόλουθη ABNF (RFC 5234): ```abnf CSN = segment *("." segment) segment = lower *(ALPHA / DIGIT) lower = %x61-7A ; a-z (a segment SHALL start lowercase) ALPHA = %x41-5A / %x61-7A DIGIT = %x30-39 ``` Το πρώτο `segment` είναι ο **χώρος ονομάτων**· τα υπόλοιπα τμήματα ονοματίζουν την έννοια μέσα σε αυτόν (για παράδειγμα `employee.compensation.salaryAgreement` - χώρος ονομάτων `employee`). Η γραμματική αυτή είναι η κανονιστική πηγή για το μοτίβο `csn` στο [`schemas/common.schema.json`](../schemas/common.schema.json) και επιβάλλεται από τον έλεγχο `V2-03` του [Validation](Validation.md). Ένα **αναγνωριστικό** (το `id` ενός αντικειμένου, σχέσης, γεγονότος, συμβολαίου ή προβολής, καθώς και η τιμή μιας τοπικής ταυτότητας) είναι αδιαφανές και ΟΦΕΙΛΕΙ να είναι σταθερό για όσο ζει αυτό που ονοματίζει. Μια υλοποίηση ΟΦΕΙΛΕΙ να υιοθετήσει ένα από τα ακόλουθα σχήματα αναγνωριστικών και να το δηλώσει, ώστε οι καταναλωτές να μπορούν να το επιλύσουν: | Σχήμα | Μορφή | Παράδειγμα | |--------|------|---------| | `uuid` | ένα UUID | `9d3f2c1a-...` | | `uri` | ένα απόλυτο URI | `https://acme.example/person/12345` | | `urn` | ένα URN | `urn:mu:person:9d3f2c1a` | | `qname` | `scheme:value` εντός ενός Σύμπαντος | `employee:12345` | Τα αναγνωριστικά ΟΦΕΙΛΟΥΝ να συγκρίνονται ως ακριβείς ακολουθίες byte· ΔΕΝ ΠΡΕΠΕΙ να ισοπεδώνονται ως προς τα κεφαλαία ούτε να κανονικοποιούνται. Μια [κανονική ταυτότητα](../04-core-concepts/Identity.md) ζευγαρώνει ένα σχήμα με μια τιμή (`{ "scheme": "urn", "value": "urn:mu:person:9d3f2c1a" }`). Νέα σχήματα ΜΠΟΡΕΙ να καταχωρίζονται χωρίς να σπάνε τα υπάρχοντα αναγνωριστικά. --- # 7. Σύμβαση χώρων ονομάτων Κάθε δημόσια έννοια ΟΦΕΙΛΕΙ να ανήκει σε έναν χώρο ονομάτων. Συνιστώμενη μορφή: namespace:Concept Παραδείγματα: employee:Skill organization:Department product:Capability schema:Person fhir:Patient Οι χώροι ονομάτων ΟΦΕΙΛΟΥΝ να είναι καθολικά μοναδικοί εντός του σημασιολογικού τους πεδίου. --- # 8. Ονοματοδοσία μετα-μοντέλων Τα μετα-μοντέλα ΠΡΕΠΕΙ να χρησιμοποιούν περιγραφικά ονόματα. Συνιστώμενα παραδείγματα: Employee Meta-Model Product Landscape Meta-Model Enterprise Landscape Meta-Model Αποφύγετε ονόματα δεμένα με συγκεκριμένη υλοποίηση. --- # 9. Ονοματοδοσία δεσμών Τα ονόματα δεσμών ΠΡΕΠΕΙ να είναι ουσιαστικά που παριστούν σημασιολογικά πεδία. Παραδείγματα: Identity Knowledge Governance Runtime History Security --- # 10. Ονοματοδοσία στρωμάτων Ένα στρώμα ΟΦΕΙΛΕΙ να παριστά ένα ενιαίο, συνεκτικό σημασιολογικό ζήτημα. Τα ονόματα στρωμάτων ΠΡΕΠΕΙ: - να χρησιμοποιούν ουσιαστικά στον ενικό· - να αποφεύγουν συντομογραφίες· - να αποφεύγουν ονόματα τεχνολογιών. Παραδείγματα: Employment History Projects Compensation Competencies --- # 11. Ονοματοδοσία αντικειμένων Τα ονόματα αντικειμένων ΠΡΕΠΕΙ: - να χρησιμοποιούν ουσιαστικά στον ενικό· - να παριστούν πραγματικές ή εννοιολογικές οντότητες· - να αποφεύγουν ορολογία υλοποίησης. Προτιμότερα: Employee Project Skill Προς αποφυγή: EmployeeTable ProjectDTO SkillRecord --- # 12. Ονοματοδοσία ιδιοτήτων Τα ονόματα ιδιοτήτων ΠΡΕΠΕΙ: - να περιγράφουν γεγονότα· - να χρησιμοποιούν lowerCamelCase· - να αποφεύγουν προθέματα· - να αποφεύγουν καταλήξεις υλοποίησης. Προτιμότερα: firstName createdAt currentPosition Προς αποφυγή: emp_name fld1 col_employee --- # 13. Ονοματοδοσία σχέσεων Τα ονόματα σχέσεων ΠΡΕΠΕΙ να περιγράφουν το σημασιολογικό νόημα. Παραδείγματα: worksFor reportsTo owns dependsOn assignedTo Γενικόλογα ονόματα όπως "link" ή "relation" ΠΡΕΠΕΙ να αποφεύγονται. --- # 14. Ονοματοδοσία γεγονότων Τα γεγονότα ΠΡΕΠΕΙ να περιγράφουν τετελεσμένα γεγονότα. Συνιστώμενο μοτίβο: Παραδείγματα: EmployeeCreated ContractSigned ProjectArchived Αποφύγετε ονόματα σε προστακτική. --- # 15. Ονοματοδοσία συμβολαίων Τα συμβόλαια ΠΡΕΠΕΙ να περιγράφουν τον επιχειρησιακό ή σημασιολογικό σκοπό. Παραδείγματα: Employment Contract Knowledge Disclosure Contract Federation Agreement Αποφύγετε ονόματα προσανατολισμένα στην υλοποίηση. --- # 16. Ονοματοδοσία αρχείων Τα έγγραφα προδιαγραφών ΠΡΕΠΕΙ να χρησιμοποιούν: Title-Case-With-Hyphens.md Παραδείγματα: Meta-Universe-Constitution.md Federation-Contracts.md Identity-Binding.md Τα αρχεία παραδειγμάτων ΠΡΕΠΕΙ να φέρουν την κατάληξη: .example.yaml --- # 17. Δεσμευμένοι όροι Οι ακόλουθοι όροι είναι δεσμευμένοι από την οικογένεια προτύπων του Μετα-Σύμπαντος: Universe Dimension Namespace Meta-Model Bundle Layer Object Projection Relationship Event Contract Context Identity Οι όροι αυτοί ΔΕΝ ΠΡΕΠΕΙ να επαναπροσδιορίζονται με ασύμβατα νοήματα. --- # 18. Εισαγόμενα πρότυπα Οι εισαγόμενες έννοιες ΟΦΕΙΛΟΥΝ να διατηρούν τα αρχικά τους ονόματα όποτε αυτό είναι πρακτικό. Οι τοπικές επεκτάσεις ΠΡΕΠΕΙ να επεκτείνουν τις εισαγόμενες έννοιες αντί να τις μετονομάζουν. Παράδειγμα: schema:Person ↓ employee:Employee --- # 19. Σταθερότητα ονοματοδοσίας Τα αναγνωριστικά ΟΦΕΙΛΟΥΝ να παραμένουν σταθερά σε όλες τις συμβατές εκδόσεις. Η μετονομασία ΠΡΕΠΕΙ να αντιμετωπίζεται ως σημασιολογική αλλαγή. Οδηγίες μετάβασης ΟΦΕΙΛΟΥΝ να παρέχονται κάθε φορά που αλλάζουν αναγνωριστικά. --- # 20. Μελλοντικές κατευθύνσεις Το κανονικό σημασιολογικό όνομα θεμελιώνει ένα σταθερό, ανεξάρτητο από την τεχνολογία στρώμα ταυτότητας, το οποίο μελλοντική εργασία μπορεί να αναπτύξει σε έναν **σημασιολογικό οδηγό ύφους**: ένα συνοδευτικό πρότυπο που θα ορίζει τη γραμματική των τμημάτων του CSN, τους κανόνες κεφαλαιοποίησης και πληθυντικού, το συνιστώμενο βάθος ιεραρχίας και τον αλγόριθμο επίλυσης με τον οποίο ένα τοπικοποιημένο εμφανιζόμενο όνομα αντιστοιχίζεται σε CSN ανά γλώσσα. Ένας τέτοιος οδηγός θα προδιέγραφε επίσης μια υπηρεσία επίλυσης CSN για ολόκληρη την ομοσπονδία, ώστε κάθε σύμπαν να μπορεί να αποαναφέρει ένα CSN στην έκδοση που το ορίζει και στο [σημασιολογικό αποτύπωμά](Versioning.md) της, κλείνοντας τον κύκλο ανάμεσα στην ονοματοδοσία και το νόημα. --- # Τελική δήλωση Η συνεπής ονοματοδοσία είναι προϋπόθεση της σημασιολογικής διαλειτουργικότητας. Σκοπός αυτών των συμβάσεων δεν είναι μόνο η υφολογική συνέπεια, αλλά η δημιουργία σταθερών, παγκοσμίως κατανοητών σημασιολογικών μοντέλων που μπορούν να εξελίσσονται, να ομοσπονδοποιούνται και να ερμηνεύονται αξιόπιστα τόσο από ανθρώπους όσο και από συστήματα τεχνητής νοημοσύνης.