arc42 నిర్ణయ రికార్డు మూస

https://arc42.org/overview

1. పరిచయం, లక్ష్యాలు

అవసరాల సంక్షిప్త వివరణ, చోదక శక్తులు, అవసరాల సారాంశం (లేదా సంక్షిప్తసారం). ప్రధాన భాగస్వాములకు అత్యధిక ప్రాధాన్యత ఉన్న ఆర్కిటెక్చర్ యొక్క మొదటి మూడు (గరిష్ఠంగా ఐదు) నాణ్యతా లక్ష్యాలు. ఆర్కిటెక్చర్ గురించి వారి అంచనాలతో కూడిన ముఖ్యమైన భాగస్వాముల పట్టిక.

1.1 అవసరాల అవలోకనం

విషయాలు

ఫంక్షనల్ అవసరాల సంక్షిప్త వివరణ, చోదక శక్తులు, అవసరాల సారాంశం (లేదా సంక్షిప్తసారం). (ఉన్నాయని ఆశిస్తున్న) అవసరాల పత్రాలకు లింకులు, వాటిని ఎక్కడ కనుగొనాలనే సమాచారంతో.

ప్రేరణ

తుది వినియోగదారుల దృష్టికోణం నుండి, ఒక వ్యాపార కార్యకలాపానికి మద్దతును మెరుగుపరచడానికి మరియు/లేదా నాణ్యతను మెరుగుపరచడానికి ఒక వ్యవస్థను సృష్టిస్తారు లేదా మారుస్తారు.

రూపం

సంక్షిప్త పాఠ్య వివరణ, బహుశా పట్టిక రూపంలోని వినియోగ సందర్భ ఫార్మాట్లో. అవసరాల పత్రాలు ఉంటే, ఈ అవలోకనం ఆ పత్రాలను సూచించాలి.

ఈ సారాంశాలను వీలైనంత చిన్నగా ఉంచండి. ఈ పత్రం చదవడానికి సులభత, అవసరాల పత్రాలకు సంబంధించి సంభావ్య పునరుక్తి మధ్య సమతుల్యత పాటించండి.

1.2 నాణ్యతా లక్ష్యాలు

విషయం

ప్రధాన భాగస్వాములకు నెరవేరడం అత్యంత ముఖ్యమైన, ఆర్కిటెక్చర్ యొక్క మొదటి మూడు (గరిష్ఠంగా ఐదు) నాణ్యతా లక్ష్యాలు. మేము నిజంగా ఆర్కిటెక్చర్ నాణ్యతా లక్ష్యాలనే అర్థం. వాటిని ప్రాజెక్ట్ లక్ష్యాలతో కలపకండి. అవి తప్పనిసరిగా ఒకేలా ఉండవు. ISO 25010 ప్రమాణం ఆసక్తికరమైన సంభావ్య అంశాల చక్కని అవలోకనాన్ని అందిస్తుంది.

ప్రేరణ

మీ అత్యంత ముఖ్యమైన భాగస్వాముల నాణ్యతా లక్ష్యాలు మీకు తెలిసి ఉండాలి, ఎందుకంటే అవి ప్రాథమిక ఆర్కిటెక్చర్ నిర్ణయాలను ప్రభావితం చేస్తాయి. ఈ నాణ్యతల గురించి చాలా నిర్దిష్టంగా ఉండండి, ఆడంబర పదాలను నివారించండి. ఆర్కిటెక్ట్గా మీ పని నాణ్యతను ఎలా నిర్ణయిస్తారో మీకు తెలియకపోతే …

రూపం

అత్యంత ముఖ్యమైన నాణ్యతా లక్ష్యాలు, నిర్దిష్ట దృశ్యాలతో కూడిన పట్టిక, ప్రాధాన్యతల క్రమంలో.

1.3 భాగస్వాములు

విషయం

వ్యవస్థ భాగస్వాముల స్పష్టమైన అవలోకనం, అంటే ఈ క్రింది వ్యక్తులు, పాత్రలు లేదా సంస్థలందరూ

• ఆర్కిటెక్చర్ తెలుసుకోవాలి

• ఆర్కిటెక్చర్ గురించి ఒప్పించబడాలి

• ఆర్కిటెక్చర్తో లేదా కోడ్తో పని చేయాలి

• తమ పనికి ఆర్కిటెక్చర్ డాక్యుమెంటేషన్ అవసరం

• వ్యవస్థ లేదా దాని అభివృద్ధి గురించి నిర్ణయాలు తీసుకోవాలి

ప్రేరణ

వ్యవస్థ అభివృద్ధిలో పాల్గొన్న లేదా వ్యవస్థ వల్ల ప్రభావితమైన అన్ని పక్షాలు మీకు తెలిసి ఉండాలి. లేకపోతే, అభివృద్ధి ప్రక్రియలో తర్వాత అసహ్యకరమైన ఆశ్చర్యాలు ఎదురుకావచ్చు. ఈ భాగస్వాములు మీ పని, దాని ఫలితాల పరిధిని, వివరాల స్థాయిని నిర్ణయిస్తారు.

రూపం

పాత్రల పేర్లు, వ్యక్తుల పేర్లు, ఆర్కిటెక్చర్, దాని డాక్యుమెంటేషన్ విషయంలో వారి అంచనాలతో కూడిన పట్టిక.

2. పరిమితులు

డిజైన్, అమలు నిర్ణయాలలో లేదా సంబంధిత ప్రక్రియల గురించిన నిర్ణయాలలో బృందాలను పరిమితం చేసే ఏదైనా. కొన్నిసార్లు వ్యక్తిగత వ్యవస్థలను దాటి, మొత్తం సంస్థలకు, కంపెనీలకు వర్తిస్తాయి.

విషయం

డిజైన్, అమలు నిర్ణయాలలో లేదా అభివృద్ధి ప్రక్రియ గురించిన నిర్ణయంలో సాఫ్ట్వేర్ ఆర్కిటెక్టుల స్వేచ్ఛను పరిమితం చేసే ఏదైనా అవసరం. ఈ పరిమితులు కొన్నిసార్లు వ్యక్తిగత వ్యవస్థలను దాటి, మొత్తం సంస్థలకు, కంపెనీలకు వర్తిస్తాయి.

