কীভাবে এক সপ্তাহে 100,000 লাইন কোড পড়তে এবং ঠিক করবেন

শুরুতে একটি বড় এবং পুরানো প্রকল্প বোঝা সবসময় কঠিন। স্থাপত্য একটি স্থপতি মূল্যায়ন কার্যক্রম এক. সাধারণত আপনাকে বড়, পুরানো প্রকল্পগুলির সাথে কাজ করতে হবে এবং ফলাফলগুলি অবশ্যই এক সপ্তাহের মধ্যে সরবরাহ করতে হবে।

একটি সপ্তাহে 100k বা তার বেশি লাইনের কোডের একটি প্রকল্পকে কীভাবে মূল্যায়ন করা যায় যখন এখনও ফলাফল প্রদান করে যা ক্লায়েন্টের জন্য সত্যিই উপযোগী।

বেশিরভাগ স্থপতি এবং প্রযুক্তিগত লিড একই ধরনের প্রকল্প মূল্যায়নের সম্মুখীন হয়েছেন। এটি একটি আধা-আনুষ্ঠানিক প্রক্রিয়া বা আমাদের কোম্পানিতে করা একটি পৃথক পরিষেবা হিসাবে দেখাতে পারে, আপনার মধ্যে বেশিরভাগই এটিকে মোকাবেলা করেছেন।

আপনার অ-রাশিয়ানভাষী বন্ধুদের জন্য ইংরেজিতে আসলটি এখানে রয়েছে: এক সপ্তাহের মধ্যে স্থাপত্য মূল্যায়ন.

আমাদের কোম্পানির পদ্ধতি

আমি আপনাকে বলব যে এটি আমাদের কোম্পানিতে কীভাবে কাজ করে এবং আমি একই পরিস্থিতিতে কীভাবে কাজ করি, তবে আপনি সহজেই আপনার প্রকল্প এবং কোম্পানির চাহিদা অনুযায়ী এই পদ্ধতিটি পরিবর্তন করতে পারেন।

দুই ধরনের স্থাপত্য মূল্যায়ন আছে।

অভ্যন্তরীণ - আমরা সাধারণত কোম্পানির মধ্যে প্রকল্পের জন্য এটি করি। যেকোন প্রজেক্ট বিভিন্ন কারণে আর্কিটেকচারের মূল্যায়নের জন্য অনুরোধ করতে পারে:

1. দলটি মনে করে তাদের প্রকল্প নিখুঁত এবং এটি সন্দেহজনক। আমরা এই ধরনের ঘটনা আছে, এবং প্রায়ই এই ধরনের প্রকল্পে সবকিছু আদর্শ থেকে দূরে.
2. দলটি তাদের প্রকল্প এবং তাদের সমাধান পরীক্ষা করতে চায়।
3. দল জানে পরিস্থিতি খারাপ। তারা এমনকি প্রধান সমস্যা এবং কারণগুলি তালিকাভুক্ত করতে পারে, কিন্তু প্রকল্পের উন্নতির জন্য সমস্যা এবং সুপারিশগুলির একটি সম্পূর্ণ তালিকা চায়।

বাহ্যিক অভ্যন্তরীণ মূল্যায়নের চেয়ে একটি আনুষ্ঠানিক প্রক্রিয়া। ক্লায়েন্ট সবসময় শুধুমাত্র একটি ক্ষেত্রে আসে, যখন সবকিছু খারাপ - খুব খারাপ। সাধারণত ক্লায়েন্ট বুঝতে পারে যে বিশ্বব্যাপী সমস্যা রয়েছে, কিন্তু সঠিকভাবে কারণগুলি সনাক্ত করতে পারে না এবং উপাদানগুলিতে বিভক্ত করতে পারে না।

