Πρωτέας

Το project Πρωτέας σχεδιάζεται και αναπτύσσεται από τον εκπαιδευτικό Πληροφορικής Δ.Ε. ΠΕ86 Βαγγέλη Ζαχαριουδάκη από το σχολικό έτος 2011-2012 έως σήμερα, για λογαριασμό της Δ/νσης Πρωτοβάθμιας Εκπαίδευσης Ν.Ηρακλείου.

Αποτελεί μία ολοκληρωμένη βάση δεδομένων υπαλλήλων Πρωτοβάθμιας εκπαίδευσης.

Χαρακτηριστικά:

• Καρτέλα μόνιμου/αναπληρωτή εκπ/κού (στοιχεία, υπηρετήσεις, άδειες, ιδιωτικά έργα, χρόνοι υπηρεσίας κλπ.)
• Υπολογισμός λειτουργικών/οργανικών κενών/πλεονασμάτων
• Δημιουργία αναφορών σχολικών μονάδων
• Δημιουργία βεβαιώσεων υπηρεσίας αναπληρωτών & μόνιμων εκπ/κών
• Μισθολογική ωρίμανση εκπ/κών

Απαιτήσεις:

Α) Για κανονική εγκατάσταση, υπολογιστής με web server (Apache2 / nginx), PHP (προτιμότερα 7.2 - θα διορθωθεί σύντομα και για μεγαλύτερη έκδοση) & MySQL (προτιμότερα 5.7) ή MariaDB (βλ. σημείωση).

Β) Για εγκατάσταση με docker, αρκεί να είναι εγκατεστημένα τα Docker & του Docker-compose

ΣΗΜΕΙΩΣΗ:

Για εγκατάσταση σε MariaDB, πρέπει να απενεργοποιηθεί το strict mode της βάσης μέσω phpmyadmin. Στο πεδίο μεταβλητές (variables) του διακομιστή να αλλάξει το sql_mode ως εξής:

 - STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION (>= MariaDB 10.2.4)
 - NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION (>= MariaDB 10.1.7)
 - (empty string) (<= MariaDB 10.1.6)

Οδηγίες εγκατάστασης:

• Κλωνοποίηση του repository σε φάκελο του web server, για άμεση λήψη ενημερώσεων (με git pull). Εναλλακτικά, αποσυμπίεση αρχείου zip σε φάκελο του web server
• Εγκατάσταση απαιτούμενων βιβλιοθηκών με την εντολή composer update (σε server με εγκατεστημένο τον composer)
• Δημιουργία του config.php (με βάση το config-sample.php) και εισαγωγή των στοιχείων της βάσης δεδομένων
• Εκτέλεση του init.php (http://servername/proteas/init.php) για αρχικοποίηση της βάσης δεδομένων (να διαγραφεί αφού ολοκληρωθεί η εργασία)
• Είσοδος στο σύστημα με username/password: admin / admin
• Εισαγωγή στοιχείων υπαλλήλων & σχολείων μέσω του αντίστοιχου εργαλείου εισαγωγής (από το μενού διαχείρισης)
• Ρύθμιση παραμέτρων συστήματος (από μενού διαχείρισης)
• (Προαιρετικά) Προσαρμογή προτύπων αρχείων word (μέσα στο φάκελο word)

Οδηγίες εγκατάστασης με docker:

• Εγκατάσταση του Docker & του Docker-compose
• Κλωνοποίηση του repository σε φάκελο του web server, για άμεση λήψη ενημερώσεων (με git pull). Εναλλακτικά, αποσυμπίεση αρχείου zip σε φάκελο του web server
• Εκτέλεση της εντολής docker-compose build για προετοιμασία των σχετικών images (απαιτεί αρκετό χρόνο, ανάλογα με την ταχύτητα σύνδεσης & του server)
• Δημιουργία του config.php (με βάση το config-sample.php) και εισαγωγή των στοιχείων της βάσης δεδομένων, τα οποία πρέπει να συμφωνούν με αυτά που βρίσκονται στο docker-compose.yml
• Εκτέλεση της εντολής docker-compose -d up για εκκίνηση της εφαρμογής
• Εκτέλεση της εντολής docker-compose exec app composer update για λήψη των απαιτούμενων βιβλιοθηκών
• Εκτέλεση του init.php (http://servername/init.php) για αρχικοποίηση της βάσης δεδομένων (να διαγραφεί αφού ολοκληρωθεί η εργασία)
• Είσοδος στο σύστημα με username/password: admin / admin
• Εισαγωγή στοιχείων υπαλλήλων & σχολείων μέσω του αντίστοιχου εργαλείου εισαγωγής (από το μενού διαχείρισης)
• Ρύθμιση παραμέτρων συστήματος (από μενού διαχείρισης)
• (Προαιρετικά) Προσαρμογή προτύπων αρχείων word (μέσα στο φάκελο word)

Οδηγίες frontend:

Ο Πρωτέας δίνει τη δυνατότητα κλήσεων για άντληση δεδομένω από απομακρυσμένους server (API) για την ενημέρωση των σχολικών μονάδων και την υποβολή αιτημάτων από αυτά. Για να αξιοποιηθεί αυτή η δυνατότητα:

• Βεβαιωνόμαστε ότι ο απομακρυσμένος server έχει οριστεί στο CAS του ΠΣΔ (ανοίγουμε σχετικό ticket)
• Βεβαιωνόμαστε ότι η παράμετρος $api_token έχει οριστεί στο config.php με ένα σύνθετο αλφαριθμητικό (π.χ. εδώ)
• Αντιγράφουμε το φάκελο frontend στον απομακρυσμένο server και εκτελούμε composer update
• Αλλάζουμε το params.php με τα στοιχεία του server που βρίσκεται ο Πρωτέας
• O απομακρυσμένος server είναι έτοιμος

Βοήθεια

Η τεκμηρίωση του Πρωτέα είναι υπό κατασκευή.

Mπορείτε να λάβετε βοήθεια:

• ανοίγοντας issue στο GitHub.
• στέλνοντας email στο: [email protected].

Τέλος, τα pull requests είναι πάντα ευπρόσδεκτα για τη δική σας συνεισφορά στο project!

Εργαλεία:

Η ανάπτυξη γίνεται εξ'ολοκλήρου με λογισμικό ανοιχτού κώδικα (open-source). Τα εργαλεία που χρησιμοποιούνται είναι η γλώσσα PHP, η βάση δεδομένων MySQL και ο web server Apache.

Επίσης χρησιμοποιούνται:

• jQuery
• DataTables
• PHP Calandar Date Picker
• Select2
• StickyTableHeaders
• DrasticGrid
• PHPExcel
• PHPWord
• SwiftMailer
• Simple PHP/MySQL authentication/login class
• Paginator

Το σύστημα βρίσκεται υπό συνεχή ανάπτυξη, ανάλογα με τις ανάγκες της Δ/νσης Π.Ε. Ηρακλείου.

(c) 2021