ప్రేరణ

ఆర్కిటెక్టులు తమ డిజైన్ నిర్ణయాలలో ఎక్కడ స్వేచ్ఛగా ఉన్నారో, ఎక్కడ పరిమితులకు కట్టుబడి ఉండాలో కచ్చితంగా తెలుసుకోవాలి. పరిమితులను ఎల్లప్పుడూ ఎదుర్కోవాలి; అయితే అవి చర్చించదగినవి కావచ్చు.

రూపం

వివరణలతో కూడిన పరిమితుల సరళమైన పట్టికలు. అవసరమైతే, వాటిని సాంకేతిక పరిమితులు, సంస్థాగత, రాజకీయ పరిమితులు, సంప్రదాయాలు (ఉదా. ప్రోగ్రామింగ్ లేదా వెర్షనింగ్ మార్గదర్శకాలు, డాక్యుమెంటేషన్ లేదా పేరు పెట్టే సంప్రదాయాలు) గా ఉపవిభజించవచ్చు

3. సందర్భం, పరిధి

మీ వ్యవస్థను దాని (బాహ్య) సంభాషణ భాగస్వాముల నుండి (పొరుగు వ్యవస్థలు, వినియోగదారులు) వేరు చేస్తుంది. బాహ్య ఇంటర్ఫేస్లను నిర్దేశిస్తుంది. వ్యాపార/డొమైన్ దృక్కోణం నుండి (ఎల్లప్పుడూ) లేదా సాంకేతిక దృక్కోణం నుండి (ఐచ్ఛికం) చూపబడుతుంది

విషయం

వ్యవస్థ పరిధి, సందర్భం - పేరు సూచించినట్లు - మీ వ్యవస్థను (అంటే మీ పరిధిని) దాని సంభాషణ భాగస్వాములందరి నుండి (పొరుగు వ్యవస్థలు, వినియోగదారులు, అంటే మీ వ్యవస్థ సందర్భం) వేరు చేస్తుంది. దీని ద్వారా అది బాహ్య ఇంటర్ఫేస్లను నిర్దేశిస్తుంది.

అవసరమైతే, వ్యాపార సందర్భాన్ని (డొమైన్-నిర్దిష్ట ఇన్పుట్లు, అవుట్పుట్లు) సాంకేతిక సందర్భం (ఛానెళ్లు, ప్రోటోకాల్లు, హార్డ్వేర్) నుండి వేరు చేయండి.

ప్రేరణ

సంభాషణ భాగస్వాములతో డొమైన్ ఇంటర్ఫేస్లు, సాంకేతిక ఇంటర్ఫేస్లు మీ వ్యవస్థలోని అత్యంత కీలకమైన అంశాలలో ఉన్నాయి. వాటిని మీరు పూర్తిగా అర్థం చేసుకున్నారని నిర్ధారించుకోండి.

రూపం

• వివిధ సందర్భ రేఖాచిత్రాలు

• సంభాషణ భాగస్వాముల, వారి ఇంటర్ఫేస్ల జాబితాలు.

3.1 వ్యాపార సందర్భం

విషయం

డొమైన్-నిర్దిష్ట ఇన్పుట్లు, అవుట్పుట్లు లేదా ఇంటర్ఫేస్ల వివరణలతో సహా అన్ని సంభాషణ భాగస్వాముల (వినియోగదారులు, IT వ్యవస్థలు, …) నిర్దేశం. ఐచ్ఛికంగా డొమైన్-నిర్దిష్ట ఫార్మాట్లను లేదా సంభాషణ ప్రోటోకాల్లను జోడించవచ్చు.

ప్రేరణ

వ్యవస్థ పర్యావరణంతో ఏ డేటా మార్పిడి అవుతుందో భాగస్వాములందరూ అర్థం చేసుకోవాలి.

రూపం

వ్యవస్థను బ్లాక్ బాక్స్గా చూపి, సంభాషణ భాగస్వాములతో డొమైన్ ఇంటర్ఫేస్లను నిర్దేశించే అన్ని రకాల రేఖాచిత్రాలు.

ప్రత్యామ్నాయంగా (లేదా అదనంగా) పట్టికను వాడవచ్చు. పట్టిక శీర్షిక మీ వ్యవస్థ పేరు, మూడు నిలువు వరుసల్లో సంభాషణ భాగస్వామి పేరు, ఇన్పుట్లు, అవుట్పుట్లు ఉంటాయి.

3.2 సాంకేతిక సందర్భం

విషయాలు

మీ వ్యవస్థను దాని పర్యావరణంతో అనుసంధానించే సాంకేతిక ఇంటర్ఫేస్లు (ఛానెళ్లు, ప్రసార మాధ్యమాలు). అదనంగా డొమైన్-నిర్దిష్ట ఇన్పుట్/అవుట్పుట్ను ఛానెళ్లకు మ్యాపింగ్ చేయడం, అంటే ఏ I/O ఏ ఛానెల్ను వాడుతుందో వివరణ.

ప్రేరణ

అనేక భాగస్వాములు వ్యవస్థకు, దాని సందర్భానికి మధ్య ఉన్న సాంకేతిక ఇంటర్ఫేస్ల ఆధారంగా ఆర్కిటెక్చర్ నిర్ణయాలు తీసుకుంటారు. ముఖ్యంగా ఇన్ఫ్రాస్ట్రక్చర్ లేదా హార్డ్వేర్ డిజైనర్లు ఈ సాంకేతిక ఇంటర్ఫేస్లను నిర్ణయిస్తారు.

రూపం

ఉదా. పొరుగు వ్యవస్థలకు ఛానెళ్లను వివరించే UML డిప్లాయ్మెంట్ రేఖాచిత్రం, ఛానెళ్లకు, ఇన్పుట్/అవుట్పుట్కు మధ్య సంబంధాలను చూపే మ్యాపింగ్ పట్టికతో కలిపి.