একটি বহিরাগত ক্লায়েন্টের জন্য একটি স্থাপত্য মূল্যায়ন একটি আরো জটিল ক্ষেত্রে. প্রক্রিয়াটি আরও আনুষ্ঠানিক হওয়া উচিত। প্রকল্প সবসময় বড় এবং পুরানো হয়. তাদের অনেক সমস্যা, বাগ এবং কুটিল কোড রয়েছে। সম্পন্ন কাজের একটি প্রতিবেদন সর্বোচ্চ কয়েক সপ্তাহের মধ্যে প্রস্তুত হওয়া উচিত, যাতে প্রধান সমস্যা এবং উন্নতির জন্য সুপারিশ অন্তর্ভুক্ত করা উচিত। অতএব, যদি আমরা প্রকল্পের বাহ্যিক মূল্যায়নের সাথে মোকাবিলা করি, তাহলে অভ্যন্তরীণ মূল্যায়ন হবে কেকের টুকরো। সবচেয়ে কঠিন কেস বিবেচনা করা যাক।

এন্টারপ্রাইজ প্রকল্প স্থাপত্য মূল্যায়ন

মূল্যায়নের জন্য একটি সাধারণ প্রকল্প হল একটি বৃহৎ, পুরানো, অনেক সমস্যা সহ এন্টারপ্রাইজ প্রকল্প। একজন ক্লায়েন্ট আমাদের কাছে আসে এবং তার প্রজেক্ট ঠিক করতে বলে। এটি একটি আইসবার্গের মতো, ক্লায়েন্ট তার সমস্যার কেবলমাত্র টিপ দেখেন এবং জলের নীচে কী আছে (কোডের গভীরতায়) তার কোনও ধারণা নেই।

গ্রাহক যে সমস্যাগুলি সম্পর্কে অভিযোগ করতে পারে এবং সেগুলি সম্পর্কে সচেতন হতে পারে:

• কর্মক্ষমতা সমস্যা
• ব্যবহারযোগ্যতা সমস্যা
• দীর্ঘমেয়াদী স্থাপনা
• ইউনিট ও অন্যান্য পরীক্ষার অভাব

যে সমস্যাগুলি ক্লায়েন্ট সম্ভবত জানেন না, তবে তারা প্রকল্পে উপস্থিত থাকতে পারে:

• নিরাপত্তা সমস্যা
• ডিজাইন সমস্যা
• ভুল স্থাপত্য
• অ্যালগরিদমিক ত্রুটি
• অনুপযুক্ত প্রযুক্তি
• প্রযুক্তিগত ঋণ
• ভুল উন্নয়ন প্রক্রিয়া

আনুষ্ঠানিক স্থাপত্য পর্যালোচনা প্রক্রিয়া

এটি একটি আনুষ্ঠানিক প্রক্রিয়া যা আমরা একটি কোম্পানি হিসাবে অনুসরণ করি, তবে আপনি আপনার কোম্পানি এবং প্রকল্পের উপর নির্ভর করে এটি কাস্টমাইজ করতে পারেন।

একটি ক্লায়েন্ট থেকে অনুরোধ

ক্লায়েন্ট বর্তমান প্রকল্পের আর্কিটেকচার মূল্যায়ন করতে বলে। আমাদের পক্ষের দায়িত্বশীল ব্যক্তি প্রকল্প সম্পর্কে প্রাথমিক তথ্য সংগ্রহ করেন এবং প্রয়োজনীয় বিশেষজ্ঞদের নির্বাচন করেন। প্রকল্পের উপর নির্ভর করে, এগুলি বিভিন্ন বিশেষজ্ঞ হতে পারে।

সমাধান আর্কিটেক্ট - মূল্যায়ন এবং সমন্বয়ের জন্য দায়ী প্রধান ব্যক্তি (এবং প্রায়শই একমাত্র)।
স্ট্যাক নির্দিষ্ট বিশেষজ্ঞ - .নেট, জাভা, পাইথন, এবং অন্যান্য প্রযুক্তিগত বিশেষজ্ঞরা প্রকল্প এবং প্রযুক্তির উপর নির্ভর করে
মেঘ বিশেষজ্ঞ – এগুলি Azure, GCP বা AWS ক্লাউড আর্কিটেক্ট হতে পারে।
পরিকাঠামো - DevOps, সিস্টেম অ্যাডমিনিস্ট্রেটর, ইত্যাদি
অন্যান্য বিশেষজ্ঞরা - যেমন বড় ডেটা, মেশিন লার্নিং, পারফরম্যান্স ইঞ্জিনিয়ার, নিরাপত্তা বিশেষজ্ঞ, QA লিড।

