Rikodin shawarar gine-gine (ADR)
Samfura, misalai, da jagorori don rubuta shawarwarin gine-gine.
Rikodin shawarar gine-gine (ADR) takarda ce da ke rubuta wata muhimmiyar shawarar gine-gine da aka yanke tare da mahallinta da sakamakonta.
Fassarori: العربية, বাংলা, Cymraeg, Dansk, Deutsch, English, Lietuvių, Gaeilge, Lëtzebuergesch, தமிழ், मराठी, Hausa, ગુજરાતી, Euskara, भोजपुरी, Basa Jawa, فارسی, ਪੰਜਾਬੀ, Malti, Latviešu, Slovenščina, Slovenčina, Hrvatski, Български, Čeština, Magyar, Ελληνικά, Română, Polski, Español, Eesti, Suomi, Français, हिन्दी, Bahasa Indonesia, Íslenska, Italiano, 日本語, 한국어, Nederlands, Português, Русский, Svenska, Kiswahili, ไทย, Türkçe, اردو, Tiếng Việt, 中文
- Menene rikodin shawarar gine-gine?
Rikodin shawarar gine-gine (ADR) takarda ce da ke rubuta wata muhimmiyar shawarar gine-gine da aka yanke tare da mahallinta da sakamakonta.
- Yadda ake fara amfani da ADR
Don fara amfani da ADR, ku tattauna waɗannan fannoni da abokan tawagarku.
- Shawarwari kan rubuta ADR masu kyau
Dalili: Bayyana dalilan yin AD na musamman. Wannan na iya haɗawa da mahalli (duba ƙasa), fa’idodi da rashin fa’idodi na zaɓuɓɓuka daban-daban masu yiwuwa, kwatancen…
- Samfuran misali na ADR
Samfurin ADR na Michael Nygard (mai sauƙi kuma sananne)
- Shawarwarin aiki tare na ADR
Idan kuna tunanin amfani da rikodin shawarwari tare da tawagarku, ga wasu shawarwari da muka koya ta yin aiki da tawagogi da yawa.
- Ayyukan lafiya na shawarwari a matsayin lamba
Ayyukan lafiya (fitness functions) bincike ne na atomatik mai manufa wanda aka rubuta da lambar shirye-shirye, wanda ke tabbatar da cewa ana kiyaye shawarwari.
Ku yi isasshen bincikenku kafin amfani da waɗannan albarkatu a kowane tsari mai muhimmanci.
Abubuwan da ke ciki:
- Menene rikodin shawarar gine-gine?
- Yadda ake fara amfani da ADR
- Yadda ake fara amfani da ADR da kayan aiki
- Yadda ake fara amfani da ADR da git
- Ƙwarewar Claude Code don ADR
- Ka’idojin sunan fayil na ADR
- Shawarwari kan rubuta ADR masu kyau
- Samfuran misali na ADR
- Shawarwarin aiki tare na ADR
- Tambayoyin aiki tare na ADR
- Ra’ayoyin mataki na gaba don ADR
- Zane-zanen gine-gine, ra’ayoyi, da mahangogi
- Ayyukan lafiya na shawarwari a matsayin lamba
- Shingen shawara don pull requests
- Don ƙarin bayani
Samfura:
- Samfurin rikodin shawara na Jeff Tyree da Art Akerman
- Samfurin rikodin shawara na Michael Nygard
- Samfurin rikodin shawara na EdgeX
- Samfurin rikodin shawara na arc42
- Samfurin rikodin shawara don tsarin Alexandrian
- Samfurin rikodin shawara don lamarin kasuwanci
- Samfurin rikodin shawara na aikin MADR
- Samfurin rikodin shawara mai amfani da Planguage
- Samfurin rikodin shawara na Paulo Merson
- Samfurin rikodin shawara na Olaf Zimmermann
- Samfurin rikodin shawara na Gareth Morgan
- Samfurin rikodin shawara na GIG Cymru NHS Wales
- Samfurin rikodin shawara don muhimman shawarwarin fasaha (ITD) na Ignacio Larrañaga
Misalai:
- Tsarin CSS
- Saitin sauye-sauyen muhalli
- Ma’auni, masu sa ido, fadakarwa
- Microsoft Azure DevOps
- Monorepo ko multirepo
- Harsunan shirye-shirye
- Ajiyar sirri
- Tsarin tambarin lokaci
- da ƙari da yawa...
Menene rikodin shawarar gine-gine?
Rikodin shawarar gine-gine (ADR) takarda ce da ke rubuta wata muhimmiyar shawarar gine-gine da aka yanke tare da mahallinta da sakamakonta.
Shawarar gine-gine (AD) zaɓi ne na tsarin manhaja wanda ke magance wata muhimmiyar buƙata.
Rajistar shawarwarin gine-gine (ADL) tarin dukkan ADR ne da aka ƙirƙira kuma ake kula da su don wani aiki (ko ƙungiya) na musamman.
Buƙata mai muhimmanci ta fuskar gine-gine (ASR) buƙata ce da ke da tasiri mai aunuwa a kan tsarin gine-ginen tsarin manhaja.
Dukan waɗannan suna ƙarƙashin batun gudanar da ilimin gine-gine (AKM).
Manufar wannan takarda ita ce ta ba da taƙaitaccen bayani game da ADR, yadda ake ƙirƙirar su, da kuma inda za a nemi ƙarin bayani.
Gajarta:
AD: shawarar gine-gine
ADL: rajistar shawarwarin gine-gine
ADR: rikodin shawarar gine-gine
AKM: gudanar da ilimin gine-gine
ASR: buƙata mai muhimmanci ta fuskar gine-gine
Yadda ake fara amfani da ADR
Don fara amfani da ADR, ku tattauna waɗannan fannoni da abokan tawagarku.
Gano shawara:
Yaya AD yake da gaggawa kuma yaya yake da muhimmanci?
Shin dole ne a yanke shi yanzu, ko kuwa zai iya jira har sai an san ƙarin bayani?
Ƙwarewar mutum da ta gamayya, da kuma hanyoyin ƙira da ayyukan da aka sani, na iya taimakawa wajen gano shawara.
A manufa, a riƙa kula da jerin shawarwarin da ake buƙata wanda ya cika jerin ayyukan samfurin.
Yanke shawara:
Akwai dabaru da yawa na yanke shawara, na gama gari da kuma na musamman ga gine-ginen manhaja, misali taswirar tattaunawa.
Yanke shawara a rukuni batu ne na bincike mai ci gaba.
Aiwatar da shawara da tabbatar da bin ta:
Ana amfani da AD a ƙirar manhaja; saboda haka dole ne a sanar da masu ruwa da tsaki na tsarin, waɗanda ke ba da kuɗi, ke gina shi, kuma ke tafiyar da shi, kuma su amince da shi.
Salon rubuta lamba mai bayyana a gine-gine da bita-bitar lamba da ke mai da hankali kan damuwa da shawarwarin gine-gine ayyuka biyu ne masu alaƙa.
Dole ne kuma a (sake) yin la’akari da AD lokacin sabunta tsarin manhaja a cikin juyin manhaja.
Raba shawara (na zaɓi):
AD da yawa suna maimaita kansu a cikin ayyuka.
Saboda haka, abubuwan da aka koya daga shawarwarin da suka gabata, masu kyau da marasa kyau, na iya zama kadarori masu amfani da za a sake amfani da su lokacin da ake bin dabarar gudanar da ilimi a fili.
Rubuta shawara:
Akwai samfura da kayan aiki da yawa na rubuta shawara.
Duba al’ummomin masu sassauci, misali ADR na M. Nygard.
Duba hanyoyin injiniyan manhaja da ƙirar gine-gine na gargajiya, misali tsarin tebur da IBM UMF da Tyree da Akerman na CapitalOne suka ba da shawara.
Don ƙarin bayani:
- An ɗauko matakan da ke sama daga shigarwar Wikipedia kan Architectural Decision
Yadda ake fara amfani da ADR da kayan aiki
- MySpec — dandamalin ƙayyadaddun bayanai da shawarwarin gine-gine na atomatik wanda ke tsara kundin tsarin aiki, gine-ginen fasaha, da ADR a cikin Markdown mai tsabta da ake samarwa ta MCP.
Kuna iya fara amfani da ADR da kayan aiki yadda kuke so.
Misali:
Idan kuna son amfani da Google Drive da gyara ta yanar gizo, za ku iya ƙirƙirar Google Doc, ko Google Sheet.
Idan kuna son amfani da sarrafa nau’ikan lamba kamar git, za ku iya ƙirƙirar fayil ga kowane ADR.
Idan kuna son amfani da kayan tsara ayyuka kamar Atlassian Jira, za ku iya amfani da na’urar bin diddigin tsarin kayan aikin.
Idan kuna son amfani da wikis kamar MediaWiki, za ku iya ƙirƙirar wiki na ADR.
Yadda ake fara amfani da ADR da git
Idan kuna son amfani da sarrafa nau’ikan git, ga yadda muke so mu fara amfani da ADR da git don aikin manhaja na yau da kullum mai lambar tushe.
Ƙirƙiri kundin adireshi don fayilolin ADR:
$ mkdir adr
Ga kowane ADR, ƙirƙiri fayil ɗin rubutu, misali choose-database.md:
$ vi choose-database.md
Rubuta duk abin da kuke so a cikin ADR. Duba samfuran da ke wannan ma’ajiyar don samun ra’ayoyi.
Yi commit na ADR zuwa ma’ajiyar git ɗinku.
Ƙwarewar Claude Code don ADR
Wannan ma’ajiya tana ba da ƙwarewar Claude Code guda biyu a ƙarƙashin skills/, don wakilin rubuta lamba na AI ya iya rubuta da kula da ADR yadda wannan aikin ke ba da shawara:
architecture-decision-record-skill— don amfani gabaɗaya, ga duk wanda ke rubuta ADR a kowane aiki. Yana taimakawa wajen yanke ko shawara tana buƙatar ADR, yana kafa kundinadr/kodecisions/, yana sanya sunan fayil, yana zaɓar samfuri daga cikin tsare-tsare goma sha ɗaya da aka haɗa, kuma yana rubuta sassan Mahalli/Shawara/Sakamako da ƙarfi.architecture-decision-record-maintainer-skill— musamman ga masu kula da wannan ma’ajiya. Yana rubuta tsarin ma’ajiyar, ƙa’idar madubin README/locales, da takamaiman matakan ƙara sabon samfuri, misali, ko hanyar haɗin kayan aiki.
Don amfani da ƙwarewa, kwafi kundinta zuwa .claude/skills/ a tushen ma’ajiyar da kuke aiki a ciki (ko zuwa ~/.claude/skills/ don samun ta a kowane aiki), sannan ku nemi Claude Code ya rubuta ko ya bita ADR.
Ka’idojin sunan fayil na ADR
Idan kun zaɓi ƙirƙirar ADR ɗinku a cikin fayilolin rubutu na yau da kullum, kuna iya son ƙirƙirar ƙa’idar sunan fayil ɗin ADR ɗinku.
Muna fifita amfani da ƙa’idar sunan fayil mai tsari na musamman.
Misalai:
choose-database.md
format-timestamps.md
manage-passwords.md
handle-exceptions.md
Ƙa’idar sunan fayil ɗinmu:
Sunan yana da jimlar aikatau ta umarni a halin yanzu. Wannan yana taimakawa wajen karantawa kuma yana dacewa da tsarin saƙonnin commit ɗinmu.
Sunan yana amfani da ƙananan haruffa da dashes (kamar wannan ma’ajiyar). Wannan daidaito ne tsakanin sauƙin karantawa da amfanin tsarin.
Tsawo markdown ne. Wannan na iya zama da amfani don sauƙin tsarawa.
Shawarwari kan rubuta ADR masu kyau
Siffofin ADR mai kyau:
Dalili: Bayyana dalilan yin AD na musamman. Wannan na iya haɗawa da mahalli (duba ƙasa), fa’idodi da rashin fa’idodi na zaɓuɓɓuka daban-daban masu yiwuwa, kwatancen siffofi, tattaunawar kuɗi/riba, da ƙari.
Na musamman: Kowane ADR ya kamata ya zama game da AD ɗaya, ba AD da yawa ba.
Tambarin lokaci: Gano lokacin da aka rubuta kowane abu a cikin ADR. Wannan yana da muhimmanci musamman ga abubuwan da za su iya canzawa da lokaci, kamar kuɗi, jadawali, faɗaɗawa, da makamantansu.
Maras canzawa: Kada ku canza bayanan da ke cikin ADR. Maimakon haka, ku gyara ADR ta ƙara sabon bayani, ko ku maye gurbin ADR ta ƙirƙirar sabon ADR.
Siffofin kyakkyawan sashen “Mahalli” a cikin ADR:
Bayyana yanayin ƙungiyar ku da fifikon kasuwancinta.
Haɗa dalilai da la’akari bisa tsarin zamantakewa da ƙwarewar tawagarku.
Haɗa fa’idodi da rashin fa’idodi masu alaƙa, kuma ku siffanta su da kalmomin da suka dace da buƙatunku da manufofinku.
Siffofin kyakkyawan sashen “Sakamako” a cikin ADR:
Bayyana abin da ke biyo bayan yanke shawara. Wannan na iya haɗawa da tasiri, sakamako, abubuwan da aka samar, bin diddigi, da ƙari.
Haɗa bayani game da duk wasu ADR da suka biyo baya. Yana da kusan al’ada ADR ɗaya ya jawo buƙatar ƙarin ADR, kamar lokacin da ADR ɗaya ya yi babban zaɓi wanda kuma ya haifar da buƙatar ƙarin ƙananan shawarwari.
Haɗa duk wasu hanyoyin bitar bayan aiki. Yana da al’ada tawaga ta yi bitar kowane ADR bayan wata ɗaya, don kwatanta bayanan ADR da abin da ya faru a zahiri, domin koyo da ci gaba.
Sabon ADR na iya maye gurbin ADR na baya:
- Lokacin da aka yanke AD wanda ya maye gurbin ko ya ɓata ADR na baya, ya kamata a ƙirƙiri sabon ADR
Samfuran misali na ADR
Samfuran misali na ADR da muka tattara daga intanet:
Samfurin ADR na Michael Nygard (mai sauƙi kuma sananne)
Samfurin ADR na Jeff Tyree da Art Akerman (ya fi ƙwarewa)
Samfurin ADR don tsarin Alexandrian (mai sauƙi tare da cikakkun bayanan mahalli)
Samfurin ADR don lamarin kasuwanci (ya fi karkata zuwa MBA, tare da kuɗi, SWOT, da ƙarin ra’ayoyi)
Samfurin ADR na aikin Markdown Any Decision Records (MADR) (sigar mai sauƙi da ta cikakke; ta ƙarshe tana jaddada zaɓuɓɓuka da fa’idodinsu da rashin fa’idodinsu)
Samfurin ADR mai amfani da Planguage (ya fi karkata zuwa tabbatar da inganci)
Samfuri don muhimman shawarwarin fasaha (ITD) na Ignacio Larrañaga (ƙaranci kuma mai fara da shawara, an inganta shi don saurin bitar zartarwa)
Shawarwarin aiki tare na ADR
Idan kuna tunanin amfani da rikodin shawarwari tare da tawagarku, ga wasu shawarwari da muka koya ta yin aiki da tawagogi da yawa.
Kuna da damar jagorantar abokan tawagarku, ta hanyar tattaunawa tare game da “dalili”, maimakon tilasta “abin da”. Misali, rikodin shawarwari hanya ce ta tawagogi don yin tunani cikin hikima da sadarwa mafi kyau; rikodin shawarwari ba shi da amfani idan kawai buƙatar takardu ce ta tilas bayan abin ya riga ya faru.
Wasu tawagogi sun fi son suna “shawarwari” fiye da gajartar “ADR”. Lokacin da wasu tawagogi ke amfani da sunan kundin adireshi “decisions”, kamar fitila ta kunna ce, kuma tawagar ta fara saka ƙarin bayani a cikin kundin, kamar shawarwarin masu sayarwa, shawarwarin tsarawa, shawarwarin jadawali, da sauransu. Duk waɗannan nau’ikan bayani na iya amfani da samfuri ɗaya. Muna hasashen cewa mutane suna koyo da sauri da kalmomi (“shawarwari”) fiye da gajarta (“ADR”), kuma mutane suna da ƙwazo wajen rubuta takardun aiki mai gudana idan an cire kalmar “rikodi”, kuma wasu masu haɓakawa da wasu manajoji ba sa son kalmar “gine-gine”.
A ka’ida, rashin canzawa ya fi dacewa. A aikace, canzawa ya fi yin aiki ga tawagoginmu. Muna saka sabon bayani cikin ADR da ke akwai, tare da tambarin kwanan wata, da bayanin cewa bayanin ya zo bayan shawarar. Wannan hanya tana kaiwa ga “takarda mai rai” da dukanmu za mu iya sabuntawa. Sabuntawa na yau da kullum na faruwa lokacin da muka sami bayani saboda sababbin abokan tawaga, sababbin tayi, sakamakon amfaninmu na zahiri, ko sauye-sauyen wasu bayan shawarar kamar iyawar masu sayarwa, tsare-tsaren farashi, yarjejeniyoyin lasisi, da sauransu.
Tambayoyin aiki tare na ADR
Wa zai iya ƙirƙirar ADR?
Yi la’akari da fannoni kamar mutane na musamman, ko matsayi na musamman, ko tawagogi na musamman, ko sassa na musamman; kuma ku yi la’akari ko akwai mutane, ko matsayi, ko tawagogi, ko sassa da za su iya ba da umarnin ADR, wato su nemi ADR da wani na daban zai rubuta.
Misalin amsa: Duk wani mutum a ƙungiyarmu wanda ya karanta shafin README na rikodin shawarar gine-gine zai iya ba da shawarar ADR, wato mutumin zai iya fara rubuta shi, ya raba shi da tawaga.
Me ke tabbatar da buƙatar ɗaga ADR?
Yi la’akari da fannoni kamar hanyoyin aikin tawagogin ƙungiyarku, tsarin tsarin manhajarku, daidaita aiki tsakanin tawagogi, dorewar kulawa na dogon lokaci, hanyoyin sadarwa na waje, wanda kuke so ya amfana, da makamantansu.
Misalin amsa: Muna son ƙirƙirar ADR lokacin da muke son masu haɓakawa na nan gaba su fahimci “dalilin” abin da muke yi.
Me ke tabbatar da rashin ɗaga ADR?
Yi la’akari da fannoni kamar shawarwarin da ba su shafi gine-gine ba, ko ƙanana kamar masu ƙarancin haɗari ko masu cikakken kansu ko na mai haɓakawa ɗaya, ko waɗanda aka riga aka rufe su sosai a wani wuri kamar ƙa’idoji ko manufofi ko takardu, ko na ɗan lokaci kamar mafita na ɗan lokaci ko shaidar ra’ayi ko gwaje-gwaje.
Misalin amsa: Muna son tsallake ADR lokacin da shawara ta iyakance a fanni da lokaci da haɗari da kuɗi, ko kuma an riga an rufe ta a wani wuri.
Menene zagayen rayuwar ADR?
Yi la’akari da fannoni kamar tsarin ƙirƙira, tsarin bincike, tsarin yanke shawara, tsarin aiwatarwa, da tsarin ƙarewa. Yi la’akari da yadda za a bi diddigin zagayen rayuwar ADR a kan lokaci, misali yadda za a motsa ADR daga wani yanayi zuwa na gaba, da kuma yadda za a sanar da masu ruwa da tsaki wannan.
Misalin amsa: Muna son ADR ya kasance yana da matakai biyar na zagayen rayuwa: Farawa → Bincike → Kimantawa → Aiwatarwa → Kulawa → Ƙarewa.
Menene ma’aunin matakan zagayen rayuwar ADR?
Yi la’akari da fannoni kamar ma’aunin karɓa na ADR, wato ta yaya za ku san ya isa ya ci gaba daga mataki ɗaya na zagayen rayuwa zuwa na gaba? An bayyana matsalar a fili? An yi la’akari da madadin? An fahimci musanyar fa’ida da rashin fa’ida kuma an rubuta su yadda ya kamata? Dukkan mahallin da ya dace yana nan? Dukkan masu ruwa da tsaki da suka dace suna ciki? An haɗa dukkan ra’ayoyi?
Misalin amsa: Muna son masu ruwa da tsaki su kaɗa ƙuri’a kan ADR lokacin da tawagar mai aiki ta 1) kammala bincikenta, 2) kammala kimantawarta, 3) ta buga shawarar ADR ga masu ruwa da tsaki tare da buƙatar ra’ayoyi da iyakar lokaci na mako ɗaya, 4) an haɗa dukkan ra’ayoyin masu ruwa da tsaki kuma an magance su.
Waɗanne matsayi da nauyi ne ke hulɗa da ADR?
Yi la’akari da matsayi kamar mai ba da shawara, mai bincike, mai kimantawa, mai bita, mai amincewa, mai kulawa, da makamantansu. Yi la’akari da nauyi kamar sadarwa da masu ruwa da tsaki, tabbatar da cika buri, raba a gidan yanar gizo ko intranet, da bitar aikin lokaci-lokaci musamman lokacin da canje-canje masu dacewa suka faru.
Misalin amsa: Muna son kowane ADR ya kasance yana da mutum na farko na tuntuɓa, mutum na biyu na tuntuɓa, da tawagar mai alhaki; waɗannan suna da alhakin sadarwa, wallafawa, kulawa, bita lokaci-lokaci aƙalla sau ɗaya a shekara, da ƙarshe ƙarewa idan an buƙata.
Ta yaya mulki ke hulɗa da ADR?
Yi la’akari da fannoni kamar hanyoyin aikin ƙungiyarku, duk wasu buƙatun bin ƙa’ida na musamman kamar na shari’a ko albarkatun ɗan adam, yadda kuke son magance yarjejeniya da rikici da ɗaga batu zuwa sama. Akwai fannoni ko mutane ko tawagogi da za su iya samun tasiri fiye da sauran game da ADR, kamar samun damar amincewa da shi, ko kaɗa ƙuri’a a kansa, ko hana shi?
Misalin amsa: Mulkin ADR yana cikin wannan jerin fifiko: CEO, CTO, CLO, tawagar da ke aiwatar da ADR, ƙwararrun tawagar da suka fi sanin AD. Babu wani da ke da mulki sai dai idan an bayyana a cikin ADR.
Waɗanne ƙa’idoji ne ke hulɗa da ADR?
Yi la’akari da fannoni kamar hanyoyin aikin ƙungiyarku waɗanda suka haɗa da tafiya da sauri da tafiya a hankali, yarjejeniyar shawara da rikicin shawara, fifikon haɗari da fifikon aminci, tattaunawar jama’a da tattaunawar sirri, da makamantansu.
Misalin amsa: Muna amfani da ƙa’idojin jagoranci na son aiki, rashin yarda-amma-a-yi, kiyasin 70% sun isa ga shawarwari masu sauƙin sakewa da sauƙin keɓewa, da hanyoyin aiki na jama’a ban da bayanan sirri kamar yadda aka bayyana a yarjejeniyar sirri ta ƙungiyarmu.
Ra’ayoyin mataki na gaba don ADR
Arc42 yana amsa tambayoyi biyu ta hanya mai amfani kuma ana iya daidaita shi da takamaiman buƙatunku. Me ya kamata ku rubuta/sadar game da gine-ginenku? Yaya ya kamata ku rubuta/sadar da shi? Arc42 ya haɗa da jagora kan manufofi, ƙuntatawa, mahalli, inganci, haɗari da ƙari, ban da rikodin shawarar gine-gine.
Samfurin C4 hanya ce mai sauƙin koyo, mai dacewa da masu haɓakawa, ta zana zane-zanen gine-ginen manhaja. C4 tarin zane-zane ne na matsayi don mahalli, kwantena, ɓangarori, lamba, tare da zane-zane na taimako don yanayin tsari, motsi, da ɗora tsari.
Zane-zanen gine-gine, ra’ayoyi, da mahangogi
Zanen gine-gine ana kiransa “ra’ayin gine-gine”.
“Ra’ayin gine-gine” misali ne na “mahangar gine-gine”.
“Mahangar gine-gine” tana da takamaiman masu sauraro waɗanda ke da takamaiman damuwa a zuciya.
Misalan mahangogin gine-gine, misalan ra’ayoyi, da misalan zane-zane:
Iyawar Kasuwanci (Business Capabilities)
Hanyoyin kasuwanci na matakin sama
Ayyukan manhaja da aka yi wa taswira zuwa ɓangarorin aikace-aikace
Zanen mahalli na samfurin C4 (TO-BE / AS-IS)
Zanen kwantena na samfurin C4 (TO-BE / AS-IS)
Zanen alaƙar-ƙungiya (ERD) don yin taswirar ƙungiyoyin bayanai zuwa ɓangarorin aikace-aikace
Zane-zanen jerin (Sequence diagrams) don bayyana kwararar aiki a cikin tsarukan da kuma don haɗewa
Zane-zanen Business Process Model and Notation (BPMN) don bayyana kwararar bayanai a cikin ɓangarorin aikace-aikace
Zane-zanen Business Process Model and Notation (BPMN) don bayyana hanyoyin kasuwanci / yanayin masu amfani
Zane-zanen Gudanar da Ainihi da Samun Dama (Identity and Access Management) (IAM)
Zane-zanen Ikon Samun Dama bisa Matsayi (Role-Based Access Control) (RBAC) tare da matsayi ga kowane ɓangaren aikace-aikace
Zane-zanen Ikon Samun Dama bisa Hali (Attribute-Based Access Control) (ABAC) tare da halaye ga kowane ɓangaren aikace-aikace
Zane-zanen sirri
Zane-zane masu alaƙa:
Zanen Yanayin Amfani (Use Case Diagram) yana nuna wa gudanarwa/abokan ciniki yanayin amfani, wanda ke zuwa kafin buƙatu, wanda ke zuwa kafin gine-ginen manhaja.
Zanen Ɗora Tsari (Deployment Diagram) yana nuna kayan aiki/kwamfutoci na zahiri da ake ɗora ɓangarorin manhaja a kansu.
Zanen Kwararar Bayanai (Data Flow Diagram) yana nuna yadda bayanai ke wucewa da canzawa ta tsarin.
Zanen Jerin (Sequence Diagram) ana amfani da shi don nuna yadda ƙa’idodin sadarwa kamar HTTP ke aiki a kan axis na lokaci.
Zanen Ayyuka (Activity Diagram) yana nuna kwararar ayyukan da tsarin manhaja ke aiwatarwa, kamar NPC AI.
Ayyukan lafiya na shawarwari a matsayin lamba
Ayyukan lafiya (fitness functions) bincike ne na atomatik mai manufa wanda aka rubuta da lambar shirye-shirye, wanda ke tabbatar da cewa ana kiyaye shawarwari.
Ayyukan lafiya suna sa shawarwari su zama masu gwaji da tabbatarwa.
Ayyukan lafiya na shawarwari na iya taimakawa sosai wajen tabbatar da inganci, tsarin ƙa’idoji, da manufofin mulki.
Yadda ayyukan lafiya ke haɗuwa da shawarwari
Rikodin shawara yana rubuta shawarar, yayin da aikin lafiya ke tabbatar da ita.
Misalin shawara: Muna amfani da event sourcing don buƙatun bincike.
Misalin aikin lafiya: Muna amfani da sabar haɗewa ta ci gaba don gwada cewa duk canje-canjen yanayi dole ne su samar da abubuwan da suka faru.
Dalilin da ya sa ayyukan lafiya ke taimakon shawarwari
Ma’auni masu manufa: Ayyukan lafiya suna ci ko faɗuwa, don haka aiki yana bayyane kuma a fili.
Amfani mai ci gaba: Ayyukan lafiya ƙa’idojinku ne masu rai, waɗanda ake gudanarwa a kowane commit da build.
Kwarin gwiwa don sake tsarawa: Ayyukan lafiya suna kama kurakuran ƙa’idar shawara ta atomatik.
Mulki mai faɗaɗa: Ayyukan lafiya suna tabbatar da ƙa’idodi ba tare da ƙirƙirar cikas ba.
Shin ayyukan lafiya za su iya amfani da AI?
Ayyukan lafiya za su iya amfani da AI LLM don shawarwari ta yin tambayoyi game da aikinku, kamar tsare-tsarenku, lambarku, tsare-tsaren bayanai, API, da ƙari:
IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning.
IMPORTANT: Turn on extended thinking. Turn on expert advice. Turn on search.
This is a fitness function to evaluate if our work is
using all our decisions, and is correct and accurate.
- Our decisions are here: {url}
- Our work to evaluate is here: {url}
Explain any errors, problems, gaps, weaknesses. Be direct. Be decisive.
Gwajin raka’o’in gine-gine
ArchUnit: duba ƙa’idojin gine-gine na lambar Java ta amfani da kowane tsarin gwajin raka’a na Java na yau da kullum.
ArchUnitTS: duba ƙa’idojin gine-gine na lambar TypeScript da lambar JavaScript ta amfani da Jest, Vitest, Jasmine, da sauransu.
Shingen shawara don pull requests
Decision Guardian yana fito da rikodin shawara da ya dace ta atomatik a daidai lokacin — lokacin da mai haɓakawa ke canza lambar da waɗannan shawarwari suka rufe. Maimakon fatan masu haɓakawa su karanta kundin takardu kafin haɗawa, mahallin da ya dace yana bayyana kai tsaye a pull request.
Yana aiki ga kowane nau’in rikodin shawara: shawarwarin gine-gine, shawarwarin bayanai, shawarwarin bin ƙa’ida, shawarwarin asibiti da likitanci, shawarwarin tsaro, da ƙari.
Yana aiki da kowane tsarin CI (GitLab, Jenkins, CircleCI) da kuma a matsayin pre-commit hook. Buɗaɗɗen tushe. Lasisin MIT.
ADR Guard GitHub
Action ne wanda ke sa pull request ya gaza lokacin da hanyar lamba da ake sa ido a kanta ta canza
kuma ba a ƙara ko sabunta rikodin shawarar gine-gine ba. Keɓancewa a bayyane suke: layin
ADR-Exempt: tare da dalili yana barin shinge ya wuce kuma ana rubuta shi a taƙaitaccen aikin.
Ba ya dogara da samfuri, babu dogaro. Buɗaɗɗen tushe. Lasisin MIT.
Don ƙarin bayani
Gabatarwa:
Samfura:
Documenting architecture decisions - Michael Nygard (thinkrelevance.com)
Template for documenting architecture alternatives and decisions (stackoverflow.com)
Cikin zurfi:
The Decision View's Role in Software Architecture Practice (computer.org)
Documenting Software Architectures: Views and Beyond (resources.sei.cmu.edu)
Architecture Decisions: Demystifying Architecture (utdallas.edu)
ThoughtWorks Technology Radar: Lightweight Architecture Decision Records (thoughtworks.com)
A Skeptic’s Guide to Software Architecture Decisions (infoq.com)
Architectural Retrospectives: the Key to Getting Better at Architecting
Software Architecture Monday with Mark Richards - darasin gine-ginen manhaja na wata-wata kyauta
"Keep the Why: Code Becomes Legacy When Nobody Remembers Why"
Kayan aiki:
Command-line tools for working with Architecture Decision Records
kgai - append-only decision log for AI coding agents, a machine-readable companion to ADR files
Jagora na musamman ga kamfani:
Misalai:
Bidiyo:
Podcast:
Littattafai:
Software Architecture in Practice (SEI Series in Software Engineering)
Documenting Software Architectures: Views and Beyond (SEI Series in Software Engineering)
The Software Architect Elevator: Redefining the Architect's Role in the Digital Enterprise
Fundamentals of Software Architecture: An Engineering Approach - by Mark Richards and Neal Ford
Building Evolutionary Architectures - by Neal Ford, Rebecca Parsons, Patrick Kua, Pramod Sadalage
Foundations of Decision Analysis by Ronald Howard and Ali Abbas
Head First Software Architecture - by Raju Gandhi, Neal Ford and Mark Richards
Communication Patterns: A Guide for Developers and Architects - by Jacqui Read
Duba kuma:
REMAP (Representation and Maintenance of Process Knowledge)
DRL (Decision Representation Language)
IBIS (Issue-Based Information System)
QOC (Questions, Options, and Criteria)
IBM’s e-Business Reference Architecture Framework
Decision Reasoning Format (DRF) - Tsarin YAML/JSON mara sha’awar mai sayarwa, wanda injin zai iya karantawa, don wakiltar shawarwari tare da bayyananne dalili, zato, yanayin fahimta, da musanyar fa’ida. Yana cika ADR ta ƙara tunani mai tsari, mai iya tabbatarwa a takardun shawara.