Κινητήρας καταλόγου περιεχομένου

Η μηχανή καταλόγου είναι ο πυρήνας των εκθέσεων παιχνιδιών και των συλλογών promo στο μπροστινό μέρος: συλλέγει και ομαλοποιεί μεταδεδομένα από παρόχους (RGS), παρέχει αναζήτηση/φίλτρα/κατάταξη, εφαρμόζει κανόνες προσβασιμότητας ανά δικαιοδοσία και μάρκα, αναμειγνύει εξατομίκευση και τοποθέτηση promo, και στη συνέχεια παρέχει γρήγορες απαντήσεις μέσω APμε προβλέψιμο SLO.

1) Στόχοι και αρχές

Γρήγορη ανάγνωση: p95 ≤ 100-150 ms ανά κατάλογο/αίτημα αναζήτησης.
Αλήθεια και φρεσκάδα: εγγυημένη συνάφεια των βασικών χαρακτηριστικών (διαθεσιμότητα, τζάκποτ, καθεστώς παρόχου).
Ευελιξία: συντακτικές συλλογές και promo slots χωρίς κυκλοφορίες.
Συμμόρφωση: γεωγραφικοί κανόνες/κανόνες ηλικίας/περιεχομένου, άδειες, περιορισμοί για υπεύθυνο παιχνίδι.
Πολυπληθής/περιφέρεια: απομόνωση εμπορικού σήματος και συμμόρφωση με τα δεδομένα.
Παρατηρησιμότητα: Εξερχόμενες μετρήσεις ποιότητας, A/B, μετατροπή παιχνιδιού/στοίχημα.

2) Μοντέλο τομέα (ελάχιστο)

• Το παιχνίδι είναι παιχνίδι/προϊόν του παρόχου.
• Πάροχος - RGS/studio.
• Παραλλαγή - παραλλαγές ενός παιχνιδιού (μεταβλητότητα, γραμμές, όρια, εξυπηρετητής).
• Συλλογή - συντακτική/αυτόματη επιλογή (π.χ. «Νέα αντικείμενα», «Τζάκποτ»).
• Τοποθέτηση - σταθερή θέση/πανό/πλακίδιο στη σελίδα/στην υποδοχή.
• Ικανότητα/Χαρακτηριστικό - Χαρακτηριστικά παιχνιδιού (δωρεάν περιστροφές, λειτουργία αγοράς, τζάκποτ).
• Κανόνας δικαιοδοσίας - κανόνες προσβασιμότητας/περιορισμού.
• Σήματα - σήματα συμπεριφοράς/λειτουργικά σήματα (δημοτικότητα, CTR, έσοδα).
• Περιουσιακό στοιχείο - μέσα (εικονίδια, αφίσες, βίντεο επίδειξης) με επιλογές για συσκευές/πυκνότητες.

Κλειδιά: 'παιχνίδι _ id' (σταθερό εσωτερικό, όχι ίσο με provider_game_id), 'ενοικιαστής _ id', 'περιφέρεια', 'τοπικό'.

3) Κατάποση και ομαλοποίηση

1. Προσαρμογείς πηγής (pullers): ολοκλήρωση με RGS/studios (καταλόγους, χαρακτηριστικά, RTP, ετικέτες).

2. Sanitize & Map - Χάρτης εξωτερικών πεδίων σε ένα μόνο λεξικό (ACL), επικύρωση, και αποπλήρωση.

3. Εμπλουτισμός: εντοπισμός, κατηγορίες, σημασιολογικές ετικέτες, βαθμολογίες ορίου ηλικίας.

4. Μέτρια: σημαίες περιεχομένου (NSFW/θρησκευτικά σύμβολα/ευαίσθητα θέματα) ανά αγορά.

5. Έκδοση: 'GameUpserted/ProviderStatusChanged' events → προβολή καταλόγου.

Ταυτότητα: όλα τα μηνύματα με 'πηγή _ id' + 'έκδοση _ ts'; Η επανάληψη γίνεται χωρίς παρενέργειες.
Σύστημα εξέλιξης: 'schema _ version' σε προσαρμογείς + mapper μεταναστεύσεις.

4) Κανονικοποιημένο σύστημα (απλουστευμένο)