প্রকল্প সম্পর্কে তথ্য সংগ্রহ

আপনার প্রকল্প সম্পর্কে যতটা সম্ভব তথ্য সংগ্রহ করা উচিত। আপনি পরিস্থিতির উপর নির্ভর করে বিভিন্ন কৌশল ব্যবহার করতে পারেন:

• প্রশ্নাবলী এবং মেলের মাধ্যমে যোগাযোগের অন্যান্য পদ্ধতি। সবচেয়ে অকার্যকর উপায়.
• অনলাইন মিটিং.
• তথ্য বিনিময়ের জন্য বিশেষ টুল যেমন: Google ডক, কনফ্লুয়েন্স, রিপোজিটরি ইত্যাদি।
• সাইটে "লাইভ" মিটিং। সবচেয়ে কার্যকর এবং সবচেয়ে ব্যয়বহুল উপায়।

আপনি ক্লায়েন্ট থেকে কি পেতে হবে?

মৌলিক তথ্য. প্রকল্প কি সম্পর্কে? এর উদ্দেশ্য এবং মূল্য। ভবিষ্যতের জন্য প্রধান লক্ষ্য এবং পরিকল্পনা। ব্যবসায়িক লক্ষ্য এবং কৌশল। প্রধান সমস্যা এবং পছন্দসই ফলাফল।

প্রকল্প সম্পর্কিত তথ্য. প্রযুক্তি স্ট্যাক, ফ্রেমওয়ার্ক, প্রোগ্রামিং ভাষা। অন-প্রিমিস বা ক্লাউড স্থাপনা। যদি প্রকল্পটি ক্লাউডে থাকে তবে কী পরিষেবাগুলি ব্যবহার করা হয়। কি স্থাপত্য এবং নকশা নিদর্শন ব্যবহার করা হয়েছে.

অ-কার্যকর প্রয়োজনীয়তা. কর্মক্ষমতা, প্রাপ্যতা, এবং সিস্টেমের ব্যবহারের সহজতার সাথে সম্পর্কিত সমস্ত প্রয়োজনীয়তা। নিরাপত্তা প্রয়োজনীয়তা, ইত্যাদি

মৌলিক ব্যবহারের ক্ষেত্রে এবং ডেটা প্রবাহ।

সোর্স কোড অ্যাক্সেস. সবচেয়ে গুরুত্বপূর্ণ অংশ! আপনি অবশ্যই প্রকল্পটি কীভাবে তৈরি করবেন সে সম্পর্কে সংগ্রহস্থল এবং ডকুমেন্টেশনগুলিতে অ্যাক্সেস পেতে হবে।

অবকাঠামো অ্যাক্সেস. লাইভ সিস্টেমের সাথে কাজ করার জন্য মঞ্চ বা উৎপাদন পরিকাঠামোতে অ্যাক্সেস থাকলে ভালো হবে। ক্লায়েন্টের অবকাঠামো এবং কর্মক্ষমতা নিরীক্ষণের জন্য সরঞ্জাম থাকলে এটি একটি দুর্দান্ত সাফল্য। আমরা পরবর্তী বিভাগে এই সরঞ্জামগুলি সম্পর্কে কথা বলব।

Документация. যদি ক্লায়েন্টের ডকুমেন্টেশন থাকে তবে এটি একটি ভাল শুরু। এটি পুরানো হতে পারে, তবে এটি এখনও একটি ভাল শুরু। ডকুমেন্টেশনকে কখনই বিশ্বাস করবেন না - এটি ক্লায়েন্টের সাথে, বাস্তব পরিকাঠামোতে এবং উত্স কোডে পরীক্ষা করুন৷

