Προσαρμοσμένοι επεξεργαστές

Υπάρχει δουλειά που δεν υπάρχει σε κανένα πάνελ, γιατί είναι μόνο δική σας: ο δικός σας υπολογισμός τιμών με βάση τον τύπο του προμηθευτή, η αντιπαραβολή του καταλόγου με ένα ξένο λογιστικό σύστημα, μια οθόνη «συμπλήρωση χαρακτηριστικών παρτίδας σε ένα πέρασμα». Η ενότητα «Προσαρμοσμένοι επεξεργαστές» σας επιτρέπει να γράψετε μόνοι σας έναν τέτοιον μίνι επεξεργαστή (ή να τον παραγγείλετε) και να τον εκκινήσετε μέσα στο διαχειριστικό περιβάλλον — σε sandbox, με πρόσβαση ακριβώς στα δεδομένα που έχετε επιτρέψει.

Άνοιγμα: Διαχειριστικό πάνελ → Προσαρμοσμένοι επεξεργαστές (admin.cenaly.com/custom-editors). Η ενότητα ενεργοποιείται με την κάρτα «Προσαρμοσμένοι επεξεργαστές (SDK)» στο κατάστημα εφαρμογών — από προεπιλογή είναι κρυμμένη. Το κουμπί «📌 Στην πλαϊνή στήλη» στην ίδια τη σελίδα τη μεταφέρει στο πλαϊνό μενού, όταν τη χρειάζεστε συχνά.

Τι είναι αυτή η ενότητα#

Το πρόσθετο είναι ένα συγκροτημένο σενάριο (index.js) και η περιγραφή του (manifest.json). Το πάνελ φορτώνει το σενάριο σε απομονωμένο πλαίσιο: δεν έχει πρόσβαση ούτε στη συνεδρία σας, ούτε στον κώδικα του διαχειριστικού περιβάλλοντος, ούτε στο δίκτυο. Μπορεί να επικοινωνεί με τα δεδομένα μόνο μέσω της γέφυρας — ενός συνόλου επιτρεπόμενων αιτημάτων, καθένα από τα οποία ελέγχεται βάσει των εκχωρημένων δικαιωμάτων.

Η σελίδα αποτελείται από μπλοκ:

Ο ανοιχτός επεξεργαστής καταλαμβάνει όλη την οθόνη και η διεύθυνση της σελίδας αποκτά τη σήμανση ?app=<αναγνωριστικό> — με έναν τέτοιο σύνδεσμο μπορείτε να μοιραστείτε με όποιον έχει πρόσβαση.

Τι χρειάζεται για την εκκίνηση#

Βήμα 1. Αποφασίστε ποιος θα γράψει τον επεξεργαστή#

Οι δρόμοι είναι τρεις και διαφέρουν ως προς το ποιος κρατά τον κώδικα:

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

Βήμα 2. Ανάπτυξη με τεχνητή νοημοσύνη (vibe coding)#

Το μπλοκ «🤖 Ανάπτυξη με τεχνητή νοημοσύνη (vibe coding)» δίνει τέσσερα πράγματα, ώστε να αναθέσετε την εργασία σε έναν πράκτορα τεχνητής νοημοσύνης (Claude Code, Cursor και παρόμοια) χωρίς να του εξηγείτε το συμβόλαιο από την αρχή:

