Γενικά

Πριν ξεκινήσετε να ασχοληθείτε με την ανάπτυξη του Open eClass είναι καλό να ανατρέξετε στο http://dev.openeclass.org. Εκεί, ανάμεσα στα άλλα, θα βρείτε κατάλογο με τα ζητούμενα νέα χαρακτηριστικά, τις τρέχουσες εργασίες σε εξέλιξη και τυχόν γνωστά σφάλματα τα οποία χρειάζονται διόρθωση. Ο κώδικας της εφαρμογής είναι επίσης διαθέσιμος και μπορείτε να τον δείτε εδώ.

Οι αλλαγές στον κώδικα της πλατφόρμας θα πρέπει να υπακούουν σε κάποιες προδιαγραφές διαφορετικά δεν θα γίνονται δεκτές ούτε θα ενσωματωθούν στον κώδικα της πλατφόρμας. Περισσότερες πληροφορίες μπορείτε να διαβάσετε παρακάτω. Για ευκολία στη συντήρηση η υποβολή αλλαγών στο cvs καλό είναι να γίνεται μόνο όταν το υποσύστημα με το οποίο ασχολείστε ή οι διορθώσεις λειτουργούν σε μεγάλο βαθμό.

Η ανάπτυξη της πλατφόρμας έχει μεταφερθεί σε mercurial repository. Για να έχετε πρόσβαση στο κώδικα ανάπτυξης εκτελέστε τα παρακάτω:

Ανοίξτε ένα τερματικό και πληκτρολογήστε:

hg clone http://hg.gunet.gr/openeclass

Για τους χρήστες με συστήματα Windows

Προτεινόμενος client είναι ο:

• Tortoise

Για τους χρήστες με συστήματα Mac

Προτεινόμενος client είναι ο:

• MacHG
  

Προδιαγραφές

Οι υποβολές των αλλαγών που γίνονται στο κώδικα θα πρέπει να τηρούν τις ακόλουθες προδιαγραφές:

Συμβατότητα

Διατήρηση της συμβατότητας με τα υπόλοιπα υποσυστήματα της πλατφόρμας.

Διατήρηση της υπάρχουσας δομής της βάσης

Τυχόν αλλαγές που γίνονται στη βάση θα πρέπει να συνοδεύονται με πλήρη τεκμηρίωση των τυχόν καινούριων πινάκων/πεδίων της βάσης μαζί με ένα script αναβάθμισης.

Τήρηση των κανόνων ασφαλείας

Ιδιαίτερη προσοχή έτσι ώστε ο χρήστης/φοιτητής να μην μπορεί να εκτελεί ενέργειες που δεν επιτρέπονται. Ασφάλεια θα πρέπει να υπάρχει και στο "Διαχειριστικό Εργαλείο της Πλατφόρμας".

 

Τεκμηρίωση

Σύντομη τεκμηρίωση των λειτουργιών που προστίθονται/αλλάζουν καθώς και του αντίστοιχου κώδικα. Αν οι αλλαγές διορθώνουν κάποιο σφάλμα ή δυσλειτουργία, θα πρέπει να παρατίθεται αντίστοιχο παράδειγμα.

Αντίστοιχο on-line help

Κάθε καινούριο υποσύστημα θα πρέπει να συνοδεύεται από το αντίστοιχο on-line help. Επίσης, θα πρέπει να υπάρχουν περιγραφές του υποσυστήματος για ενσωμάτωσή του στα εγχειρίδια.

Επιτυχημένη λειτουργία

Είναι επιθυμητή η αναφορά επιτυχημένης λειτουργίας σε όσο το δυνατόν περισσότερες εκδόσεις λειτουργικών συστημάτων (π.χ. Windows XP/2000/2003/Vista/2007, UNIX/Linux) και εκδόσεων PHP (εκδόσεις >= 5.x), Apache (>= 2.x), MySQL (εκδόσεις >= 5.x.). Αν υπάρξουν τυχόν ασυμβατότητες σε συγκεκριμένες εκδόσεις PHP, Apache, MySQL (πάντα σε εκδόσεις μεγαλύτερες από τις προαναφερθέντες) θα πρέπει να αναφέρονται καθώς και να δικαιολογούνται.

 

Συμβατότητα με τους πιο δημοφιλείς browsers

Ο καινούριος κώδικας θα πρέπει να είναι συμβατός με τους πιο δημοφιλείς browsers (π.χ. Internet Explorer εκδόσεις μεγαλύτερες του 6, Firefox εκδόσεις μεγαλύτερες του 1.x) και σε οθόνες με ανάλυση τουλάχιστον 1024x768.