Git Workflow

Αποθετήριο

Ο πηγαίος κώδικας του Chamilo φιλοξενείται στο GitHub: github.com/chamilo/chamilo-lms

Διακλάδωση

• master — Κύριος κλάδος ανάπτυξης

• Οι κλάδοι χαρακτηριστικών δημιουργούνται από το master για νέα ανάπτυξη

• Οι κλάδοι κυκλοφορίας δημιουργούνται για σταθερές εκδόσεις

Συνεισφορά Αλλαγής

1. Fork το αποθετήριο στο GitHub

2. Clone το fork σας τοπικά

3. Δημιουργήστε έναν κλάδο για την αλλαγή σας: git checkout -b feature/my-feature

4. Κάντε τις αλλαγές σας ακολουθώντας τις συμβάσεις κωδικοποίησης

5. Commit με σαφή, περιγραφικά μηνύματα commit

6. Push στο fork σας: git push origin feature/my-feature

7. Δημιουργήστε ένα pull request ενάντια στον κλάδο master

Μηνύματα Commit

Γράψτε σαφή μηνύματα commit που εξηγούν τι και γιατί:

Glossary: Add AI-assisted term generation

Teachers can now generate glossary terms using configured AI
providers. Supports configurable prompt and term count.

Σύμβαση προθέματος εργαλείου

Η γραμμή θέματος προηγείται από το εργαλείο ή περιοχή που αγγίζει η αλλαγή, ακολουθούμενο από άνω τελεία. Χρησιμοποιούμε σύντομη κοινή ορολογία ώστε το changelog και το git log --oneline να μπορούν να διαβάζονται γρήγορα ανά εργαλείο. Το πρόθεμα είναι πάντα η ενικό μορφή του κανονικού ονόματος του εργαλείου.

Μορφή: <Prefix>: <Imperative summary in the present tense>

Παραδείγματα:

Document: Fix list for student view
Exercise: Prevent duplicate question titles within a quiz
Learnpath: Allow reordering chapters via drag and drop
Internal: Refactor ResourceNode hydration in the API normalizer
CI: Cache Composer downloads in the GitHub Actions workflow

Αν μια αλλαγή καλύπτει αρκετά εργαλεία, επιλέξτε το πιο επηρεαζόμενο· πραγματικά διατομεακές αλλαγές που αγγίζουν μόνο τη δομή κώδικα (χωρίς εργαλείο τελικού χρήστη) πηγαίνουν κάτω από Internal. Αλλαγές μόνο τεκμηρίωσης (αυτή η ιστοσελίδα, το changelog, inline docblocks που προορίζονται καθαρά ως αναφορά) πηγαίνουν κάτω από Documentation.

---

Επιτρέψιμα πρόθεματα

Πρόθεμα	Πεδίο / σημειώσεις
Admin
Announcement
Attendance
Authentication
Blog
Calendar	Όχι "Agenda"
Career
Catalogue	Κατάλογος μαθημάτων και συνεδριών, συμπεριλαμβανομένων των "δημοφιλών μαθημάτων" στην αρχική σελίδα
Chat
CI	Συνεχής Ενσωμάτωση, αυτοματοποιημένες δοκιμές, κ.λπ.
Course description
Course Progress	Όχι "Θεματική πρόοδος"
Course settings
Cron
Dashboard
Display
Document
Documentation	Οτιδήποτε σχετίζεται αποκλειστικά με την τεκμηρίωση του Chamilo ή του κώδικα, το changelog, κ.λπ.
Dropbox
Exercise	Όχι "Quiz"
Extra Fields
Forum
Glossary
Gradebook	Περιλαμβάνει Πιστοποιητικά
Group	Περιλαμβάνει ομάδες μαθήματος, παγκόσμιες ομάδες και τάξεις
Help
Hook	Για τον εσωτερικό μηχανισμό hook
Install	Περιλαμβάνει θέματα αναβάθμισης
Internal	Για αλλαγές και διορθώσεις που επηρεάζουν κυρίως τον ίδιο τον κώδικα ή είναι πολύ παγκόσμιες από τη φύση τους
Language
Link
Learnpath	Για LP / Learning Paths
Maintenance	Το εργαλείο συντήρησης μαθήματος: αντιγραφές μαθήματος, αντιγραφή ασφαλείας, αποκατάσταση, κ.λπ.
Message
Notebook
Optimization
Portfolio
Privacy
Script	Για ό,τι βρίσκεται στο tests/scripts/
Search	Πλήρης αναζήτηση κειμένου
Security
Session
Skill
Social	Κοινωνικό δίκτυο
SSO	Μέθοδοι Μοναδικής Είσοδος (Single Sign-On)
Survey
System	Πράγματα που αφορούν κυρίως τη φιλοξενία και τη λεπτομερή ρύθμιση σε επίπεδο εξυπηρετητή
Template
Ticket
Tracking
User
Webservice
Wiki
Work
WYSIWYG
XAPI

---

Έλεγχος Κώδικα

Οι pull requests ελέγχονται από την ομάδα maintainers. Ετοιμαστείτε να:

• Διευθετήσετε τα σχόλια και να κάνετε αναθεωρήσεις

• Διατηρήσετε το branch σας ενημερωμένο με το master

• Εξασφαλίσετε ότι οι δοκιμές περνούν

Αναφορά Προβλημάτων

Αναφέρετε σφάλματα και αιτήματα χαρακτηριστικών στο GitHub issue tracker.