डेटा एक्सेस पैटर्न चुनना

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

---

पैटर्न तुलना

| Criteria | डायरेक्ट हैंडलर | भण्डार | सेवा परत | CQRS | |---|----------------------|-----------|------| | जटिलता | ⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | | टेस्टैबिलिटी | ❌ कठिन | ✅ अच्छा | ✅ बढ़िया | ✅ बढ़िया | | लचीलापन | ❌ कम | ✅ मध्यम | ✅ उच्च | ✅ बहुत ऊँचा | | XOOPS 2.5.x | ✅ मूलनिवासी | ✅ कार्य | ✅ कार्य | ⚠️ जटिल | | XOOPS 4.0 | ⚠️ पदावनत | ✅ अनुशंसित | ✅ अनुशंसित | ✅ पैमाने के लिए | | टीम का आकार | 1 देव | 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));
    }
}

इसे तब चुनें जब:

• आप यूनिट परीक्षण लिखना चाहते हैं
• आप बाद में डेटा स्रोत बदल सकते हैं (डीबी → 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}");
    }
}

इसे तब चुनें जब:

• संचालन कई डेटा स्रोतों तक फैला हुआ है
• व्यावसायिक नियम जटिल हैं
• आपको लेनदेन प्रबंधन की आवश्यकता है
• ऐप के कई हिस्से एक ही काम करते हैं

अपग्रेड पथ: एक मजबूत आर्किटेक्चर के लिए रिपोजिटरी के साथ संयोजन करें।

---

⚠️ CQRS (कमांड क्वेरी जिम्मेदारी पृथक्करण)

इसके लिए सर्वोत्तम: पढ़ने/लिखने की विषमता के साथ उच्च-स्तरीय मॉड्यूल

// 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 या अधिक)
• आपको पढ़ने बनाम लिखने के लिए अलग-अलग स्केलिंग की आवश्यकता है
• जटिल रिपोर्टिंग/विश्लेषणात्मक आवश्यकताएँ
• इवेंट सोर्सिंग से आपके डोमेन को फायदा होगा

चेतावनी: 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: हैंडलर को रिपॉजिटरी में लपेटें (2-4 घंटे)

1. अपनी डेटा एक्सेस आवश्यकताओं के लिए एक इंटरफ़ेस बनाएं
2. मौजूदा हैंडलर का उपयोग करके इसे कार्यान्वित करें
3. सीधे xoops_getModuleHandler() पर कॉल करने के बजाय रिपॉजिटरी को इंजेक्ट करें

चरण 2: आवश्यकता पड़ने पर सेवा परत जोड़ें (1-2 दिन)

1. जब व्यावसायिक तर्क नियंत्रकों में प्रकट होता है, तो उसे किसी सेवा में निकालें
2. सेवा रिपॉजिटरी का उपयोग करती है, सीधे हैंडलर का नहीं
3. नियंत्रक पतले हो जाते हैं (मार्ग → सेवा → प्रतिक्रिया)

चरण 3: केवल CQRS पर विचार करें यदि (दुर्लभ)

1. आप प्रतिदिन लाखों बार पढ़ते हैं
2. पढ़ने और लिखने के मॉडल काफी भिन्न हैं
3. आपको ऑडिट ट्रेल्स के लिए इवेंट सोर्सिंग की आवश्यकता है
4. आपके पास CQRS के साथ अनुभवी टीम है

---

त्वरित संदर्भ कार्ड| प्रश्न | उत्तर |

|---|--------| | “मुझे बस डेटा सहेजने/लोड करने की आवश्यकता है” | डायरेक्ट हैंडलर | | “मैं परीक्षण लिखना चाहता हूँ” | रिपोजिटरी पैटर्न | | “मेरे पास जटिल व्यावसायिक नियम हैं” | सेवा परत | | “मुझे रीडिंग को अलग से स्केल करने की आवश्यकता है” | CQRS | | “मैं XOOPS 4.0” की तैयारी कर रहा हूं रिपॉजिटरी + सर्विस लेयर |

---

संबंधित दस्तावेज़ीकरण

• रिपॉजिटरी पैटर्न गाइड
• सर्विस लेयर पैटर्न गाइड
• CQRS पैटर्न गाइड (उन्नत)
• हाइब्रिड मोड अनुबंध

---

#पैटर्न #डेटा-एक्सेस #निर्णय-वृक्ष #सर्वोत्तम अभ्यास #xoops