4. పరిష్కార వ్యూహం

ఆర్కిటెక్చర్ను తీర్చిదిద్దే ప్రాథమిక నిర్ణయాలు, పరిష్కార వ్యూహాల సారాంశం. సాంకేతికత, అగ్రస్థాయి విభజన, అగ్ర నాణ్యతా లక్ష్యాలను సాధించే విధానాలు, సంబంధిత సంస్థాగత నిర్ణయాలను చేర్చవచ్చు.

విషయాలు

వ్యవస్థ ఆర్కిటెక్చర్ను తీర్చిదిద్దే ప్రాథమిక నిర్ణయాలు, పరిష్కార వ్యూహాల సంక్షిప్త సారాంశం, వివరణ. వీటిలో ఇవి ఉంటాయి

• సాంకేతికత నిర్ణయాలు

• వ్యవస్థ అగ్రస్థాయి విభజన గురించి నిర్ణయాలు, ఉదా. ఆర్కిటెక్చర్ నమూనా లేదా డిజైన్ నమూనా వాడకం

• కీలక నాణ్యతా లక్ష్యాలను ఎలా సాధించాలనే నిర్ణయాలు

• సంబంధిత సంస్థాగత నిర్ణయాలు, ఉదా. అభివృద్ధి ప్రక్రియను ఎంచుకోవడం లేదా కొన్ని పనులను మూడవ పక్షాలకు అప్పగించడం.

ప్రేరణ

ఈ నిర్ణయాలు మీ ఆర్కిటెక్చర్కు మూలస్తంభాలు. ఇవి అనేక ఇతర వివరణాత్మక నిర్ణయాలకు లేదా అమలు నియమాలకు ఆధారం.

రూపం

ఈ కీలక నిర్ణయాల వివరణను చిన్నగా ఉంచండి.

మీ సమస్య ప్రకటన, నాణ్యతా లక్ష్యాలు, కీలక పరిమితుల ఆధారంగా మీరు ఏమి నిర్ణయించారో, ఎందుకు ఆ విధంగా నిర్ణయించారో వివరించండి. వివరాల కోసం తదుపరి విభాగాలను చూడండి (నిర్మాణ వివరాలకు విభాగం 5, క్రాస్కటింగ్ భావనలకు విభాగం 8).

మీరు పరిష్కార విధానాల జాబితాను లేదా పట్టికను వాడవచ్చు.

5. బిల్డింగ్ బ్లాక్ వీక్షణ

వ్యవస్థ యొక్క స్థిర విభజన, సోర్స్ కోడ్ యొక్క నైరూప్యాలు, తగిన వివరాల స్థాయి వరకు వైట్ బాక్సుల (బ్లాక్ బాక్సులను కలిగి ఉన్న) శ్రేణిగా చూపబడతాయి.

విషయం

బిల్డింగ్ బ్లాక్ వీక్షణ వ్యవస్థను బిల్డింగ్ బ్లాక్లుగా (మాడ్యూళ్లు, కాంపోనెంట్లు, ఉపవ్యవస్థలు, క్లాసులు, ఇంటర్ఫేస్లు, ప్యాకేజీలు, లైబ్రరీలు, ఫ్రేమ్వర్క్లు, లేయర్లు, విభజనలు, టియర్లు, ఫంక్షన్లు, మాక్రోలు, ఆపరేషన్లు, డేటా నిర్మాణాలు, …) స్థిరంగా విభజించడాన్ని, అలాగే వాటి ఆధారితాలను (సంబంధాలు, అనుబంధాలు, …) చూపుతుంది

ప్రతి ఆర్కిటెక్చర్ డాక్యుమెంటేషన్కు ఈ వీక్షణ తప్పనిసరి. ఇల్లుతో పోలిస్తే ఇది నేల ప్రణాళిక.

ప్రేరణ

నైరూప్యం ద్వారా మీ సోర్స్ కోడ్ నిర్మాణాన్ని అర్థమయ్యేలా చేసి, దాని అవలోకనాన్ని కొనసాగించండి.

ఇది అమలు వివరాలను బయటపెట్టకుండా, నైరూప్య స్థాయిలో మీ భాగస్వాములతో సంభాషించడానికి వీలు కల్పిస్తుంది.

రూపం

బిల్డింగ్ బ్లాక్ వీక్షణ అనేది బ్లాక్ బాక్సులు, వైట్ బాక్సుల (క్రింది చిత్రం చూడండి) శ్రేణి సముదాయం, వాటి వివరణలతో.

5.1 మొత్తం వ్యవస్థ వైట్బాక్స్

ఇక్కడ మీరు ఈ క్రింది వైట్ బాక్స్ మూసను వాడి మొత్తం వ్యవస్థ విభజనను వివరిస్తారు. ఇందులో ఇవి ఉంటాయి

• ఒక అవలోకన రేఖాచిత్రం

• విభజనకు ఒక ప్రేరణ

• ఉన్న బిల్డింగ్ బ్లాక్ల బ్లాక్ బాక్స్ వివరణలు. వీటికి మేము ప్రత్యామ్నాయాలను అందిస్తున్నాం:

  • ఉన్న అన్ని బిల్డింగ్ బ్లాక్లు, వాటి ఇంటర్ఫేస్ల సంక్షిప్త, ఆచరణాత్మక అవలోకనం కోసం ఒక పట్టికను వాడండి

  • బ్లాక్ బాక్స్ మూస (క్రింద చూడండి) ప్రకారం బిల్డింగ్ బ్లాక్ల బ్లాక్ బాక్స్ వివరణల జాబితాను వాడండి. మీరు ఎంచుకున్న సాధనాన్ని బట్టి ఈ జాబితా ఉప-అధ్యాయాలు (టెక్స్ట్ ఫైళ్లలో), ఉప-పేజీలు (వికీలో) లేదా పొదిగిన మూలకాలు (మోడలింగ్ సాధనంలో) కావచ్చు.

  • (ఐచ్ఛికం:) బిల్డింగ్ బ్లాక్ యొక్క బ్లాక్ బాక్స్ మూసలలో వివరించని, కానీ వైట్ బాక్స్ను అర్థం చేసుకోవడానికి చాలా ముఖ్యమైన ఇంటర్ఫేస్లు.