1. «⬇️ Λήψη προτύπου έργου (zip)» — έτοιμος σκελετός πρόσθετου: manifest, σημείο εισόδου, περιγραφή συμβολαίου (GUIDE.en.md) και οδηγίες για τον πράκτορα. Το αρχείο συγκροτείται απευθείας στον περιηγητή, δεν χρειάζεται να κατεβάσετε τίποτα εξωτερικό.
2. «📋 Αντιγραφή prompt για τον πράκτορα» — κείμενο ανάθεσης στα αγγλικά: να ξεκινήσει από το πρότυπο, να συμβουλεύεται τον οδηγό, με τι να ελέγχει το αποτέλεσμα.
3. Διαμόρφωση συνόλου εργαλείων για τον πράκτορα — με αυτό ο πράκτορας συγκροτεί το πρόσθετο, σηκώνει τοπικό πάγκο-αντίγραφο του sandbox, κάνει στιγμιότυπα οθόνης και καταστάσεων, και στο τέλος συγκροτεί την έκδοση: zip για χειροκίνητη εγκατάσταση ή έκδοση στο GitHub.
4. «⬇️ Λήψη στιγμιότυπου καταλόγου (δοκιμαστικό fixture)» — οι κατηγορίες και τα είδη σας σε αρχείο, ώστε ο πράκτορας να δοκιμάζει σε πραγματικά δεδομένα και όχι σε επινοημένα.

⚠️ Από το στιγμιότυπο αφαιρούνται εξ ολοκλήρου τα προσαρμοσμένα πεδία άλλων πρόσθετων: δεδομένα που μια ξένη επέκταση αποθηκεύει στις κάρτες σας δεν φεύγουν από τον λογαριασμό μαζί με το fixture.

Βήμα 3. Εγκατάσταση του επεξεργαστή#

Από αρχεία. Μπλοκ «Εγκατάσταση επεξεργαστή»: επιλέξτε «Bundle (index.js)» και «Manifest (manifest.json)» → «Έλεγχος και εγκατάσταση». Το πάνελ πρώτα ελέγχει το manifest — αναγνωριστικό, μεταφρασμένο όνομα, έκδοση, ελάχιστη έκδοση SDK, τοποθετήσεις, δικαιώματα και λίστα δικτυακών κόμβων — και μετά εμφανίζει τη συγκατάθεση: «Αυτός ο επεξεργαστής ζητά:» και τη λίστα δικαιωμάτων σε κατανοητή γλώσσα. Όσο δεν πατήσετε «Εγκατάσταση», δεν εγκαθίσταται τίποτα.

Από το GitHub. Μπλοκ «Εγκατάσταση από GitHub»: πεδίο «Αποθετήριο (URL ή owner/repo)», πεδίο «Ετικέτα (κενό = τελευταία έκδοση)» και κουμπί «Έλεγχος αποθετηρίου». Η σύμβαση είναι απλή: manifest.json στη ρίζα του αποθετηρίου, συγκροτημένο dist/index.js στην ετικέτα, ετικέτα της μορφής v{έκδοση}. Το manifest και το bundle έλκονται απευθείας από τον περιηγητή σας. Και στις δύο περιπτώσεις, κατά την εγκατάσταση υπολογίζεται και απομνημονεύεται το αποτύπωμα του bundle (sha256): αν το αρχείο αντικατασταθεί αργότερα, η εκκίνηση θα αποκλειστεί και το πάνελ θα ζητήσει επανεγκατάσταση του επεξεργαστή.

Δικαιώματα και θέσεις τοποθέτησης#

Τα δικαιώματα (τα λένε και scopes) το plugin τα ζητά στο manifest, και εσείς τα επιβεβαιώνετε κατά την εγκατάσταση. Ο πλήρης κατάλογος είναι ο παρακάτω — η γέφυρα δεν μπορεί τίποτα περισσότερο:

Ό,τι δεν υπάρχει καθόλου στη λίστα, το plugin δεν θα το αποκτήσει με καμία ρύθμιση: επισκέπτες και πελάτες, παραγγελίες, αποδείξεις, οικονομικά, εργαζόμενους, συνομιλίες και κλήσεις η γέφυρα δεν τα δίνει.

Θέσεις τοποθέτησης (slots) — τρεις:

Λειτουργία προγραμματιστή και πρόσβαση σε συνεργάτη#

