# Πώς γράφετε JSON πρότυπο για το Fossa CRM

> Η μορφή JSON που δέχεται το Fossa CRM: fossacrm_template, ενότητες, πεδία, εγγραφές, συνδέσεις, κάρτες dashboard και η επιβεβαίωση ERASE.

- Canonical HTML: https://fossasoft.gr/blog/how-to-write-fossa-crm-template-json/
- Markdown: https://fossasoft.gr/llms/el/blog/how-to-write-fossa-crm-template-json.md
- Language: el-GR

Fossasoft, Ιωάννου Μεταξά 34, Λεπτοκαρυά 60063, Ελλάδα. Τηλέφωνο +30 2352 031 337. Email info@fossasoft.com. Δευτέρα–Παρασκευή 09:00–21:00. ΑΦΜ EL164317738. ΓΕΜΗ 165469048000. Χάρτης: https://g.co/kgs/6Lt2hQB

Σε αυτό το άρθρο εξηγούμε τη μορφή των προτύπων του Fossa CRM . Για την καθημερινή χρήση του panel, δείτε τον οδηγό χρήσης του Fossa CRM . Εδώ ασχολούμαστε μόνο με το αρχείο JSON που εισάγετε από τις Ρυθμίσεις → Πρότυπα.

Το Fossa CRM δέχεται ένα αρχείο μόνο αν περιέχει fossacrm_template: 1 και έναν πίνακα modules . Διαφορετικά, το απορρίπτει ως μη έγκυρο πρότυπο. Να θυμάστε ότι η εισαγωγή σβήνει ενότητες, πεδία, εγγραφές, κάρτες dashboard και ιστορικό, ενώ χρήστες, αρχεία και API keys παραμένουν. Γι’ αυτό, πριν εφαρμόσετε ένα αρχείο, το panel σας ζητά να πληκτρολογήσετε ERASE .

Ένα πρότυπο περιγράφει τη δομή του CRM σας, με προαιρετικές ενδεικτικές εγγραφές και κάρτες dashboard. Δεν είναι αντίγραφο ασφαλείας των χρηστών, ούτε περιέχει τα αρχεία σας, εκτός αν προσθέσετε λίστα assets για να κατέβουν κατά την εισαγωγή. Τα έτοιμα πρότυπα, όπως το «Επισκευές ηλεκτρονικών και υπηρεσίες IT», έχουν ακριβώς την ίδια μορφή.

Ο πιο απλός δρόμος: στήστε τις ενότητες στο panel, προσθέστε μερικές εγγραφές και πατήστε Εξαγωγή τρέχοντος JSON . Στη συνέχεια επεξεργάζεστε αυτό το αρχείο. Το export περιέχει ήδη όσα περιμένει το Fossa CRM: τιμές type , slug στο relation , _id στις εγγραφές και @module.ref στις συνδέσεις.

Γράψτε αρχείο από το μηδέν μόνο αν δεν έχετε ακόμη group ή αν θέλετε ένα καθαρό πρότυπο για άλλο group. Σε κάθε περίπτωση, κρατήστε αντίγραφο του τελευταίου export πριν πληκτρολογήσετε ERASE.

Ο πιο εύκολος τρόπος να αποκτήσετε δικό σας πρότυπο: ανοίξτε το Fossa CRM template JSON — spec για AI , αντιγράψτε το σε ένα AI και γράψτε από κάτω λίγα λόγια για το πώς δουλεύει η επιχείρησή σας. Ζητήστε του να σας επιστρέψει μόνο έγκυρο JSON για το Fossa CRM και εισαγάγετε το αρχείο από τις Ρυθμίσεις → Πρότυπα. Το spec είναι απλό markdown, φτιαγμένο ακριβώς για αυτή τη χρήση.

Και σε αυτή την περίπτωση θα χρειαστεί να πληκτρολογήσετε ERASE πριν την εισαγωγή. Ένα AI μπορεί να κάνει λάθη, οπότε ρίξτε μια ματιά στο αποτέλεσμα: το fossacrm_template πρέπει να είναι ο αριθμός 1 και οι συνδέσεις να έχουν τη μορφή @module._id . Αν προτιμάτε να γράψετε το αρχείο μόνοι σας, οι παρακάτω ενότητες εξηγούν κάθε κλειδί.

