Επίσημα πρότυπα

Το Restorm συντηρεί ένα σύνολο επίσημων προτύπων που μπορείτε να χρησιμοποιήσετε απευθείας από τη βιβλιοθήκη προτύπων. Μπορείτε επίσης να ξεκινήσετε από ένα από αυτά, να το forkάρετε και να το προσαρμόσετε στις συμβάσεις σας.

Η βιβλιοθήκη προτύπων: τα επίσημα, τα πρόσφατα χρησιμοποιημένα και τα προσαρμοσμένα πρότυπα

Ο επίσημος κατάλογος

Τα επίσημα πρότυπα δημοσιεύονται υπό τον οργανισμό GitHub Monsieur-Dev:

Πρότυπο	Στόχος	Αποθετήριο
Διακομιστής REST · TypeScript	REST · TypeScript · Express	`restorm-template-server-rest-typescript`
Διακομιστής REST · .NET	REST · C# · ASP.NET Core	`restorm-template-server-rest-dotnet`
Διακομιστής gRPC · TypeScript	gRPC · TypeScript	`restorm-template-server-grpc-typescript`
Διακομιστής gRPC · .NET	gRPC · C# / .NET	`restorm-template-server-grpc-dotnet`
Βάση PostgreSQL	SQL · PostgreSQL	`restorm-template-db-postgres`

Τα απομακρυσμένα πρότυπα ανακτώνται ως αρχειοθήκη (ποτέ δεν κλωνοποιούνται με git), με μέτρα ασφαλείας και περιορισμένο μέγεθος.

Πρότυπα οργανισμού (Enterprise)

Οι οργανισμοί με συνδρομή Enterprise διαθέτουν έναν ιδιωτικό κατάλογο προτύπων, κοινό ανάμεσα στα μέλη του οργανισμού. Εμφανίζονται στη βιβλιοθήκη υπό την καρτέλα Πρότυπα <οργανισμός>, δίπλα στα επίσημα.

Ποιος μπορεί να προσθέσει ή να αφαιρέσει: ένας διαχειριστής του οργανισμού, ή ένα μέλος στο οποίο ο διαχειριστής παραχώρησε το δικαίωμα διαχείριση προτύπων.
Πώς: από την καρτέλα Πρότυπα <οργανισμός> της βιβλιοθήκης (κουμπί Προσθήκη — το URL του αποθετηρίου και μια περιγραφή), ή από τον πίνακα ελέγχου διαχείρισης του οργανισμού.
Τι είναι: ένα πρότυπο οργανισμού είναι ένας απλός δείκτης προς ένα αποθετήριο git (όπως ένα επίσημο)· η δομή του είναι ταυτόσημη με αυτή που περιγράφεται παρακάτω, αλλά η ορατότητά του είναι περιορισμένη στα μέλη του οργανισμού.

Οι εκδόσεις Community και Pro βλέπουν τα επίσημα πρότυπα και μπορούν να χρησιμοποιήσουν τα δικά τους πρότυπα (Αποθετήριο ή Τοπικός φάκελος) — η παραγωγή κώδικα είναι ελεύθερη σε όλες τις εκδόσεις. Τα κοινόχρηστα πρότυπα οργανισμού είναι, από την πλευρά τους, αποκλειστικά για την έκδοση Enterprise.

Δομή ενός προσαρμοσμένου προτύπου

Ένα πρότυπο Restorm είναι ένα πρότυπο Cookiecutter/Copier εμπλουτισμένο με ένα μανιφέστο:

restorm-template.json — στη ρίζα του αποθετηρίου (υποχρεωτικό). Περιγράφει το πρότυπο και δηλώνει τις μεταβλητές που καταναλώνει (δείτε Μεταβλητές παραγωγής). Ανακοινώνει επίσης την έκδοση πλαισίου που υποστηρίζει: ένα πρότυπο που δεν δηλώνει μια έκδοση συμβατή με την εφαρμογή απορρίπτεται.
copier.yml (ή copier.yaml) — η διαμόρφωση Copier, που δηλώνει ιδίως τις ερωτήσεις που τίθενται κατά την παραγωγή.
Τα αρχεία του προτύπου, με κατάληξη .jinja, που αποδίδονται με το πλαίσιο του σχεδίου.

Για να χρησιμοποιήσετε ένα προσαρμοσμένο πρότυπο, επιλέξτε την πηγή Αποθετήριο (ιδιοκτήτης/όνομα στο GitHub) ή Τοπικός φάκελος (όσο το αναπτύσσετε) στη βιβλιοθήκη.