ఇంటర్ఫేస్లను నిర్దేశించడానికి చాలా మార్గాలు ఉన్నందున వాటికి ప్రత్యేక మూసను అందించడం లేదు.

ఉత్తమ సందర్భంలో, ఉదాహరణలు లేదా సరళమైన సిగ్నేచర్లతో సరిపోతుంది.

5.2 స్థాయి 2

ఇక్కడ మీరు స్థాయి 1లోని (కొన్ని) బిల్డింగ్ బ్లాక్ల అంతర్గత నిర్మాణాన్ని వైట్ బాక్సులుగా నిర్దేశించవచ్చు.

అంత వివరణాత్మక వర్ణనను సమర్థించేంత ముఖ్యమైన బిల్డింగ్ బ్లాక్లు మీ వ్యవస్థలో ఏవో మీరు నిర్ణయించుకోవాలి. దయచేసి సంపూర్ణత కంటే ప్రాసంగికతకు ప్రాధాన్యం ఇవ్వండి. ముఖ్యమైన, ఆశ్చర్యకరమైన, ప్రమాదకరమైన, సంక్లిష్టమైన లేదా అస్థిరమైన బిల్డింగ్ బ్లాక్లను నిర్దేశించండి. మీ వ్యవస్థలోని సాధారణ, సరళమైన, నీరసమైన లేదా ప్రామాణిక భాగాలను వదిలేయండి

5.2.1 బిల్డింగ్ బ్లాక్ 1 కోసం వైట్ బాక్స్

బిల్డింగ్ బ్లాక్ 1 అంతర్గత నిర్మాణాన్ని నిర్దేశిస్తుంది.

వైట్ బాక్స్ మూసను వాడండి (పైన చూడండి).

6. రన్టైమ్ వీక్షణ

బిల్డింగ్ బ్లాక్ల ప్రవర్తన దృశ్యాల రూపంలో, ముఖ్యమైన వినియోగ సందర్భాలు లేదా ఫీచర్లు, కీలక బాహ్య ఇంటర్ఫేస్ల వద్ద పరస్పర చర్యలు, నిర్వహణ, అడ్మినిస్ట్రేషన్, అలాగే లోపం, మినహాయింపు ప్రవర్తనను కవర్ చేస్తుంది.

విషయం

రన్టైమ్ వీక్షణ వ్యవస్థ బిల్డింగ్ బ్లాక్ల నిర్దిష్ట ప్రవర్తనను, పరస్పర చర్యలను ఈ క్రింది రంగాల దృశ్యాల రూపంలో వివరిస్తుంది:

• ముఖ్యమైన వినియోగ సందర్భాలు లేదా ఫీచర్లు: బిల్డింగ్ బ్లాక్లు వాటిని ఎలా అమలు చేస్తాయి?

• కీలక బాహ్య ఇంటర్ఫేస్ల వద్ద పరస్పర చర్యలు: బిల్డింగ్ బ్లాక్లు వినియోగదారులతో, పొరుగు వ్యవస్థలతో ఎలా సహకరిస్తాయి?

• నిర్వహణ, అడ్మినిస్ట్రేషన్: లాంచ్, స్టార్ట్-అప్, స్టాప్

• లోపం, మినహాయింపు దృశ్యాలు

వ్యాఖ్య: సాధ్యమైన దృశ్యాల (క్రమాలు, వర్క్ఫ్లోలు) ఎంపికకు ప్రధాన ప్రమాణం వాటి ఆర్కిటెక్చర్ ప్రాసంగికత. పెద్ద సంఖ్యలో దృశ్యాలను వివరించడం ముఖ్యం కాదు. బదులుగా ప్రాతినిధ్య ఎంపికను నమోదు చేయాలి.

ప్రేరణ

మీ వ్యవస్థ బిల్డింగ్ బ్లాక్ల (ఇన్స్టెన్స్ల) పని ఎలా చేస్తాయో, రన్టైమ్లో ఎలా సంభాషిస్తాయో మీరు అర్థం చేసుకోవాలి. స్థిర మోడళ్లను (బిల్డింగ్ బ్లాక్ వీక్షణ, డిప్లాయ్మెంట్ వీక్షణ) చదివి అర్థం చేసుకోవడానికి తక్కువ ఇష్టపడే లేదా సామర్థ్యం ఉన్న భాగస్వాములకు మీ ఆర్కిటెక్చర్ను తెలియజేయడానికి మీరు ప్రధానంగా మీ డాక్యుమెంటేషన్లో దృశ్యాలను నమోదు చేస్తారు.

రూపం

దృశ్యాలను వివరించడానికి అనేక సంకేత పద్ధతులు ఉన్నాయి, ఉదా.

• దశల సంఖ్యా జాబితా (సహజ భాషలో)

• కార్యకలాప రేఖాచిత్రాలు లేదా ఫ్లో చార్ట్లు

• సీక్వెన్స్ రేఖాచిత్రాలు

• BPMN లేదా EPCలు (ఈవెంట్ ప్రాసెస్ చైన్లు)

• స్టేట్ మెషీన్లు

• మొదలైనవి.

6.n రన్టైమ్ దృశ్యం n (1, 2, 3, మొదలైనవి)

రన్టైమ్ రేఖాచిత్రాన్ని లేదా దృశ్యం యొక్క పాఠ్య వివరణను చేర్చండి.

ఈ రేఖాచిత్రంలో చూపిన బిల్డింగ్ బ్లాక్ ఇన్స్టెన్స్ల మధ్య పరస్పర చర్యల గమనించదగిన అంశాల వివరణను చేర్చండి.

7. డిప్లాయ్మెంట్ వీక్షణ