Κάθε ενότητα χρειάζεται name (ή name_el , αν η εισαγωγή γίνεται με ελληνικές ετικέτες). Το slug είναι το κομμάτι του URL, για παράδειγμα customers . Αν είναι κενό ή χρησιμοποιείται ήδη, το Fossa CRM δημιουργεί νέο από το όνομα.

Για κάθε πεδίο ορίζετε label / label_el , type , required , show_on_form και show_on_table . Προαιρετικά, μπορείτε να προσθέσετε placeholder, help, default, min, max και maxlength. Ένα πεδίο επιλογής χρειάζεται options , με value, label και προαιρετικά label_el και color. Ένα πεδίο σύνδεσης χρειάζεται relation με το slug της άλλης ενότητας, όχι με το όνομα που εμφανίζεται.

Στο panel βλέπετε φιλικά ονόματα, ενώ στο αρχείο χρησιμοποιούνται τα παρακάτω αγγλικά κλειδιά. Αν ένας τύπος δεν αναγνωρίζεται, το πεδίο γίνεται text .

Κάθε εγγραφή είναι ένα αντικείμενο. Το _id είναι ένα σύντομο αναγνωριστικό της επιλογής σας, π.χ. acme , και τα υπόλοιπα κλειδιά αντιστοιχούν στα key των πεδίων. Μια σύνδεση γράφεται ως @customers.acme : το σύμβολο @, το slug της ενότητας-στόχου, τελεία και το _id της εγγραφής. Έτσι μια εργασία συνδέεται με έναν πελάτη χωρίς να χρειάζονται UUID της βάσης μέσα στο αρχείο.

Ένα πεδίο αρχείων μπορεί να περιέχει διαδρομή αρχείου που υπάρχει ήδη στο group ή @assets.photo1 , αν έχετε δηλώσει αυτό το id στη λίστα assets . Οι ενδεικτικές εγγραφές είναι εντελώς προαιρετικές.

Κάθε widget χρειάζεται module με slug ενότητας που υπάρχει στο ίδιο αρχείο. Το page ορίζει πού θα εμφανίζεται η κάρτα: home , files , history , settings , settings_modules ή slug ενότητας (π.χ. m:jobs ). Κάθε σελίδα χωράει έως δώδεκα κάρτες· όσες περισσεύουν παραλείπονται.

Το kad είναι πληροφορία για τη λίστα προτύπων (κωδικοί δραστηριότητας) και δεν επηρεάζει τη δημιουργία των ενοτήτων. Τα assets είναι μια λίστα με ενδεικτικά αρχεία που κατεβαίνουν μέσω https κατά την εισαγωγή και χρησιμοποιούνται ως @assets.id . Και τα δύο είναι προαιρετικά. Αν δεν είστε σίγουροι, παραλείψτε τα assets.

Το παρακάτω αρχείο αρκεί για μια επιτυχημένη εισαγωγή: μια ενότητα πελατών, μια ενότητα εργασιών, σύνδεση της εργασίας με τον πελάτη, μία ενδεικτική εγγραφή σε καθεμία και μια κάρτα με το πλήθος των εργασιών στην Αρχική. Αποθηκεύστε το σε UTF-8, με κατάληξη .json .

Από τις Ρυθμίσεις → Πρότυπα επιλέξτε Εισαγωγή JSON. Επιβεβαιώστε την προειδοποίηση, πληκτρολογήστε ERASE και, αν το αρχείο έχει ετικέτες και στις δύο γλώσσες, επιλέξτε ελληνικά ή αγγλικά. Το panel σβήνει τις τρέχουσες ενότητες, πεδία, εγγραφές, κάρτες και ιστορικό και φορτώνει το νέο αρχείο. Η ενέργεια δεν αναιρείται από το panel, οπότε κάντε πρώτα export αν το group χρησιμοποιείται ήδη.

Το ίδιο JSON μπορείτε να το στείλετε και στο endpoint εισαγωγής προτύπων του API, με ένα key. Το αποτέλεσμα είναι ακριβώς το ίδιο. Για τα keys, δείτε τον οδηγό χρήσης· εδώ καλύπτουμε μόνο τη μορφή του αρχείου.

