Επιλογή Μοτίβου Πρόσβασης Δεδομένων

2.5.x ✅ 4.0.x ✅

Ποιο μοτίβο να χρησιμοποιήσω; Αυτό το δέντρο αποφάσεων σάς βοηθά να επιλέξετε ανάμεσα σε άμεσους χειριστές, Μοτίβο αποθετηρίου, Επίπεδο υπηρεσίας και CQRS.

---

Δέντρο γρήγορης απόφασης

flowchart TD
    START([Start Here]) --> Q1{How complex is<br/>your module?}

    Q1 -->|Simple CRUD<br/>1-3 entities| Q2{Need testing<br/>or mocking?}
    Q1 -->|Moderate<br/>4-10 entities| Q3{Multiple data<br/>sources?}
    Q1 -->|Complex<br/>10+ entities| Q4{High traffic or<br/>read/write asymmetry?}

    Q2 -->|No| HANDLER[✅ Direct Handler]
    Q2 -->|Yes| REPO[✅ Repository Pattern]

    Q3 -->|No, just DB| REPO
    Q3 -->|Yes, APIs/cache| SERVICE[✅ Service Layer]

    Q4 -->|No| SERVICE
    Q4 -->|Yes, need<br/>separate scaling| CQRS[✅ CQRS Pattern]

    HANDLER --> DONE([Choose Pattern])
    REPO --> DONE
    SERVICE --> DONE
    CQRS --> DONE

    style HANDLER fill:#c8e6c9,stroke:#2e7d32
    style REPO fill:#bbdefb,stroke:#1565c0
    style SERVICE fill:#fff9c4,stroke:#f9a825
    style CQRS fill:#ffcdd2,stroke:#c62828

---

Σύγκριση προτύπων

Κριτήρια	Άμεσος χειριστής	Αποθετήριο	Επίπεδο υπηρεσίας	CQRS
Πολυπλοκότητα	⭐	⭐⭐	⭐⭐⭐	⭐⭐⭐⭐⭐
Δοκιμαστικότητα	❌ Σκληρό	✅ Καλό	✅ Εξαιρετικό	✅ Εξαιρετικό
Ευελιξία	❌ Χαμηλό	✅ Μεσαία	✅ Υψηλό	✅ Πολύ ψηλά
XOOPS 2.5.x	✅ Εγγενής	✅ Έργα	✅ Έργα	⚠️ Συγκρότημα
XOOPS 4,0	⚠️ Καταργήθηκε	✅ Προτείνεται	✅ Προτείνεται	✅ Για ζυγαριά
Μέγεθος ομάδας	1 dev	1-3 προγραμματιστές	2-5 προγραμματιστές	5+ προγραμματιστές
Συντήρηση	❌ Ανώτερο	✅ Μέτρια	✅ Κάτω	⚠️ Απαιτεί τεχνογνωσία

---

Πότε να χρησιμοποιήσετε κάθε μοτίβο

# ✅ Άμεσος χειριστής (XoopsPersistableObjectHandler)

Το καλύτερο για: Απλές ενότητες, γρήγορα πρωτότυπα, εκμάθηση XOOPS

// Simple and direct - good for small modules
$handler = xoops_getModuleHandler('article', 'news');
$articles = $handler->getObjects(new Criteria('status', 1));

Επιλέξτε αυτό όταν:

• Δημιουργία απλής ενότητας με 1-3 πίνακες βάσεων δεδομένων
• Δημιουργία ενός γρήγορου πρωτοτύπου
• Είστε ο μόνος προγραμματιστής και δεν χρειάζεστε δοκιμές
• Η ενότητα δεν θα αναπτυχθεί σημαντικά

Περιορισμοί:

• Δύσκολη μονάδα δοκιμής (παγκόσμια εξάρτηση)
• Σφιχτή σύζευξη στο επίπεδο βάσης δεδομένων XOOPS
• Η επιχειρηματική λογική τείνει να διαρρέει στους ελεγκτές

---

# ✅ Μοτίβο αποθετηρίου

Το καλύτερο για: τις περισσότερες ενότητες, ομάδες που θέλουν δυνατότητα δοκιμής

// Abstraction allows mocking for tests
interface ArticleRepositoryInterface {
    public function findPublished(): array;
    public function save(Article $article): void;
}

class XoopsArticleRepository implements ArticleRepositoryInterface {
    private $handler;

    public function __construct() {
        $this->handler = xoops_getModuleHandler('article', 'news');
    }

    public function findPublished(): array {
        return $this->handler->getObjects(new Criteria('status', 1));
    }
}

Επιλέξτε αυτό όταν:

• Θέλετε να γράψετε δοκιμές μονάδας
• Μπορείτε να αλλάξετε τις πηγές δεδομένων αργότερα (DB → API)
• Συνεργασία με 2+ προγραμματιστές
• Κατασκευή ενοτήτων για διανομή

Διαδρομή αναβάθμισης: Αυτό είναι το προτεινόμενο μοτίβο για την προετοιμασία XOOPS 4.0.

---

# ✅ Επίπεδο υπηρεσιών