json
{
"game_id": "g_3f92",
"tenant_id": "brand_eu",
"provider": { "id": "pr_evolution", "name": "Evolution" },
"title": { "en": "Lightning Roulette", "de": "Lightning Roulette" },
"capabilities": ["live","roulette","multiplier","bonus"],
"rtp": 97.3,
"volatility": "high",
"limits": { "min": 0.1, "max": 1000.0, "currency": "EUR" },
"jurisdiction": {
"allowed": ["MT","EE","DE"],
"blocked": ["NL","BE"],
"age_rating": 21
},
"assets": {
"tile": { "1x":"...", "2x":"..." },
"poster": { "web":"...", "mobile":"..." }
},
"tags": ["new","jackpot"],
"release_date": "2025-09-12",
"status": "active",
"variants": [{ "id":"v1","server":"eu-central-1","rtp":97.3 }]
}

5) Αναζήτηση, φίλτρα, όψεις

Ευρετήρια: πλήρες κείμενο με όνομα/συνώνυμα, όψεις από «πάροχο», «δυνατότητες», «μεταβλητότητα», «rtp _ κουβά», «ετικέτες».
Φίλτρα: δικαιοδοσία/περιφέρεια/γλώσσα/συσκευή/ηλικία, ενεργό/πιστοποιημένο μόνο.
Συνώνυμα: χάρτης όρων χρήστη («βιβλία», «φρούτα», «μπάλες»).
Τύπος: ανεκτική αναζήτηση (απόσταση επεξεργασίας ≤1 -2) με περιορισμό μήκους.

6) Κατάταξη: σήματα και τύπος

• Φρεσκάδα (χρόνος από την απελευθέρωση).
• Πληθυσμός (έναρξη/ώρα, μοναδικοί παίκτες).
• Ποιότητα (CTR από κατάλογο σε παιχνίδι, κατέχει 1/7 ημέρα).
• Επιχειρήσεις (ενίσχυση μάρκετινγκ, συμφωνίες, διαφημιστικές χρονοθυρίδες).
• Συμμόρφωση (ήπιες υποβαθμίσεις για ευαίσθητο περιεχόμενο, εάν απαιτείται).
• Εφαρμογή αναπαραγωγής (συμβατότητα προφίλ/προτίμησης).

score = w1freshness + w2popularity + w3ctr + w4player_fit + w5boost

Τα βάρη ελέγχονται με διαμόρφωση/πειράματα. όλα τα σήματα ομαλοποιημένα σε [0· 1].

7) Εξατομίκευση

Σύντομη μνήμη: πρόσφατα εγκαίνια και είδη, RYW - ο χρήστης βλέπει αμέσως νέα δράση.
Μεγάλη μνήμη: Ενσωματώσεις προφίλ παιχνιδιού και παικτών (είδη παιχνιδιών/μεταβλητότητα/συνεδρίες).
Ασφάλεια: Η εξατομίκευση ποτέ δεν παραβιάζει τους κανόνες δικαιοδοσίας/ηλικίας.
Οπισθοδρόμηση: εάν υπάρχουν λίγα σήματα - ουδέτερη κατάταξη + συλλογές σύνταξης.

8) Συλλογές και διαφημιστικές τοποθετήσεις

• Αυτόματο: κανόνας/ερώτηση (π.χ. «Οι ικανότητες περιέχουν» τζάκποτ «ΚΑΙ release_date> = NOW () -30d»).
• Άρθρο: χειροκίνητος κατάλογος με σειρά και χρονοδιάγραμμα.
• Τοποθέτηση: σταθερές θέσεις σε σελίδες (ήρωας, γραμμή-1-slot-3), A/B, στοχοθέτηση ανά τομέα/δικαιοδοσία.
• Ημερομηνίες και προτεραιότητες: 'starts _ at/ends _ at', προτεραιότητα σύγκρουσης, προεπισκόπηση πριν από τη δημοσίευση.

9) Πολιτική συμμόρφωσης και προσβασιμότητας

Γεωγραφική περιοχή: λευκοί/μαύροι κατάλογοι χωρών/περιφερειών, επαλήθευση αδειών/πιστοποιητικών.
Διαβάθμιση ηλικίας: ελάχιστη ηλικία, προειδοποιήσεις, απόκρυψη για ασύμβατες αγορές.
Θέμα/συμβολισμός: σημαίες ευαίσθητου περιεχομένου ανά χώρα (θρησκεία, αλκοόλ κ.λπ.).
Υπεύθυνο παιχνίδι: Απόκρυψη/υποβιβασμός για παίκτες ορίου/χρονοδιακόπτη.
Έλεγχος: αμετάβλητο αρχείο μεταβολών στη διαθεσιμότητα με λόγους.

