# Πακέτα, επίπεδα, εγγραφές

*Κατασκευή μετα-μοντέλου · ενότητα 2 από 6 · ~15 λεπτά*

## Τι θα μάθετε

Πώς οργανώνεται και γράφεται πραγματικά το περιεχόμενο ενός μοντέλου: η ιεραρχία πακέτο → επίπεδο → εγγραφή, η ονοματοδοσία που κουβαλά νόημα, και τι κάνει καλή μια εγγραφή.

## Η ιεραρχία

- Ένα **πακέτο** είναι μία σημασιολογική ευθύνη: "γιατί υπάρχει το προϊόν", "σχεδίαση συστήματος", "ποιότητα και κίνδυνος". Τα πακέτα είναι διατεταγμένα: πρώτα τα θεμέλια, ώστε μια ενιαία διαδοχική ανάγνωση να συναντά τους ορισμούς πριν από τη χρήση τους.
- Ένα **επίπεδο** είναι ένα ερώτημα μέσα σε ένα πακέτο: "ποιοι είναι οι ενδιαφερόμενοι;", "ποια είναι τα API;". Ο κατάλογος ενός επιπέδου φέρει ένα `README.md` που δηλώνει τα ερωτήματα στα οποία απαντά το επίπεδο: αυτό το README *είναι* η δήλωση νοήματος του επιπέδου.
- Μια **εγγραφή** είναι μία ανεξάρτητα δρομολογήσιμη δήλωση: μία απαίτηση, μία απόφαση, ένα συμβόλαιο API, ένας κίνδυνος. Μία εγγραφή, ένα αρχείο.

Το ναυαρχιδικό μετα-μοντέλο τομέα, το AISMM, καθορίζει δεκατρία πακέτα για τον τομέα "προϊόν λογισμικού" (από b0 πυρήνας προϊόντος ως b12 οικονομικά) με περίπου 90 επίπεδα. Ο τομέας σας θα έχει τα δικά του πακέτα· ο μηχανισμός είναι πανομοιότυπος.

## Ονόματα που διαβάζουν οι μηχανές

Οι εγγραφές ακολουθούν μια σύμβαση ονοματοδοσίας που κουβαλά την ταξινόμηση μέσα στο ίδιο το όνομα αρχείου:

```text
{record_kind}-{YYMMDDNNNNN}-{memo}.md
   req-26071800001-minor-parental-consent.md
   decision-26061500001-concept-decisions.md
   i18n-26060300001-languages-roster.md
```

Το πρόθεμα είναι το είδος της εγγραφής (απαίτηση, απόφαση, api, κίνδυνος...), τα ψηφία είναι ένα ταξινομήσιμο αναγνωριστικό βασισμένο σε ημερομηνία, και το σημείωμα είναι για ανθρώπους. Επειδή το είδος βρίσκεται στο όνομα, ένας μόνο δηλωμένος κανόνας στο manifest ταξινομεί χιλιάδες αρχεία (επόμενη ενότητα). Δύο λεπτομέρειες κερδισμένες με κόπο: τα προθέματα μπορούν να περιέχουν ψηφία (`i18n`), και το αναγνωριστικό δεν αλλάζει ποτέ μετά τη γέννησή του, ακόμη κι αν αλλάξουν το σημείωμα ή το περιεχόμενο: η σταθερότητα της αναφοράς υπερέχει της κομψότητας.

## Τι υπάρχει μέσα σε μια εγγραφή

Μια εγγραφή έχει δύο μέρη: ένα μηχανικό μπλοκ και ένα ανθρώπινο σώμα. Το μηχανικό μπλοκ (front matter) φέρει ταυτότητα (αναγνωριστικό εγγράφου, επίπεδο, προϊόν), ταξινόμηση (`kind_class`: αυτό είναι *κανονιστικό* για το προϊόν, *περιγραφικό* γι' αυτό, ή *προβολή* κάποιου άλλου;) και, κρίσιμα, **παραγωγή**: αν ένας πράκτορας παρήγαγε αυτή την εγγραφή από πηγές, το μπλοκ λέει από ποιες, από ποιον, πώς μετασχηματίστηκε, και αν την έχει επικυρώσει ιδιοκτήτης. Το σώμα είναι συνηθισμένη, καλογραμμένη πρόζα και δομημένα δεδομένα: το πρότυπο δεν έχει άποψη για το ύφος γραφής σας, μόνο για την ιχνηλασιμότητά σας.

Η τριάδα `kind_class` + `derivation` + `validation_status` είναι αυτό που επιτρέπει σε μεικτές ομάδες ανθρώπων και πρακτόρων να εμπιστεύονται ένα μοντέλο: μπορείτε πάντα να ξεχωρίσετε μια κανονιστική δήλωση επικυρωμένη από τον ιδιοκτήτη από την ανεπικύρωτη περίληψη μιας σελίδας wiki που έφτιαξε ένας πράκτορας.

## Τι κάνει καλή μια εγγραφή

- **Ένα θέμα.** Αν δεν μπορείτε να της δώσετε τίτλο χωρίς "και", χωρίστε την.
- **Δρομολογήσιμη.** Όποιος αναλάβει το "τακτοποίησε το req-26071800001" δεν χρειάζεται τίποτε άλλο για να βρει τη δουλειά του.
- **Αναφερόμενη, όχι επαναλαμβανόμενη.** Οι εγγραφές παραπέμπουν στον κανόνα, στα τεκμήρια του `raw/` και η μία στην άλλη· το ίδιο γεγονός διατυπωμένο δύο φορές θα καταλήξει αληθές μία φορά.
- **Έντιμη ως προς την κατάσταση.** Προσχέδιο, ανεπικύρωτο, αντικατεστημένο: οι καταστάσεις είναι μεταδεδομένα, όχι μυστικά.

## Βασικά σημεία

- Πακέτο = ευθύνη, επίπεδο = ερώτημα, εγγραφή = μία δρομολογήσιμη δήλωση.
- Το όνομα αρχείου φέρει το είδος· το front matter φέρει ταυτότητα, ταξινόμηση και παραγωγή.
- Η ιχνηλασιμότητα (ποιος το παρήγαγε από τι, ποιος το επικύρωσε) είναι αυτό που κάνει αξιοποιήσιμο το περιεχόμενο που γράφουν πράκτορες.

## Πηγαίνετε βαθύτερα

- [Πυρήνας αρχιτεκτονικής MMAS](/spec/#02-architecture/MMAS-Core.md) · [Συμβάσεις ονοματοδοσίας](/spec/#02-architecture/Naming-Conventions.md)
- [Δημιουργία νέου μετα-μοντέλου](/spec/#07-guides/Create-a-New-Meta-Model.md)
- AISMM, το ναυαρχιδικό μετα-μοντέλο τομέα: [github.com/orkestron-ai/software-meta-model](https://github.com/orkestron-ai/software-meta-model)

Επόμενο: [Η διαδρομή χωρίς απώλειες](03-walk.md)