Architecture Decision Record

Active theme: Light

← έγγραφα

Ποιος μπορεί να δημιουργήσει ένα ADR;

Εξετάστε τομείς όπως συγκεκριμένα πρόσωπα, συγκεκριμένους ρόλους, συγκεκριμένες ομάδες ή συγκεκριμένα τμήματα· εξετάστε επίσης αν υπάρχουν πρόσωπα, ρόλοι, ομάδες ή τμήματα που μπορούν να αναθέσουν ένα ADR, δηλαδή να ζητήσουν να το συντάξει κάποιος άλλος.

Παράδειγμα απάντησης: Οποιοδήποτε πρόσωπο στον οργανισμό μας που έχει διαβάσει τη σελίδα README για την καταγραφή αρχιτεκτονικών αποφάσεων μπορεί να προτείνει ένα ADR, δηλαδή να αρχίσει να το γράφει και να το μοιραστεί με την ομάδα.

Τι δικαιολογεί τη δημιουργία ενός ADR;

Εξετάστε τομείς όπως οι τρόποι εργασίας των ομάδων του οργανισμού σας, η δομή του συστήματος λογισμικού σας, ο συντονισμός μεταξύ ομάδων, η μακροπρόθεσμη συντηρησιμότητα, οι εξωτερικές διεπαφές, ποιον θέλετε να ωφελήσετε και τα παρόμοια.

Παράδειγμα απάντησης: Θέλουμε να δημιουργούμε ένα ADR όταν θέλουμε οι μελλοντικοί προγραμματιστές να κατανοούν το «γιατί» αυτού που κάνουμε.

Τι δικαιολογεί τη μη δημιουργία ενός ADR;

Εξετάστε τομείς όπως αποφάσεις που δεν αφορούν την αρχιτεκτονική ή είναι μικροσκοπικές, π.χ. ελάχιστου ρίσκου ή αυτοτελείς ή ενός προγραμματιστή, ή καλύπτονται ήδη πλήρως αλλού, π.χ. από πρότυπα, πολιτικές ή τεκμηρίωση, ή είναι προσωρινές, π.χ. παρακάμψεις, αποδείξεις εννοίας ή πειράματα.

Παράδειγμα απάντησης: Παραλείπουμε ένα ADR όταν μια απόφαση είναι περιορισμένη σε εύρος, χρόνο, ρίσκο και κόστος ή καλύπτεται ήδη αλλού.

Ποιος είναι ο κύκλος ζωής ενός ADR;

Εξετάστε τομείς όπως η διαδικασία δημιουργίας, η διαδικασία έρευνας, η διαδικασία λήψης απόφασης, η διαδικασία υλοποίησης και η διαδικασία απόσυρσης. Εξετάστε πώς θα παρακολουθείτε τον κύκλο ζωής του ADR με την πάροδο του χρόνου, π.χ. πώς θα μετακινείτε το ADR από μια κατάσταση στην επόμενη και πώς θα το κοινοποιείτε στα ενδιαφερόμενα μέρη.

Παράδειγμα απάντησης: Θέλουμε ένα ADR να έχει πέντε στάδια κύκλου ζωής: Έναρξη → Έρευνα → Αξιολόγηση → Υλοποίηση → Συντήρηση → Απόσυρση.

Ποια είναι τα κριτήρια για τα στάδια του κύκλου ζωής ενός ADR;

Εξετάστε τομείς όπως τα κριτήρια αποδοχής ενός ADR, δηλαδή πώς ξέρετε ότι είναι αρκετά καλό για να προχωρήσει από ένα στάδιο του κύκλου ζωής στο επόμενο; Είναι το πρόβλημα σαφώς διατυπωμένο; Έχουν εξεταστεί οι εναλλακτικές; Είναι οι συμβιβασμοί αρκετά κατανοητοί και τεκμηριωμένοι; Υπάρχει όλο το σχετικό πλαίσιο; Συμμετέχουν όλα τα σχετικά ενδιαφερόμενα μέρη; Έχουν ενσωματωθεί όλα τα σχόλια;

Παράδειγμα απάντησης: Θέλουμε ένα ADR να τίθεται σε ψηφοφορία από τα ενδιαφερόμενα μέρη όταν η ενεργή ομάδα 1) έχει ολοκληρώσει την έρευνά της, 2) έχει ολοκληρώσει την αξιολόγησή της, 3) έχει δημοσιεύσει την πρόταση ADR στα ενδιαφερόμενα μέρη με αίτημα για σχόλια και χρονικό περιθώριο μίας εβδομάδας, 4) όλα τα σχόλια των ενδιαφερόμενων μερών έχουν ενσωματωθεί και αντιμετωπιστεί.

Ποιοι ρόλοι και ευθύνες αλληλεπιδρούν με ένα ADR;

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

Παράδειγμα απάντησης: Θέλουμε κάθε ADR να έχει πάντα ένα κύριο πρόσωπο επαφής, ένα δευτερεύον πρόσωπο επαφής και μια υπεύθυνη ομάδα· αυτά είναι υπεύθυνα για τις επικοινωνίες, τις δημοσιεύσεις, τη συντήρηση, την περιοδική αναθεώρηση τουλάχιστον μία φορά τον χρόνο και την ενδεχόμενη απόσυρση όπου χρειάζεται.

Πώς αλληλεπιδρά η διακυβέρνηση με ένα ADR;

Εξετάστε τομείς όπως οι τρόποι εργασίας του οργανισμού σας, τυχόν ειδικές ανάγκες συμμόρφωσης, π.χ. νομικές πτυχές ή πτυχές ανθρώπινου δυναμικού, και πώς θέλετε να χειρίζεστε τη συναίνεση έναντι της σύγκρουσης έναντι της κλιμάκωσης. Υπάρχουν τομείς, πρόσωπα ή ομάδες που μπορούν να έχουν μεγαλύτερη επιρροή από άλλους σε ένα ADR, π.χ. να μπορούν να το εγκρίνουν, να ψηφίσουν γι' αυτό ή να του ασκήσουν βέτο;

Παράδειγμα απάντησης: Η διακυβέρνηση ενός ADR γίνεται με αυτή τη σειρά προτεραιότητας: ο CEO, ο CTO, ο CLO, η ομάδα που υλοποιεί ένα ADR, οι ειδικοί της ομάδας που γνωρίζουν καλύτερα την αρχιτεκτονική απόφαση. Κανείς άλλος δεν έχει διακυβέρνηση, εκτός αν περιγράφεται στο ADR.

Ποιες αρχές αλληλεπιδρούν με ένα ADR;

Εξετάστε τομείς όπως οι τρόποι εργασίας του οργανισμού σας που περιλαμβάνουν γρήγορη έναντι αργής κίνησης, συναίνεση έναντι σύγκρουσης στις αποφάσεις, προτιμήσεις ρίσκου έναντι προτιμήσεων ασφάλειας, δημόσια συζήτηση έναντι ιδιωτικής συζήτησης και τα παρόμοια.

Παράδειγμα απάντησης: Χρησιμοποιούμε τις αρχές ηγεσίας της προτίμησης στη δράση, της διαφωνίας και δέσμευσης (disagree-and-commit), των εκτιμήσεων 70% που είναι αρκετά καλές για εύκολα αναστρέψιμες και εύκολα απομονώσιμες αποφάσεις, και των δημόσιων τρόπων εργασίας με εξαίρεση τις εμπιστευτικές πληροφορίες, όπως περιγράφονται στη συμφωνία εμπιστευτικότητας του οργανισμού μας.