వాతావరణాలు, కంప్యూటర్లు, ప్రాసెసర్లు, టోపాలజీలతో కూడిన సాంకేతిక ఇన్ఫ్రాస్ట్రక్చర్. (సాఫ్ట్వేర్) బిల్డింగ్ బ్లాక్లను ఇన్ఫ్రాస్ట్రక్చర్ మూలకాలకు మ్యాపింగ్ చేయడం.

విషయం

డిప్లాయ్మెంట్ వీక్షణ వివరించేవి:

• మీ వ్యవస్థను అమలు చేయడానికి వాడే సాంకేతిక ఇన్ఫ్రాస్ట్రక్చర్, భౌగోళిక స్థానాలు, వాతావరణాలు, కంప్యూటర్లు, ప్రాసెసర్లు, ఛానెళ్లు, నెట్ టోపాలజీల వంటి ఇన్ఫ్రాస్ట్రక్చర్ మూలకాలతో పాటు ఇతర ఇన్ఫ్రాస్ట్రక్చర్ మూలకాలతో, మరియు

• (సాఫ్ట్వేర్) బిల్డింగ్ బ్లాక్లను ఆ ఇన్ఫ్రాస్ట్రక్చర్ మూలకాలకు మ్యాపింగ్ చేయడం.

తరచుగా వ్యవస్థలు వేర్వేరు వాతావరణాలలో అమలు చేయబడతాయి, ఉదా. డెవలప్మెంట్ వాతావరణం, టెస్ట్ వాతావరణం, ప్రొడక్షన్ వాతావరణం. అలాంటి సందర్భాలలో మీరు సంబంధిత వాతావరణాలన్నింటినీ నమోదు చేయాలి.

మీ సాఫ్ట్వేర్ ఒకటి కంటే ఎక్కువ కంప్యూటర్, ప్రాసెసర్, సర్వర్ లేదా కంటైనర్తో పంపిణీ చేసిన వ్యవస్థగా అమలైనప్పుడు, లేదా మీరు మీ స్వంత హార్డ్వేర్ ప్రాసెసర్లను, చిప్లను డిజైన్ చేసి నిర్మించినప్పుడు డిప్లాయ్మెంట్ వీక్షణను ప్రత్యేకంగా నమోదు చేయండి.

సాఫ్ట్వేర్ దృక్కోణం నుండి, మీ బిల్డింగ్ బ్లాక్ల డిప్లాయ్మెంట్ను చూపడానికి అవసరమైన ఇన్ఫ్రాస్ట్రక్చర్ మూలకాలను నమోదు చేస్తే సరిపోతుంది. హార్డ్వేర్ ఆర్కిటెక్టులు అంతకుమించి వెళ్లి, తాము నమోదు చేయవలసిన ఏ వివరాల స్థాయి వరకైనా ఇన్ఫ్రాస్ట్రక్చర్ను వివరించవచ్చు.

ప్రేరణ

హార్డ్వేర్ లేకుండా సాఫ్ట్వేర్ నడవదు. ఈ అంతర్లీన ఇన్ఫ్రాస్ట్రక్చర్ మీ వ్యవస్థను మరియు/లేదా కొన్ని క్రాస్కటింగ్ భావనలను ప్రభావితం చేయగలదు, చేస్తుంది కూడా. కాబట్టి, మీకు ఇన్ఫ్రాస్ట్రక్చర్ తెలిసి ఉండాలి.

రూపం

బహుశా అత్యున్నత స్థాయి డిప్లాయ్మెంట్ రేఖాచిత్రం ఇప్పటికే 3.2 విభాగంలో సాంకేతిక సందర్భంగా, మీ స్వంత ఇన్ఫ్రాస్ట్రక్చర్ను ఒకే బ్లాక్ బాక్స్గా చూపుతూ ఉండవచ్చు. ఈ విభాగంలో మీరు అదనపు డిప్లాయ్మెంట్ రేఖాచిత్రాలను వాడి ఆ బ్లాక్ బాక్స్లోకి జూమ్ చేస్తారు.

• ఆ వీక్షణను వ్యక్తీకరించడానికి UML డిప్లాయ్మెంట్ రేఖాచిత్రాలను అందిస్తుంది. మీ ఇన్ఫ్రాస్ట్రక్చర్ మరింత సంక్లిష్టంగా ఉన్నప్పుడు బహుశా పొదిగిన రేఖాచిత్రాలతో దాన్ని వాడండి.

• మీ (హార్డ్వేర్) భాగస్వాములు UML డిప్లాయ్మెంట్ రేఖాచిత్రం కంటే ఇతర రకాల రేఖాచిత్రాలను ఇష్టపడితే, ఇన్ఫ్రాస్ట్రక్చర్ యొక్క నోడ్లను, ఛానెళ్లను చూపగల ఏ రకాన్నైనా వాడనివ్వండి.

7.1 ఇన్ఫ్రాస్ట్రక్చర్ స్థాయి 1

వివరించండి (సాధారణంగా రేఖాచిత్రాలు, పట్టికలు, పాఠ్యం కలయికలో):

• మీ వ్యవస్థను బహుళ స్థానాలు, వాతావరణాలు, కంప్యూటర్లు, ప్రాసెసర్లకు పంపిణీ చేయడం, అలాగే వాటి మధ్య భౌతిక అనుసంధానాలు

• ఈ డిప్లాయ్మెంట్ నిర్మాణానికి ముఖ్యమైన సమర్థన లేదా ప్రేరణ

• ఇన్ఫ్రాస్ట్రక్చర్ నాణ్యత మరియు/లేదా పనితీరు లక్షణాలు

• సాఫ్ట్వేర్ ఆర్టిఫాక్ట్లను (బిల్డింగ్ బ్లాక్లను) ఇన్ఫ్రాస్ట్రక్చర్ మూలకాలకు మ్యాపింగ్ చేయడం

బహుళ వాతావరణాలు లేదా ప్రత్యామ్నాయ డిప్లాయ్మెంట్ల కోసం, దయచేసి arc42 యొక్క ఆ విభాగాన్ని సంబంధిత వాతావరణాలన్నింటికీ కాపీ చేయండి. **