Αν το αρχείο απορριφθεί, ελέγξτε το σε έναν JSON validator και βεβαιωθείτε ότι το fossacrm_template είναι αριθμός. Αν η εισαγωγή ολοκληρωθεί αλλά οι πίνακες είναι άδειοι, απλώς δεν συμπεριλάβατε records, κάτι που επιτρέπεται. Αν οι συνδέσεις εμφανίζονται κενές, το @ref δεν αντιστοιχεί σε _id εγγραφής της ενότητας-στόχου.

Το γραφείο μας λειτουργεί Δευτέρα–Παρασκευή, 09:00–21:00, στην Ιωάννου Μεταξά 34, Λεπτοκαρυά 60063. Στείλτε μας στο info@fossasoft.com ή καλέστε στο +30 2352 031 337 . Δείτε επίσης τη σελίδα του Fossa CRM και τον οδηγό χρήσης .

{
  "fossacrm_template": 1,
  "id": "workshop",
  "name": "Workshop",
  "name_el": "Συνεργείο",
  "description": "Customers and jobs.",
  "description_el": "Πελάτες και εργασίες.",
  "modules": [
    {
      "slug": "customers",
      "name": "Customers",
      "name_el": "Πελάτες",
      "show_created": true,
      "show_updated": true,
      "fields": [
        {
          "key": "name",
          "label": "Name",
          "label_el": "Όνομα",
          "type": "text",
          "required": true,
          "show_on_form": true,
          "show_on_table": true
        }
      ],
      "records": [
        { "_id": "acme", "name": "Acme" }
      ]
    },
    {
      "slug": "jobs",
      "name": "Jobs",
      "name_el": "Εργασίες",
      "fields": [
        {
          "key": "title",
          "label": "Title",
          "label_el": "Τίτλος",
          "type": "text",
          "required": true,
          "show_on_form": true,
          "show_on_table": true
        },
        {
          "key": "customer",
          "label": "Customer",
          "label_el": "Πελάτης",
          "type": "relation",
          "relation": "customers",
          "show_on_form": true,
          "show_on_table": true
        }
      ],
      "records": [
        {
          "_id": "job1",
          "title": "Repair",
          "customer": "@customers.acme"
        }
      ]
    }
  ],
  "widgets": [
    {
      "page": "home",
      "kind": "card",
      "title": "Jobs",
      "title_el": "Εργασίες",
      "module": "jobs",
      "metric": "count"
    }
  ]
}

## FAQ

**Μπορούμε να ετοιμάσουμε το πρότυπο σε spreadsheet;**

Μπορείτε να σχεδιάσετε τις ενότητες και τις εγγραφές σε ένα φύλλο και μετά να δημιουργήσετε το JSON. Το Fossa CRM όμως δέχεται μόνο JSON σε αυτή τη μορφή, όχι CSV. Η ασφαλέστερη αφετηρία παραμένει ένα export από το panel.

**Ένα αρχείο που γράψαμε εμείς σβήνει το group όπως ένα έτοιμο πρότυπο;**

Ναι. Κάθε έγκυρη εισαγωγή, μετά το ERASE, αντικαθιστά ενότητες, εγγραφές, κάρτες και ιστορικό. Οι χρήστες, τα αρχεία και τα API keys παραμένουν.

**Είναι υποχρεωτικές οι ενδεικτικές εγγραφές;**

Όχι. Μπορείτε να παραλείψετε τα records ή να αφήσετε κενό πίνακα. Οι ενότητες και τα πεδία θα δημιουργηθούν κανονικά.

**Μπορεί ένα αρχείο να έχει ελληνικές και αγγλικές ετικέτες;**

Ναι. Χρησιμοποιήστε name και name_el, label και label_el, title και title_el. Κατά την εισαγωγή επιλέγετε ποια γλώσσα θα εφαρμοστεί.

**Μπορεί ένα AI να μας φτιάξει το πρότυπο;**

Ναι. Δώστε του το markdown spec μαζί με μια σύντομη περιγραφή της επιχείρησής σας και ζητήστε μόνο έγκυρο JSON για το Fossa CRM. Μετά εισάγετε το αρχείο. Η επιβεβαίωση με ERASE ισχύει κανονικά.

## Contact
- https://fossasoft.gr/contact/
- info@fossasoft.com
- +30 2352 031 337
- https://fossasoft.gr/company/