স্থাপত্য মূল্যায়ন প্রক্রিয়া

এত অল্প সময়ে এত বড় তথ্য কীভাবে প্রক্রিয়া করা যায়? প্রথমত, কাজ সমান্তরাল করুন।

DevOps অবকাঠামো দেখতে হবে. কোডে টেক লিড। কর্মক্ষমতা মেট্রিক্স দেখতে পারফরম্যান্স ইঞ্জিনিয়ার। একজন ডাটাবেস বিশেষজ্ঞের ডাটা স্ট্রাকচারের গভীরে খনন করা উচিত।

কিন্তু এটি একটি আদর্শ ক্ষেত্রে যখন আপনার অনেক সম্পদ থাকে। সাধারণত, এক থেকে তিনজন লোক একটি প্রকল্পের মূল্যায়ন করে। এমনকি আপনি নিজেই অনুমানটি পরিচালনা করতে পারেন, যদি আপনার প্রকল্পের সমস্ত ক্ষেত্রে সঠিক জ্ঞান এবং অভিজ্ঞতা থাকে তবে এটি প্রায়শই হয়। এই ক্ষেত্রে, আপনাকে যতটা সম্ভব সমস্ত প্রক্রিয়া স্বয়ংক্রিয় করতে হবে।

দুর্ভাগ্যবশত, আপনাকে ম্যানুয়ালি ডকুমেন্টেশন পড়তে হবে। সঠিক পরিমাণ অভিজ্ঞতার সাথে, আপনি দ্রুত ডকুমেন্টেশনের গুণমান বুঝতে পারবেন। কি সত্য এবং কোনটি স্পষ্টভাবে বাস্তবতার সাথে মিলে না। কখনও কখনও আপনি ডকুমেন্টেশনে আর্কিটেকচার দেখতে পারেন যা বাস্তব জীবনে কখনই কাজ করবে না। এটি প্রকল্পে বাস্তবে এটি কীভাবে করা হয়েছিল সে সম্পর্কে আপনার চিন্তা করার জন্য এটি একটি ট্রিগার।

প্রকল্প মূল্যায়ন স্বয়ংক্রিয় করার জন্য দরকারী টুল

কোড মূল্যায়ন একটি সহজ ব্যায়াম। আপনি স্ট্যাটিক কোড বিশ্লেষক ব্যবহার করতে পারেন যা আপনাকে ডিজাইন, কর্মক্ষমতা এবং নিরাপত্তা সমস্যা দেখাবে। এখানে তাদের কিছু আছে:

কাঠামো 101 একটি স্থপতি জন্য একটি মহান হাতিয়ার. এটি আপনাকে বড় ছবি, মডিউল এবং রিফ্যাক্টরিংয়ের সম্ভাব্য ক্ষেত্রগুলির মধ্যে নির্ভরতা দেখাবে। সমস্ত ভাল সরঞ্জামগুলির মতো, এটির জন্য ভাল অর্থ ব্যয় হয় তবে আপনি 30-দিনের ট্রায়াল সংস্করণের সুবিধা নিতে পারেন।

সোনারকিউব - একটি ভাল পুরানো টুল। স্ট্যাটিক কোড বিশ্লেষণের জন্য একটি টুল। আপনাকে 20টিরও বেশি প্রোগ্রামিং ভাষার জন্য খারাপ কোড, বাগ এবং নিরাপত্তা সমস্যা সনাক্ত করতে দেয়।

সমস্ত ক্লাউড প্রদানকারীর অবকাঠামো পর্যবেক্ষণ সরঞ্জাম আছে। এটি আপনাকে খরচ এবং কর্মক্ষমতার পরিপ্রেক্ষিতে আপনার পরিকাঠামোর কার্যকারিতা সঠিকভাবে মূল্যায়ন করার অনুমতি দেবে। AWS এর জন্য এটি বিশ্বস্ত উপদেষ্টা. Azure এর জন্য এটা সহজ আজুর উপদেষ্টা.