Η Λειτουργία προγραμματιστή (μπλοκ «🛠️ Λειτουργία προγραμματιστή») τοποθετεί το plugin ζωντανά από τον υπολογιστή σας: το πεδίο «URL του bundle» δέχεται μόνο διευθύνσεις localhost / 127.0.0.1, δίπλα — «JSON του manifest», κουμπί «Έναρξη dev-session». Το αποτύπωμα σε αυτή την περίπτωση δεν καρφιτσώνεται, και η συνεδρία ζει μέχρι να κλείσει η καρτέλα· το «Διακοπή dev-session» την απενεργοποιεί αμέσως.

Τα Δικαιώματα στον προγραμματιστή (μπλοκ «👩‍💻 Πρόσβαση προγραμματιστή») χρειάζονται όταν δεν γράφει ο ιδιοκτήτης. Στον προγραμματιστή δημιουργείται ένας συνηθισμένος λογαριασμός εργαζομένου, και στη συνέχεια ο ιδιοκτήτης εκδίδει grant: «Email του προγραμματιστή (το staff-login του)», «Επιτρεπόμενα δικαιώματα», «Διάρκεια ισχύος (ημέρες)» και προαιρετική σημείωση → «Χορήγηση πρόσβασης». Η ανάκληση μπορεί να γίνει οποιαδήποτε στιγμή με το κουμπί «Ανάκληση».

Τι δίνει το grant και τι όχι:

• δίνει — μόνο λειτουργία προγραμματιστή με τα δικαιώματα που έχετε επιλέξει (προεπιλεγμένη διάρκεια 14 ημέρες, μέγιστη 90)·
• τα δικαιώματα κόβονται με τομή: ό,τι ζητά το manifest και ό,τι έχει χορηγηθεί με το grant· το plugin δεν θα πάρει κάτι παραπάνω, ακόμα κι αν το ζητήσει στο manifest·
• δεν δίνει — εγκατάσταση, ενεργοποίηση και διαγραφή plugins: αυτά παραμένουν στον ιδιοκτήτη.

Ενημέρωση, ενεργοποίηση και διαγραφή#

Αυτόματες ενημερώσεις δεν υπάρχουν σκόπιμα: μια νέα έκδοση ξένου κώδικα είναι ένα νέο αποτύπωμα και, πιθανώς, νέα δικαιώματα, γι' αυτό η ενημέρωση είναι πάντα συνειδητή ενέργεια του ιδιοκτήτη.

Ενσωματωμένες επεκτάσεις#

Μέρος των δικών μας modules είναι συσκευασμένο στην ίδια μορφή — αυτό φαίνεται από τη συμπεριφορά, αλλά δεν χρειάζεται να τα εγκαταστήσετε: έρχονται μαζί με το πάνελ και ενεργοποιούνται με καρτέλα στο κατάστημα εφαρμογών, όχι σε αυτή την ενότητα.

Προς το παρόν ένα τέτοιο module υπάρχει — το «Mercury/VetIS» για τη Ρωσία: ζει ως καρτέλα της ενότητας «Αποθήκη», εκτελείται στο ίδιο sandbox και με τους ίδιους ελέγχους αποτυπώματος. Οι ενσωματωμένες επεκτάσεις δεν μπαίνουν στη λίστα των εγκατεστημένων επεξεργαστών.

Τι μπορεί και τι δεν μπορεί ο επεξεργαστής#

Τα third-party plugins επισημαίνονται στην καρτέλα με προειδοποίηση: «Εφαρμογή τρίτου σε sandbox — δεν ζητά ποτέ κωδικό». Αν ένα plugin ζητά login από το πάνελ, στοιχεία πληρωμής ή κωδικό από SMS — είναι απάτη, όχι λειτουργία της επέκτασης.

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