7.2 ఇన్ఫ్రాస్ట్రక్చర్ స్థాయి 2

ఇక్కడ మీరు ఇన్ఫ్రాస్ట్రక్చర్ స్థాయి 1 లోని (కొన్ని) ఇన్ఫ్రాస్ట్రక్చర్ మూలకాల అంతర్గత నిర్మాణాన్ని చేర్చవచ్చు.

దయచేసి ఎంచుకున్న ప్రతి మూలకానికి స్థాయి 1 నిర్మాణాన్ని కాపీ చేయండి.

8. క్రాస్కటింగ్ భావనలు

వ్యవస్థలోని అనేక భాగాలకు (→ క్రాస్-కటింగ్) సంబంధించిన మొత్తం, ప్రధాన నిబంధనలు, పరిష్కార విధానాలు. భావనలు తరచుగా అనేక బిల్డింగ్ బ్లాక్లకు సంబంధించి ఉంటాయి. డొమైన్ మోడళ్లు, ఆర్కిటెక్చర్ నమూనాలు, శైలులు, నిర్దిష్ట సాంకేతికత వాడకానికి నియమాలు, అమలు నియమాల వంటి విభిన్న అంశాలను చేర్చండి.

విషయం

ఈ విభాగం క్రాస్కటింగ్ భావనలను (ఆచరణలు, నమూనాలు, నిబంధనలు లేదా పరిష్కార ఆలోచనలు) వివరిస్తుంది. ఇలాంటి భావనలు తరచుగా అనేక బిల్డింగ్ బ్లాక్లకు సంబంధించి ఉంటాయి. అవి అనేక విభిన్న అంశాలను కలిగి ఉండవచ్చు.

ప్రేరణ

భావనలు ఆర్కిటెక్చర్ యొక్క భావనాత్మక సమగ్రతకు (స్థిరత్వం, సజాతీయత) ఆధారాన్ని ఏర్పరుస్తాయి. అందువల్ల, మీ వ్యవస్థ అంతర్గత నాణ్యతలను సాధించడానికి అవి ఒక ముఖ్యమైన తోడ్పాటు.

ఇలాంటి భావనల సమన్వయ నిర్దేశానికి మేము అందించిన మూసలోని స్థలం ఇదే.

ఈ భావనలలో చాలా వరకు మీ అనేక బిల్డింగ్ బ్లాక్లకు సంబంధించినవి లేదా వాటిని ప్రభావితం చేస్తాయి.

రూపం

రూపం వైవిధ్యంగా ఉండవచ్చు:

• ఏ రకమైన నిర్మాణంతోనైనా భావనా పత్రాలు

• ఉదాహరణ అమలులు, ముఖ్యంగా సాంకేతిక భావనలకు

• ఆర్కిటెక్చర్ వీక్షణల సంకేత పద్ధతులను వాడి క్రాస్-కటింగ్ మోడల్ సారాంశాలు లేదా దృశ్యాలు

ఈ విభాగం నిర్మాణం

మీ వ్యవస్థకు అత్యంత అవసరమైన అంశాలను మాత్రమే ఎంచుకుని, ప్రతిదానికి ఈ విభాగంలో స్థాయి-2 శీర్షికను కేటాయించండి (ఉదా. 8.1, 8.2 మొదలైనవి).

• పైన పేర్కొన్న రేఖాచిత్రంలోని అన్ని అంశాలను కవర్ చేయడానికి ప్రయత్నించకండి.

నేపథ్యం

వ్యవస్థలలోని కొన్ని అంశాలు తరచుగా అనేక బిల్డింగ్ బ్లాక్లకు, హార్డ్వేర్ మూలకాలకు లేదా అభివృద్ధి ప్రక్రియలకు సంబంధించి ఉంటాయి. సంబంధిత బిల్డింగ్ బ్లాక్లు, హార్డ్వేర్ మూలకాలు లేదా అభివృద్ధి ప్రక్రియల వివరణలో వాటిని పునరావృతం చేయడానికి బదులు, ఇలాంటి క్రాస్-కటింగ్ అంశాలను ఒక కేంద్ర స్థలంలో తెలియజేయడం లేదా నమోదు చేయడం సులభం కావచ్చు.

కొన్ని భావనలు వ్యవస్థలోని అన్ని మూలకాలకు సంబంధించవచ్చు, మరికొన్ని కొన్నింటికి మాత్రమే సంబంధితంగా ఉండవచ్చు.

9. ఆర్కిటెక్చర్ నిర్ణయాలు

హేతువులతో సహా ముఖ్యమైన, ఖరీదైన, కీలకమైన, పెద్ద స్థాయి లేదా ప్రమాదకరమైన ఆర్కిటెక్చర్ నిర్ణయాలు.

విషయం

హేతువులతో సహా ముఖ్యమైన, ఖరీదైన, పెద్ద స్థాయి లేదా ప్రమాదకరమైన ఆర్కిటెక్చర్ నిర్ణయాలు. "నిర్ణయాలు" అంటే ఇచ్చిన ప్రమాణాల ఆధారంగా ఒక ప్రత్యామ్నాయాన్ని ఎంచుకోవడం అని మా అర్థం.

ఆర్కిటెక్చర్ నిర్ణయాన్ని ఈ కేంద్ర విభాగంలో నమోదు చేయాలా, లేక స్థానికంగా (ఉదా. ఒక బిల్డింగ్ బ్లాక్ యొక్క వైట్ బాక్స్ మూసలో) నమోదు చేయడం మంచిదా అని నిర్ణయించడానికి మీ విచక్షణను వాడండి. అనవసరమైన పునరావృత పాఠ్యాన్ని నివారించండి. మీ ఆర్కిటెక్చర్ యొక్క అత్యంత ముఖ్యమైన నిర్ణయాలను మీరు ఇప్పటికే నమోదు చేసిన విభాగం 4ని చూడండి.

