Συνεισφορά στο cMind 🛠️
Ευχαριστούμε που είστε εδώ. Το cMind γίνεται καλύτερο κάθε φορά που κάποιος ανοίγει ένα ζήτημα, αναφέρει ακριβή συμπεριφορά cTrader, διορθώνει ένα τυπογραφικό σφάλμα σε αυτά τα έγγραφα, ή καραδοκεί ένα PR. Δεν χρειάζεται να είστε ένας .NET μάγος — δοκιμαστές, έμποροι, και διορθωτές doc αποτιμώνται όπως και όσοι γράφουν συγκεντρώσεις.
Αυτή η σελίδα είναι η φιλική προσέγγιση. Η πλήρη, πάντα-ρεύμα διαδικασία — κανόνες εδάφους, σύμβαση κωδικοποίησης, ροή αναθεώρησης — είναι σε CONTRIBUTING.md.
Η πρώτη σας συνεισφορά σε ~10 λεπτά
git clone https://github.com/amusleh-spotware-com/cmind.git
cd cmind
dotnet restore
dotnet build # 0 προειδοποιήσεις, ή CI θα σας αρνηθεί ευγενικά
dotnet test # μονάδα + ενσωμάτωση + E2E
Βρήκατε κάτι να διορθώσετε; Κλάδο, αλλάξτε, προσθέστε μια δοκιμή, και ανοίξτε ένα PR. Αυτό είναι ολόκληρο το βρόχο.
Τρόποι για να βοηθήσετε (όχι όλα αυτά είναι κώδικας)
| Συνεισφορά | Προσπάθεια | Όπου |
|---|---|---|
| 🐛 Αναφέρετε ένα αναπαράγων σφάλμα | 10 λεπτά | Αναφορά σφάλματος |
| 💡 Προτείνετε ένα χαρακτηριστικό | 10 λεπτά | Αίτημα δυνατότητας |
| 📖 Βελτιώστε αυτά τα έγγραφα | 15 λεπτά | Επεξεργασία κάτω από website/docs/ και PR |
| 🧪 Προσθέστε μια δοκιμή που λείπει | 30 λεπτά | tests/UnitTests · IntegrationTests · E2ETests |
| 🧠 Αναφέρετε ακριβή συμπεριφορά cTrader | 10 λεπτά | Ανοίξτε μια Συζήτηση |
Οι κανόνες του σπιτιού (σύντομη έκδοση)
Το cMind κινεί πραγματικά χρήματα, έτσι λίγα πράγματα είναι μη-διαπραγματεύσιμα — και ειλικρινά, κάνουν τη βάση κώδικα ένα χαρμάνι:
- Αυστηρό Domain-Driven Design. Η λογική επιχειρήσεων ζει σε συγκεντρώσεις και αντικείμενα αξίας, ποτέ σε τελικά σημεία ή UI. (Υπάρχει ένας φιλικός playbook για αυτό στο repo.)
- Τρεις δοκιμαστικές τομεάς, κάθε αλλαγή. Μονάδα + ενσωμάτωση + E2E, συμπεριλαμβανομένων μονοπατιών αποτυχίας (ρίψιμο συνδέσεις, απορρίπτονται παραγγελίες, νεκροί κόμβοι). Πράσινα δοκιμές είναι το τίμημα της εισόδου.
- Μηδέν προειδοποιήσεις.
TreatWarningsAsErrors=true. Σύγχρονα C# 14 ιδιώματα. - Χωρίς μυστικά, χωρίς μαγικές συμβολοσειρές, ποτέ
DateTime.UtcNow(ενέχετεTimeProviderαντ 'αυτού). - Έγγραφα στο ίδιο commit. Συμπεριφορά αλλαγής → ενημέρωση έγγραφά του. Ναι, που περιλαμβάνει αυτό το site.
Πλήρης λεπτομέρεια, με το γιατί πίσω από κάθε κανόνα, σε CONTRIBUTING.md και AGENTS.md.
Συνεισφορά με AI 🤖
Καλώς ήρθατε ειλικρινά υποστηριγμένα PRs IA — αυτό το έργο κατασκευάζεται για να εργάζεται σε πράκτορες καθώς και
ανθρώπους. Εάν οδηγείτε Claude, Copilot ή παρόμοια: δείχνει του αυτό
AGENTS.md, αφήστε του να διαβάσει τα ένθετα
CLAUDE.md αρχεία, και κρατήστε το στο ίδιο κούπι (δοκιμές, μηδέν προειδοποιήσεις, DDD). Ένα καλό AI PR είναι
αδιαφορή από ένα καλό ανθρώπινο PR — ίδια αναθεώρηση, ίδια καλωσόρισμα.
Είστε εξαιρετικό ο ένας στον άλλο
Έχουμε ένα Κώδικα Διαγωγής. Το gist: είστε ευγενικό, υποθέστε καλή πίστη, και θυμηθείτε υπάρχει ένας άνθρωπος (ή ένας παράγοντας ενός ατόμου) στο άλλο άκρο. Ζητήστε ερωτήσεις νωρίς — αυτό είναι μια δύναμη, όχι λοξός παράγοντας.
Καλώς ήρθατε ομάδα. Δεν μπορούμε να περιμένουμε να δούμε τι κατασκευάζετε. 🎉