• Η ενότητα είναι απενεργοποιημένη από προεπιλογή και προορίζεται για όσους γράφουν κώδικα (ή τον παραγγέλνουν): ένας απλός ιδιοκτήτης δεν έχει τίποτα να κάνει εδώ.
• Τα πάντα εκτός από την προβολή είναι μόνο για τον ιδιοκτήτη του λογαριασμού. Ο εργαζόμενος βλέπει το κέντρο read-only· η λειτουργία προγραμματιστή μόνο με ενεργή άδεια.
• Τα ιδιωτικά αποθετήρια GitHub δεν υποστηρίζονται — το αποθετήριο πρέπει να είναι δημόσιο, η εγκατάσταση γίνεται με ετικέτα.
• Δεν υπάρχει αυτόματη ενημέρωση: την ενημέρωση του πρόσθετου την ξεκινά πάντα ο ιδιοκτήτης.
• Δεν υπάρχει κατάστημα πρόσθετων τρίτων. Τα έτοιμα επεκτάσεις δεν δημοσιεύονται ούτε πωλούνται μέσω του πίνακα — πηγή είναι μόνο το δικό σας αρχείο ή το δικό σας αποθετήριο.
• Οι υποδοχές είναι τρεις (δική σας σελίδα, κουμπί καταλόγου, καρτέλα αποθήκης) — το πρόσθετο δεν μπορεί να ενσωματωθεί σε αυθαίρετη οθόνη του πίνακα.
• Η γέφυρα δεν δίνει πρόσβαση σε επισκέπτες, παραγγελίες, οικονομικά, εργαζόμενους και συνομιλίες — δεν μπορείτε να το παρακάμψετε με δικαιώματα, τέτοια αιτήματα απλώς δεν υπάρχουν.
• Δεν υπάρχει ξεχωριστό αρχείο καταγραφής «το πρόσθετο έκανε το τάδε». Τα δικαιώματα φαίνονται στην κάρτα, και οι αλλαγές του καταλόγου καταγράφονται στο συνηθισμένο ιστορικό ειδών· αν χρειάζεστε έλεγχο, ξεκινήστε με ένα πρόσθετο στο οποίο έχει δοθεί μόνο ανάγνωση.
• Τεχνικά όρια: πακέτο έως 4 MB, έως 8 δικτυακές διευθύνσεις στο manifest, έως 1 MB ανά κλειδί αποθήκευσης· εκτέλεση στον διακομιστή — έως 30 δευτερόλεπτα και έως 50 κλήσεις στο διαδίκτυο ταυτόχρονα.
• Τα δεδομένα του πρόσθετου παραμένουν στο cloud της δικής σας επωνυμίας: για λογαριασμό στο cenaly.ru η κατάσταση του τμήματος διακομιστή βρίσκεται στο ρωσικό περίγραμμα.

Αντιμετώπιση προβλημάτων#

Συχνές ερωτήσεις#

Χρειάζεται να ξέρω προγραμματισμό;#

Για να εγκαταστήσετε μια έτοιμη έκδοση — όχι. Για να αποκτήσετε την ίδια την έκδοση — ναι: τη γράφει προγραμματιστής ή πράκτορας τεχνητής νοημοσύνης με βάση το πρότυπό μας από το μπλοκ «Ανάπτυξη με τεχνητή νοημοσύνη». Η ενότητα είναι εργαλείο για κώδικα, όχι κατασκευαστής «με το ποντίκι».

Μπορεί ένα ξένο πρόσθετο να δει τους πελάτες ή τα έσοδά μου;#

Όχι. Το πρόσθετο λειτουργεί σε sandbox και λαμβάνει δεδομένα μόνο μέσω της γέφυρας, και η γέφυρα κάνει ακριβώς έξι πράγματα: κατάλογο, τιμές και λίστες εξαντλημένων, ευρετήριο αποθήκης, δική του αποθήκευση, κλήση του δικού του τμήματος διακομιστή και στοιχεία διεπαφής. Επισκέπτες, παραγγελίες, αποδείξεις, οικονομικά, εργαζόμενοι και συνομιλίες δεν υπάρχουν εκεί εκ των προτέρων. Το τι επιτρέπεται συγκεκριμένα σε κάθε πρόσθετο φαίνεται πάντα στην κάρτα του στη γραμμή «Δικαιώματα».