ప్రేరణ

మీ వ్యవస్థ భాగస్వాములు మీ నిర్ణయాలను అర్థం చేసుకుని, తిరిగి అనుసరించగలగాలి.

రూపం

• ప్రతి ముఖ్యమైన నిర్ణయానికి ADR (ఆర్కిటెక్చర్ నిర్ణయ రికార్డు)

• ప్రాముఖ్యత, పర్యవసానాల క్రమంలో జాబితా లేదా పట్టిక, లేదా

• ప్రతి నిర్ణయానికి వేర్వేరు విభాగాల రూపంలో మరింత వివరంగా

నేపథ్యం (ADRల గురించి)

చిన్న డాక్యుమెంటేషన్ ముక్కలు చదవడానికి, సృష్టించడానికి, నిర్వహించడానికి సులభం. ఆర్కిటెక్చర్ నిర్ణయాల విషయానికి వస్తే, డెవలప్మెంట్ బృందాలు తరచుగా:

• నిర్ణయం గురించి తెలుసుకుంటాయి, ఉదా. సోర్స్ కోడ్లో కనిపిస్తుంది కాబట్టి, కానీ

• ఆ నిర్ణయం వెనుక ఉన్న ప్రేరణను కోల్పోతాయి (Nygard 2011 చూడండి)

అందువల్ల మీరు కొన్ని ముఖ్యమైన నిర్ణయాలను వాటి ప్రేరణ, కారణంతో కలిపి నమోదు చేయాలి

నిర్ణయాలకు సంబంధించి మా ప్రతిపాదన

ఆర్కిటెక్చర్ పరంగా ముఖ్యమైన నిర్ణయాల సముదాయాన్ని ఉంచండి, అంటే నిర్మాణం, నాణ్యతా లక్షణాలు, ముఖ్యమైన (ముఖ్యంగా బాహ్య) ఆధారితాలు, ఇంటర్ఫేస్లు లేదా నిర్మాణ సాంకేతికతలను ప్రభావితం చేసే నిర్ణయాలు (ఈ ప్రతిపాదనకు Michael Nygard కు ధన్యవాదాలు).

10. నాణ్యతా అవసరాలు

ఉన్నత స్థాయి అవలోకనం అందించే నాణ్యతా వృక్షంతో, దృశ్యాల రూపంలో నాణ్యతా అవసరాలు. అత్యంత ముఖ్యమైన నాణ్యతా లక్ష్యాలను విభాగం 1.2 (నాణ్యతా లక్ష్యాలు) లో వివరించి ఉండాలి.

విషయం

ఈ విభాగం అన్ని సంబంధిత నాణ్యతా అవసరాలను కలిగి ఉంటుంది.

ఈ అవసరాలలో అత్యంత ముఖ్యమైనవి ఇప్పటికే విభాగం 1.2 (నాణ్యతా లక్ష్యాలు) లో వివరించబడ్డాయి, కాబట్టి ఇక్కడ వాటిని సూచించడం మాత్రమే చేయాలి. ఈ విభాగం 10లో, పూర్తిగా సాధించకపోయినా అధిక ప్రమాదాలు కలిగించని (కానీ ఉంటే బాగుండేవి) తక్కువ ప్రాముఖ్యత గల నాణ్యతా అవసరాలను కూడా నమోదు చేయాలి.

ప్రేరణ

నాణ్యతా అవసరాలు ఆర్కిటెక్చర్ నిర్ణయాలపై చాలా ప్రభావం చూపుతాయి కాబట్టి, మీ భాగస్వాములకు ఏ నాణ్యతలు నిజంగా ముఖ్యమో, నిర్దిష్టంగా, కొలవదగిన విధంగా మీరు తెలుసుకోవాలి.

మరింత సమాచారం

https://quality.arc42.org లోని విస్తృతమైన Q42 నాణ్యతా మోడల్ను చూడండి.

10.1 నాణ్యతా అవసరాల అవలోకనం

విషయం

నాణ్యతా అవసరాల అవలోకనం లేదా సారాంశం.

ప్రేరణ

తరచుగా మనకు డజన్ల కొద్దీ (లేదా వందల కొద్దీ) వివరణాత్మక నాణ్యతా అవసరాలు ఎదురవుతాయి. ఈ అవలోకన విభాగంలో మీరు వర్గాలను లేదా అంశాలను వివరించడం ద్వారా (ISO 25010:2023 లేదా Q42 సూచించినట్లు) సంక్షిప్తం చేయడానికి ప్రయత్నించాలి

ఈ సారాంశ వివరణలు ఇప్పటికే కచ్చితంగా, తగినంత నిర్దిష్టంగా, కొలవదగినవిగా ఉంటే, మీరు విభాగం 10.2 ను వదిలివేయవచ్చు.

రూపం

ప్రతి వరుసలో ఒక వర్గం లేదా అంశం, నాణ్యతా అవసరం యొక్క సంక్షిప్త వివరణ ఉండే సరళమైన పట్టికను వాడండి. ప్రత్యామ్నాయంగా, ఈ నాణ్యతా అవసరాలను నిర్మించడానికి మైండ్మ్యాప్ వాడవచ్చు.

సాహిత్యంలో, "నాణ్యత" అనే సాధారణ పదాన్ని మూలంగా ఉంచి, "నాణ్యత" పదాన్ని వృక్షం వంటి శుద్ధీకరణగా ఉపయోగించే నాణ్యతా లక్షణ వృక్షం అనే ఆలోచన కూడా వివరించబడింది. [Bass+21] ఈ ప్రయోజనం కోసం "Quality Attribute Utility Tree" అనే పదాన్ని ప్రవేశపెట్టారు.

10.2 నాణ్యతా దృశ్యాలు

విషయం

నాణ్యతా దృశ్యాలు నాణ్యతా అవసరాలను నిర్దిష్టంగా చేసి, అవి నెరవేరాయో లేదో (అంగీకార ప్రమాణాల అర్థంలో) నిర్ణయించడానికి వీలు కల్పిస్తాయి. మీ దృశ్యాలు నిర్దిష్టంగా, కొలవదగినవిగా ఉండేలా చూసుకోండి.