10) Πολυκατοικίες και πολυπεριφέρειες

Όλα τα στοιχεία φέρουν την ένδειξη «ενοικιαστής _ id» και «περιφέρεια».
απομόνωση: απαρτίες/θησαυροφυλάκια ανά περιοχή· διαπεριφερειακές προβλέψεις - μόνο συγκεντρωτικά μεγέθη.
Δίκαιη μεταχείριση: ποσοστώσεις για την κατάποση/δημοσίευση ανά ενοικιαστή, έτσι ώστε η «θορυβώδης» μάρκα να μην καθυστερήσει τα υπόλοιπα.

11) Αρχιτεκτονική περιγραφή

Κατάλογος εγγραφής-πυρήνα (CP): ομαλοποίηση + συναλλαγή outbox events.
Προβολές/Μοντέλα ανάγνωσης (EC): δείκτες αναζήτησης, υλοποιημένες συλλογές, μετρητές δημοτικότητας.

• Ακμή/CDN για ψυχρές σελίδες/εικόνες.
• Κρύπτες μνήμης για θερμά ερωτήματα (κλειδί = φίλτρα + σελίδα + ενοικιαστής + περιοχή).
• Ficheflags: κυλιόμενοι κανόνες κατάταξης/συλλογής χωρίς απελευθέρωση.

12) API (REST/GraphQL, παραδείγματα)

ΑΝΆΠΑΥΣΗ

GET /v1/catalog?tenant=brand_eu&region=EE&locale=ru
&filter=jackpot,true&sort=score_desc&page=1&size=24
→ 200 { items:[...], facets:{...}, as_of:"2025-10-31T12:10:02Z" }

GraphQL (θραύσμα)

graphql query Catalog($tenant:String!,$region:String!,$q:String,$filters:Filters){
catalog(tenant:$tenant, region:$region, q:$q, filters:$filters){
items { gameId title provider { name } score badges assets { tile } }
facets { providers { key,count } capabilities { key,count } }
freshnessMs
}
}

• Πάντα να επιστρέφετε 'ως _ από/φρεσκάδα', τηλεειδοποίηση, όψεις.
• Για εξατομίκευση - δείκτης συνεδρίας (RYW) χωρίς PII.

13) Σήματα και ροή δεδομένων

Δημοτικότητα: αυξήσεις κατά την έναρξη παιχνιδιών → λεπτά κουβάδες → μονάδες στην προβολή.
CTR/μετατροπή: Κλικ/πάγκοι εκτόξευσης για τοποθετήσεις/συλλογές.
Κατάσταση λειτουργίας: πάροχοι υπηρεσιών υγείας (ΣΕΚ), τζάκποτ/όρια (ροή γεγονότων).
Αύξηση της εμπορίας: παράγοντες χρόνου για παιχνίδια/κατηγορίες/προμηθευτές.

14) Παρατηρησιμότητα και SLO

• 'catalog _ p95 _ m ,' catalog _ p99 _ m , 'erry _ rate'.
• 'index _ freshness _ m (καθυστέρηση έργου),' ingest _ lag _ m .
• 'ctr', 'click-to-launch', 'collection _ coverage' (% check out from collections).

• 'lift _ ctr', 'lift _ conversion', 'explore vs exploit' доля.

• % ορθά εφαρμοζόμενοι κανόνες γεωγραφικής ηλικίας, αριθμός τμημάτων ανά ώρα.

Προειδοποιήσεις: ανάπτυξη του 'lag _ ms', πτώση του CTR σε βασικές συλλογές, υποβάθμιση του παρόχου (ετικέτες στο τεύχος).

15) Επιδόσεις και εγκλωβισμός

Στρατηγική: θερμές ερωτήσεις - κρυφή μνήμη για 30-120 δευτερόλεπτα με κλειδί ανά φίλτρο. προσωπικά μπλοκ - κοντό TTL (10-30 s) ή καμία κρύπτη.
Αναπηρία: από τις εκδηλώσεις 'GameUpserted/ Changed/PlaceedUpdated'.
Pagination: σταθεροί δρομείς ώστε να μην «πηδούν» κάρτες κατά την ενημέρωση σημάτων.

16) Συνεργασία με τα μέσα ενημέρωσης