Το καλύτερο για: Ενότητες με πολύπλοκη επιχειρηματική λογική

// Service coordinates multiple repositories and contains business rules
class ArticlePublicationService {
    public function __construct(
        private ArticleRepositoryInterface $articles,
        private NotificationServiceInterface $notifications,
        private CacheInterface $cache
    ) {}

    public function publish(int $articleId): void {
        $article = $this->articles->find($articleId);
        $article->setStatus('published');
        $article->setPublishedAt(new DateTime());

        $this->articles->save($article);
        $this->notifications->notifySubscribers($article);
        $this->cache->invalidate("article:{$articleId}");
    }
}

Επιλέξτε αυτό όταν:

• Οι λειτουργίες καλύπτουν πολλαπλές πηγές δεδομένων
• Οι επιχειρηματικοί κανόνες είναι περίπλοκοι
• Χρειάζεστε διαχείριση συναλλαγών
• Πολλά μέρη της εφαρμογής κάνουν το ίδιο πράγμα

Διαδρομή αναβάθμισης: Συνδυάστε με το Repository για μια στιβαρή αρχιτεκτονική.

---

# ⚠️ CQRS (Διαχωρισμός ευθύνης ερωτήματος εντολών)

Το καλύτερο για: Ενότητες υψηλής κλίμακας με ασυμμετρία read/write

// Commands modify state
class PublishArticleCommand {
    public function __construct(
        public readonly int $articleId,
        public readonly int $publisherId
    ) {}
}

// Queries read state (can use denormalized read models)
class GetPublishedArticlesQuery {
    public function __construct(
        public readonly int $limit = 10
    ) {}
}

Επιλέξτε αυτό όταν:

• Οι αναγνώσεις είναι πολύ περισσότερες από τις γραπτές (100:1 ή περισσότερες)
• Χρειάζεστε διαφορετική κλίμακα για ανάγνωση και εγγραφή
• Σύνθετες απαιτήσεις reporting/analytics
• Η προμήθεια εκδηλώσεων θα ωφελούσε τον τομέα σας

Προειδοποίηση: CQRS προσθέτει σημαντική πολυπλοκότητα. Οι περισσότερες μονάδες XOOPS δεν το χρειάζονται.

---

Συνιστώμενη διαδρομή αναβάθμισης

flowchart LR
    H0["Direct Handler<br/>(XOOPS 2.5.x today)"]
    R["Repository Pattern<br/>(Recommended next step)"]
    S["+ Service Layer<br/>(When complexity grows)"]
    C["+ CQRS<br/>(Only if scaling requires)"]

    H0 -->|"Step 1"| R
    R -->|"Step 2"| S
    S -->|"Step 3<br/>(rare)"| C

    style H0 fill:#ffcdd2
    style R fill:#c8e6c9
    style S fill:#bbdefb
    style C fill:#fff9c4

# Βήμα 1: Αναδίπλωση Handlers σε αποθετήρια (2-4 ώρες)

1. Δημιουργήστε μια διεπαφή για τις ανάγκες πρόσβασης στα δεδομένα σας
2. Εφαρμόστε το χρησιμοποιώντας τον υπάρχοντα χειριστή
3. Εισαγάγετε το αποθετήριο αντί να καλέσετε απευθείας το xoops_getModuleHandler()

# Βήμα 2: Προσθήκη επιπέδου υπηρεσίας όταν χρειάζεται (1-2 ημέρες)

1. Όταν εμφανίζεται η επιχειρηματική λογική στους ελεγκτές, κάντε εξαγωγή σε μια Υπηρεσία
2. Η υπηρεσία χρησιμοποιεί αποθετήρια, όχι απευθείας χειριστές
3. Τα χειριστήρια γίνονται λεπτά (διαδρομή → σέρβις → απόκριση)

# Βήμα 3: Σκεφτείτε το CQRS Μόνο εάν (σπάνιο)

1. Έχετε εκατομμύρια αναγνώσεις την ημέρα
2. Τα μοντέλα ανάγνωσης και εγγραφής διαφέρουν σημαντικά
3. Χρειάζεστε προμήθεια συμβάντων για ίχνη ελέγχου
4. Έχετε μια ομάδα με εμπειρία με CQRS

---

Κάρτα γρήγορης αναφοράς

Ερώτηση	Απάντηση
”Χρειάζομαι απλώς save/load δεδομένα”	Άμεσος χειριστής
”Θέλω να γράψω τεστ”	Μοτίβο αποθετηρίου
”Έχω πολύπλοκους επιχειρηματικούς κανόνες”	Επίπεδο υπηρεσίας
”Πρέπει να κλιμακώσω τις αναγνώσεις ξεχωριστά”	CQRS
”Ετοιμάζομαι για το XOOPS 4.0”	Αποθετήριο + Επίπεδο υπηρεσίας

---

Σχετική τεκμηρίωση

• Οδηγός μοτίβων αποθετηρίου
• Service Layer Pattern Guide
• CQRS Οδηγός μοτίβων (για προχωρημένους)
• Σύμβαση υβριδικής λειτουργίας

---

patterns #data-access #decision-tree #best-practices #XOOPS