Ροή εργασίας Git

Αποθετήριο

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

Διακλάδωση

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

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

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

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

1. Κάντε fork το αποθετήριο στο GitHub

2. Κλωνοποιήστε το 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, τα ενσωματωμένα docblocks που προορίζονται καθαρά ως αναφορά) εντάσσονται στο Documentation.

Επιτρεπόμενα προθέματα

Prefix	Scope / notes
Admin
Announcement
Attendance
Authentication
Blog
Calendar	Όχι "Agenda"
Career
Catalogue	Κατάλογος μαθημάτων και συνεδριών, συμπεριλαμβανομένων των «hot courses» στην αρχική σελίδα
Chat
CI	Συνεχής ενσωμάτωση (Continuous Integration), αυτοματοποιημένες δοκιμές κ.λπ.
Course description
Course Progress	Όχι "Thematic advance"
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 εξετάζονται από την ομάδα των συντηρητών. Να είστε προετοιμασμένοι να:

• Αντιμετωπίσετε τα σχόλια και να κάνετε αναθεωρήσεις

• Διατηρείτε τον κλάδο σας ενημερωμένο με το master

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

Αναφορά Θεμάτων

Αναφέρετε σφάλματα και αιτήματα λειτουργιών στον ιχνηλάτη θεμάτων του GitHub.