Πώς να αναθέσω την ανάπτυξη σε εξωτερικό συνεργάτη χωρίς να τον αφήσω να μπει ολόκληρο στον λογαριασμό;#

Δημιουργήστε του λογαριασμό εργαζόμενου και μετά δώστε άδεια στο μπλοκ «Πρόσβαση προγραμματιστή»: σημειώστε μόνο τα απαραίτητα δικαιώματα και ορίστε προθεσμία (από προεπιλογή 14 ημέρες, μέγιστο 90). Θα αποκτήσει τη λειτουργία προγραμματιστή και τίποτα άλλο· η εγκατάσταση του πρόσθετου θα παραμείνει σε εσάς. Η άδεια ανακαλείται με ένα κουμπί.

Θα ενημερωθεί το πρόσθετο μόνο του όταν ο δημιουργός κυκλοφορήσει νέα έκδοση;#

Όχι. Την ενημέρωση την ξεκινά ο ιδιοκτήτης: «Έλεγχος ενημερώσεων» → «Ενημέρωση σε …». Έτσι η νέα έκδοση δεν εμφανίζεται στον λογαριασμό εν αγνοία του ανθρώπου — μαζί με την έκδοση μπορεί να άλλαξαν και τα ζητούμενα δικαιώματα.

Πού αποθηκεύει το πρόσθετο τις ρυθμίσεις και τα δεδομένα του;#

Στον λογαριασμό σας, σε ξεχωριστή αποθήκευση με το αναγνωριστικό του (έως 1 MB ανά κλειδί), και επιπλέον, αν τα χρησιμοποιεί, σε προσαρμοσμένα πεδία των καρτών σας — κάθε πρόσθετο βλέπει μόνο τον δικό του χώρο. Για λογαριασμό στο cenaly.ru το τμήμα διακομιστή και η κατάστασή του παραμένουν στο ρωσικό περίγραμμα.

Σε τι διαφέρει από το API και το MCP;#

Το API για προγραμματιστές και το MCP του τηλεφωνικού σας κέντρου χρειάζονται όταν το πρόγραμμα λειτουργεί εξωτερικά: δική σας ιστοσελίδα, ξένο λογιστικό σύστημα, πράκτορας τεχνητής νοημοσύνης. Ο προσαρμοσμένος επεξεργαστής αντίθετα είναι διεπαφή μέσα στον πίνακα: ο εργαζόμενος τον ανοίγει σαν συνηθισμένη σελίδα του διαχειριστικού και δεν βγαίνει από το παράθυρο εργασίας.

Σχετικές ενότητες#

• Κατάστημα εφαρμογών — όπου ενεργοποιείται η ενότητα και οι ενσωματωμένες επεκτάσεις
• Αποθήκη — η καρτέλα όπου ζουν επεκτάσεις όπως το «VetIS», και το ευρετήριο προϊόντων
• Εισαγωγή καταλόγου — η τυπική διαδρομή φόρτωσης ειδών, αν η εργασία είναι μόνο αυτή
• Βιτρίνα σε δικό σας κώδικα (headless) — το ανοιχτό συμβόλαιο δεδομένων για εξωτερική ιστοσελίδα
• API και MCP του τηλεφωνικού σας κέντρου και Guest API για πράκτορες τεχνητής νοημοσύνης — εργασία εξωτερικά, όχι μέσα στον πίνακα
• Εργαζόμενοι και βάρδιες — λογαριασμός για τον προγραμματιστή και ρόλοι
• Ασφάλεια και δεδομένα — πού αποθηκεύονται τα δεδομένα και ποιος έχει πρόσβαση σε αυτά
• Υποστήριξη — πού να γράψετε αν το πρόσθετο συμπεριφέρεται ύποπτα