రెండు రకాల దృశ్యాలు ముఖ్యంగా ఉపయోగకరం:

• వినియోగ దృశ్యాలు (అనువర్తన దృశ్యాలు లేదా వినియోగ సందర్భ దృశ్యాలు అని కూడా అంటారు) ఒక నిర్దిష్ట ప్రేరకానికి వ్యవస్థ రన్టైమ్ ప్రతిస్పందనను వివరిస్తాయి. ఇందులో వ్యవస్థ సామర్థ్యాన్ని లేదా పనితీరును వివరించే దృశ్యాలు కూడా ఉంటాయి. ఉదాహరణ: వ్యవస్థ వినియోగదారు అభ్యర్థనకు ఒక సెకనులోపు ప్రతిస్పందిస్తుంది.

• మార్పు దృశ్యాలు వ్యవస్థ లేదా దాని తక్షణ పర్యావరణం యొక్క మార్పు లేదా పొడిగింపు కోరుకున్న ప్రభావాన్ని వివరిస్తాయి. ఉదాహరణ: అదనపు ఫంక్షనాలిటీ అమలు చేయబడుతుంది లేదా ఒక నాణ్యతా లక్షణం అవసరాలు మారతాయి, మార్పుకు పట్టిన శ్రమ లేదా వ్యవధిని కొలుస్తారు.

రూపం

వివరణాత్మక దృశ్యాల విలక్షణ సమాచారంలో ఇవి ఉంటాయి:

సంక్షిప్త రూపంలో (Q42 మోడల్లో ప్రాధాన్యత పొందినది):

• సందర్భం/నేపథ్యం: ఏ రకమైన వ్యవస్థ లేదా కాంపోనెంట్, పర్యావరణం లేదా పరిస్థితి ఏమిటి?

• మూలం/ప్రేరకం: ప్రవర్తనను, ప్రతిచర్యను లేదా చర్యను ఎవరు లేదా ఏది ప్రారంభిస్తుంది లేదా ప్రేరేపిస్తుంది.

• మెట్రిక్/అంగీకార ప్రమాణాలు: కొలత లేదా మెట్రిక్తో కూడిన ప్రతిస్పందన

దృశ్యాల దీర్ఘ రూపం (SEI, [Bass+21] ప్రాధాన్యత ఇచ్చేది) మరింత వివరణాత్మకం, ఈ సమాచారాన్ని కలిగి ఉంటుంది:

• దృశ్య ID: దృశ్యానికి ప్రత్యేక గుర్తింపు.

• దృశ్యం పేరు: దృశ్యానికి సంక్షిప్త, వివరణాత్మక పేరు.

• మూలం: దృశ్యాన్ని ప్రారంభించే సంస్థ (వినియోగదారు, వ్యవస్థ లేదా ఈవెంట్).

• ప్రేరకం: వ్యవస్థ పరిష్కరించాల్సిన ప్రేరేపించే ఈవెంట్ లేదా పరిస్థితి.

• పర్యావరణం: వ్యవస్థ ప్రేరకాన్ని అనుభవించే నిర్వహణ సందర్భం లేదా పరిస్థితి.

• ఆర్టిఫాక్ట్: ప్రేరకం వల్ల ప్రభావితమయ్యే వ్యవస్థ బిల్డింగ్ బ్లాక్లు లేదా ఇతర మూలకాలు.

• ప్రతిస్పందన: ప్రేరకానికి ప్రతిచర్యగా వ్యవస్థ చూపే ఫలితం లేదా ప్రవర్తన.

• ప్రతిస్పందన కొలత: వ్యవస్థ ప్రతిస్పందనను మూల్యాంకనం చేసే ప్రమాణం లేదా మెట్రిక్.

ఇవి కూడా చూడండి

జనవరి 2023 నుండి, arc42 ఒక ఆచరణాత్మక నాణ్యతా మోడల్ను అందిస్తోంది, ఇది నాణ్యతా అవసరాలకు #flexible, #efficient, #usable, #operable, #testable, #secure, #safe, #reliable వంటి హ్యాష్ట్యాగ్లు లేదా లేబుళ్లను పెట్టాలని ప్రతిపాదిస్తుంది.

11. ప్రమాదాలు, సాంకేతిక రుణం

తెలిసిన సాంకేతిక ప్రమాదాలు లేదా సాంకేతిక రుణం. వ్యవస్థలో లేదా దాని చుట్టూ ఎలాంటి సంభావ్య సమస్యలు ఉన్నాయి? డెవలప్మెంట్ బృందం ఏ విషయంలో దుఃఖపడుతోంది?

విషయం

గుర్తించిన సాంకేతిక ప్రమాదాలు లేదా సాంకేతిక రుణాల జాబితా, ప్రాధాన్యత క్రమంలో

ప్రేరణ

"ప్రమాద నిర్వహణ అనేది పెద్దల కోసం ప్రాజెక్ట్ నిర్వహణ" (Tim Lister, Atlantic Systems Guild.)

ఆర్కిటెక్చర్లో ప్రమాదాలను, సాంకేతిక రుణాలను క్రమబద్ధంగా గుర్తించి, మూల్యాంకనం చేయడానికి ఇది మీ నినాదం కావాలి, ఇవి మొత్తం ప్రమాద విశ్లేషణ, కొలత ప్రణాళికలో భాగంగా నిర్వహణ భాగస్వాములకు (ఉదా. ప్రాజెక్ట్ మేనేజర్లు, ప్రొడక్ట్ ఓనర్లు) అవసరమవుతాయి.

రూపం

ప్రమాదాలు మరియు/లేదా సాంకేతిక రుణాల జాబితా, బహుశా ప్రమాదాలను తగ్గించడానికి, ఉపశమనం కలిగించడానికి, నివారించడానికి లేదా సాంకేతిక రుణాలను తగ్గించడానికి సూచించిన చర్యలతో సహా.