অতিরিক্ত কর্মক্ষমতা নিরীক্ষণ এবং লগিং সমস্ত স্তরে কর্মক্ষমতা সমস্যা খুঁজে পেতে সাহায্য করবে। অকার্যকর প্রশ্ন সহ একটি ডাটাবেস থেকে শুরু করে, ব্যাকএন্ড এবং ফ্রন্টএন্ড দিয়ে শেষ হয়। এমনকি যদি ক্লায়েন্ট পূর্বে এই সরঞ্জামগুলি ইনস্টল না করে থাকে, আপনি কার্যক্ষমতার সমস্যাগুলি সনাক্ত করতে মোটামুটি দ্রুত বিদ্যমান সিস্টেমে তাদের সংহত করতে পারেন।

সর্বদা হিসাবে, ভাল সরঞ্জাম এটি মূল্য ভাল. আমি কয়েকটি অর্থপ্রদানের সরঞ্জাম সুপারিশ করতে পারি। অবশ্যই আপনি ওপেন সোর্স ব্যবহার করতে পারেন তবে এটি আপনার আরও সময় নেবে। এবং এটি অগ্রিম করা উচিত, স্থাপত্য মূল্যায়ন প্রক্রিয়ার সময় নয়।

নতুন বাসস্থান - অ্যাপ্লিকেশন কর্মক্ষমতা মূল্যায়ন করার জন্য একটি টুল
ডাটাডোগ - ক্লাউড সিস্টেম পর্যবেক্ষণ পরিষেবা

নিরাপত্তা পরীক্ষার জন্য উপলব্ধ অনেক সরঞ্জাম আছে. এইবার আমি আপনাকে একটি ফ্রি সিস্টেম স্ক্যানিং টুল সুপারিশ করব।

OWASP জ্যাপ – নিরাপত্তা মান মেনে চলার জন্য ওয়েব অ্যাপ্লিকেশন স্ক্যান করার একটি টুল।

আসুন সবকিছু একত্রিত করি।

একটি প্রতিবেদন প্রস্তুত করা হচ্ছে

ক্লায়েন্টের কাছ থেকে সংগ্রহ করা ডেটা দিয়ে আপনার প্রতিবেদন শুরু করুন। প্রকল্পের লক্ষ্য, সীমাবদ্ধতা, অকার্যকর প্রয়োজনীয়তা বর্ণনা করুন। এর পরে, সমস্ত ইনপুট ডেটা উল্লেখ করা উচিত: উত্স কোড, ডকুমেন্টেশন, অবকাঠামো।

পরবর্তী পর্ব. ম্যানুয়ালি বা স্বয়ংক্রিয় সরঞ্জাম ব্যবহার করে আপনি যে কোনো সমস্যা খুঁজে পেয়েছেন তা তালিকাভুক্ত করুন। অ্যাপ্লিকেশন বিভাগে শেষে বড় স্বয়ংক্রিয়-উত্পন্ন প্রতিবেদনগুলি রাখুন। পাওয়া সমস্যার সংক্ষিপ্ত এবং সংক্ষিপ্ত প্রমাণ থাকা উচিত।
ত্রুটি, সতর্কতা, তথ্য স্কেলে পাওয়া সমস্যাগুলিকে অগ্রাধিকার দিন। আপনি আপনার নিজের স্কেল চয়ন করতে পারেন, কিন্তু এটি সাধারণত গৃহীত এক.

একজন সত্যিকারের স্থপতি হিসাবে, পাওয়া সমস্যাগুলি সংশোধন করার জন্য সুপারিশগুলি প্রদান করা আপনার দায়িত্ব৷ গ্রাহক যে উন্নতি এবং ব্যবসায়িক মূল্য পাবেন তা বর্ণনা করুন। কিভাবে থেকে ব্যবসার মান দেখাবেন আর্কিটেকচার রিফ্যাক্টরিং আমরা আগে আলোচনা করেছি।