Προφίλ απόδοσης: μεγέθη/πυκνότητες για ιστό/κινητό/τηλεόραση.
Βελτιστοποίηση: WebP/AVIF, τεμπέλικο φορτίο, sprite/άτλαντας για πλακάκια.
Ασφάλεια περιεχομένου: σάρωση, υδατογραφήματα, απαγόρευση inline-PII.

17) Δοκιμές

Δοκιμές συμβάσεων/σχημάτων για προσαρμογείς και API.
Δοκιμές καταλληλότητας: χρυσά σύνολα ερωτημάτων → αναμενόμενα αποτελέσματα/τάξη.
Εξατομίκευση: offline AUC/NDCG + online A/B με μετρήσεις guardrail (χρόνος στο παιχνίδι, καταθέσεις, σήματα RG).
Χάος: υποβάθμιση του παρόχου, ακίδες κατάποσης, καθυστερήσεις τιμαριθμικής αναπροσαρμογής.

18) Playbooks (runbooks)

1. Δείκτης υστέρησης> SLO: διακοπή των δευτερογενών συλλογών, αύξηση της προτεραιότητας της κατάποσης, προσωρινή απλούστευση της κατάταξης.
2. Πάροχος «κόκκινο»: κάτω/κρύψτε τα παιχνίδια του, συγκεντρώστε εναλλακτικές συλλογές.
3. Άλμα σφάλματος API: ελέγξτε τη μνήμη/το backend, ενεργοποιήστε τα χρονοδιαγράμματα ασφαλείας, μειώστε το μέγεθος σελίδας.
4. Εσφαλμένη διαθεσιμότητα: επαναφορά του τελευταίου κανόνα, συμπερίληψη ενός «λευκού καταλόγου» κρίσιμων αγορών, αλλαγές στον έλεγχο.
5. Έκδοση κατάταξης: canary rollout (5% → 25% → 50% → 100%), CTR/μετατροπή rollback.

19) Τυπικά σφάλματα

Ανάμειξη εξωτερικών σχημάτων παρόχου με εσωτερικό μοντέλο (χωρίς ACL).
Η απουσία του 'as _ of/freshnes → διαφωνίες σχετικά με τον «ξεπερασμένο» κατάλογο.
Εξατομίκευση που παραβιάζει τους κανόνες δικαιοδοσίας.
Η μόνη «μαγική» κατάταξη φόρμουλα χωρίς αποσύνθεση σημάτων και A/B.
Μεγάλες σελίδες χωρίς κρυψώνα και δρομείς → p99 «shot».
Διπλή εγγραφή στο δείκτη και OLTP αντί των γεγονότων + προβολές.

20) Κατάλογος επιλογών πριν από την πώληση

• Κανονικοποιημένο λεξικό πεδίου και ACL για όλους τους παρόχους.
• Idempotent ingest, outbox/inbox, DLQ και redrive.
• Προβολές καταλόγου και δείκτες αναζήτησης με φρεσκάδα SLO.
• Κατάταξη ελεγχόμενη με το βάρος, αποσύνθεση σήματος και A/B.
• Κανόνες συμμόρφωσης (γεω/ηλικία/θέμα) και έλεγχος των αλλαγών.
• Πολυπληθείς/περιφέρεια: απομόνωση δεδομένων, δικαιοσύνη, κατοικία.
• API με 'as _ of', όψεις, δρομείς? κρύπτη και αναπηρία ανά εκδήλωση.
• p95/p99 μετρήσεις, κατάποση/ευρετηρίαση, CTR/μετατροπή· ειδοποιήσεις.
• Βιβλία παιχνιδιών περιστατικών. ελευθέρωση καναρινιών και ficheflags.
• Δοκιμασίες συνάφειας, συμβάσεις, χάος και εξατομίκευση.

Συμπέρασμα

Η μηχανή καταλόγου είναι μια «μηχανή αναζήτησης + σύστημα κανόνων + βιτρίνα» πάνω από το περιεχόμενο του παιχνιδιού. Ισχυρή ACL, κανονικοποιημένα δεδομένα, προβολές για γρήγορες αναγνώσεις, διαφανή σήματα κατάταξης, εξατομίκευση με μετρήσεις guardrail και αυστηρή συμμόρφωση μετατρέπουν τον κατάλογο σε έναν βιώσιμο και μετρήσιμο μοχλό ανάπτυξης - χωρίς εκπλήξεις στην παραγωγή και χωρίς συμβιβασμούς με τις ρυθμιστικές αρχές.