ছোট পুনরাবৃত্তি সহ একটি রোডম্যাপ প্রস্তুত করুন। প্রতিটি পুনরাবৃত্তিতে সম্পূর্ণ করার সময়, বর্ণনা, উন্নতির জন্য প্রয়োজনীয় সম্পদের পরিমাণ, প্রযুক্তিগত মান এবং ব্যবসার মান থাকা উচিত।

আমরা আর্কিটেকচারের মূল্যায়ন সম্পূর্ণ করি এবং ক্লায়েন্টকে একটি প্রতিবেদন প্রদান করি

শুধুমাত্র একটি রিপোর্ট মেল না. এটি মোটেও পড়া নাও হতে পারে, বা সঠিক ব্যাখ্যা ছাড়া পড়া এবং বোঝা যায় না। সংক্ষেপে, লাইভ যোগাযোগ মানুষের মধ্যে ভুল বোঝাবুঝি দূর করতে সাহায্য করে। আপনার ক্লায়েন্টের সাথে একটি মিটিংয়ের সময়সূচী করা উচিত এবং পাওয়া সমস্যাগুলি সম্পর্কে কথা বলা উচিত, সবচেয়ে গুরুত্বপূর্ণগুলির উপর ফোকাস করে৷ এটি এমন সমস্যাগুলির প্রতি ক্লায়েন্টের দৃষ্টি আকর্ষণ করা মূল্যবান যা তিনি এমনকি জানেন না। যেমন নিরাপত্তা সমস্যা এবং ব্যাখ্যা করুন কিভাবে তারা ব্যবসা প্রভাবিত করতে পারে। উন্নতি সহ আপনার রোডম্যাপ দেখান এবং ক্লায়েন্টের জন্য আরও উপযুক্ত বিভিন্ন বিকল্প নিয়ে আলোচনা করুন। এটি সময়, সম্পদ, কাজের পরিমাণ হতে পারে।

আপনার মিটিংয়ের সারাংশ হিসাবে, আপনার প্রতিবেদনটি ক্লায়েন্টের কাছে পাঠান।

উপসংহার ইন

স্থাপত্য মূল্যায়ন একটি জটিল প্রক্রিয়া। মূল্যায়ন সঠিকভাবে সম্পাদন করার জন্য আপনার যথেষ্ট অভিজ্ঞতা এবং জ্ঞান থাকতে হবে।

মাত্র এক সপ্তাহের মধ্যে ক্লায়েন্টকে তার এবং তার ব্যবসার জন্য দরকারী ফলাফল প্রদান করা সম্ভব। একা করলেও।

আমার অভিজ্ঞতার উপর ভিত্তি করে, মাঝখানে অনেক উন্নতি ডাউনলোড করা হয়েছিল, এবং কখনও কখনও শুরু হয়নি। যারা নিজেদের জন্য সোনালি গড় বেছে নিয়েছিলেন এবং ন্যূনতম শ্রম খরচের সাথে ব্যবসার জন্য সবচেয়ে উপযোগী উন্নতির অংশ মাত্র তারা তাদের পণ্যের গুণমানকে উল্লেখযোগ্যভাবে উন্নত করেছেন। যারা কিছুই করেনি তারা বছর দুয়েক পর প্রকল্পটি পুরোপুরি বন্ধ করে দিতে পারে।

আপনার লক্ষ্য হল ক্লায়েন্টকে সর্বনিম্ন মূল্যের জন্য সর্বাধিক উন্নতি দেখানো।

বিভাগ থেকে অন্যান্য নিবন্ধ স্থাপত্য আপনি আপনার অবসর সময়ে পড়তে পারেন।

আমি আপনাকে পরিষ্কার কোড এবং ভাল স্থাপত্য সিদ্ধান্ত কামনা করি।

আমাদের ফেসবুক গ্রুপ- সফটওয়্যার আর্কিটেকচার অ্যান্ড ডেভেলপমেন্ট.

উত্স: www.habr.com