ওয়েব অ্যাপ্লিকেশনটির জন্য ক্লায়েন্টকে বিতরণযোগ্যগুলি কী কী? [বন্ধ]


11

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

সুতরাং আমি কেবল ভাবছি ... কোড এবং আর্কিটেকচার ডকুমেন্টেশনগুলি বাদ দিয়ে আমি আমার ক্লায়েন্টকে কী বাধ্যতামূলক প্রযুক্তিগত এবং নন প্রযুক্তিগত ডকস দিতে পারি?

(এছাড়াও প্রকল্পটির বিভিন্ন পরিসংখ্যান এবং ডেটা সম্পর্কে ক্লায়েন্টকে আঘাত করা খুব শীঘ্রই হবে যাতে তিনি আসলে কী পরিমাণ কাজের সাথে জড়িত এবং পণ্যটি আসলে কতটা শীতল তা জানতে পারে))


8
গ্রাহক কোন বাধ্যতামূলক আইটেমগুলি পান তা সম্পূর্ণরূপে চুক্তি এবং আপনার দেশের আইনের উপর নির্ভর করে।
ফ্যালকন

2
কেন এটি চুক্তিতে নির্দিষ্ট করা হয়নি? তৈরি সমস্ত নথিপত্র আপনার জন্য, ভবিষ্যতের বিকাশকারীদের জন্য বা গ্রাহকের জন্য মান (বা কমপক্ষে অনুভূত মান) যুক্ত করা উচিত। আপনার এবং ভবিষ্যতের বিকাশকারীদের জন্য কী কী ডকুমেন্টেশনটির মূল্য যুক্ত হয় তা আপনি (উচিত) জানেন, সুতরাং আপনার গ্রাহককে ঠিক মূল্য যুক্ত করার জন্য ডকুমেন্টেশন প্রয়োজন, প্রকল্প পরিকল্পনায় রাখুন, এবং এটি সাইন ইন করে রাখুন ask
থমাসের মালিক

ক্লায়েন্ট কোনটি চায় ? আপনি একটি ক্লায়েন্টের প্রযুক্তিগত পরিচালক থেকে প্রতিক্রিয়া পেতে পারেন? এছাড়াও: আপনার পণ্যটি "দুর্দান্ত" কোন অর্থে? আপনি কি এটা পরিষ্কার করতে পারেন?
জেডজেআর

উত্তর:


9

আমি মনে করি তালিকার অন্তর্ভুক্ত হওয়া উচিত:

  • অ-প্রযুক্তিগত প্রয়োজনীয়তা (এমন কোনও নথি ছিল, তাই না?)
  • প্রযুক্তিগত প্রয়োজনীয়তা
  • একটি "সিদ্ধান্ত" নথি (যদি সেখানে একটি ছিল) ব্যাখ্যা করে যে কেন অন্যদের উপর কিছু সিদ্ধান্ত নেওয়া হয়েছিল। এটি ইতিমধ্যে কোনও পৃথক প্রয়োজনীয়তা বা আর্কিটেকচার ডকুমেন্টে থাকতে পারে তবে আমরা সাধারণত বড় সিদ্ধান্তের জন্য আলাদাভাবে এটি করি।
  • কোড এবং অন্যান্য সংস্থানসমূহ (চিত্র ফাইল, সিএসএস, ইত্যাদি ...)
  • ডাটাবেস মডেল (ডায়াগ্রাম, নথি হিসাবে যাই হোক না কেন)
  • ডাটাবেস তৈরি করতে ডিডিএল।
  • ডাটাবেস বীজ করতে ডিএমএল
  • অ্যাপ্লিকেশন সেটআপ এবং বুনিয়াদি সমস্যার শুটিং সম্পর্কিত একটি দস্তাবেজ।
  • কোনও গুরুত্বপূর্ণ ব্যবহারকারীর নাম এবং তাদের পাসওয়ার্ডগুলির তালিকা (অ্যাডমিন অ্যাকাউন্টগুলির জন্য), পাশাপাশি পাসওয়ার্ড কীভাবে পরিবর্তন করবেন সে সম্পর্কে নির্দেশাবলী। আদর্শভাবে, যখন তারা প্রথমবারের মতো ওয়েবসাইটটি সেট আপ করেন, তাদের একটি নতুন অ্যাডমিন পাসওয়ার্ড দেওয়ার জন্য অনুরোধ করা উচিত তবে এটি কোনও আর্কিটেকচার জিনিসই বেশি।
  • সিস্টেমের প্রয়োজনীয়তা এবং ওয়েব অ্যাপ্লিকেশনগুলির জন্য, সর্বনিম্ন হোস্টিং প্রয়োজনীয়তাও (অ্যাপটি কি মাইএসকিউএল বা পোস্টগ্র্যাস এসকিউএল প্রয়োজন? কতটা র‌্যাম ?, ইত্যাদি ...)

এই সমস্ত কিছুই প্রতিটি প্রকল্পের জন্য উপলব্ধ (বা প্রয়োজনীয়) নাও হতে পারে তবে আমি মনে করি এটি একটি ভাল সাধারণ গাইড।


"কোনও গুরুত্বপূর্ণ ব্যবহারকারীর নাম এবং তাদের পাসওয়ার্ডগুলির তালিকা (অ্যাডমিন অ্যাকাউন্টগুলির জন্য)" : সত্যই? ওয়েবসাইটটি প্রকাশের পরে বিকাশকারীদের কোনও পাসওয়ার্ড জানতে হবে না , বিশেষত প্রশাসকগণ one আপনি যদি বিকাশের সময় আপনি যে পাসওয়ার্ডগুলি ব্যবহার করেন সেগুলির তালিকা আপনি যদি গ্রাহককে দেন তবে আপনি নিশ্চিত থাকতে পারেন যে গ্রাহক কখনই সেগুলি পরিবর্তন করবেন না।
আর্সেনী মরজেনকো

4
@ মাইনমা: আমি ধরে নিয়েছি যে ক্লায়েন্টের পাসওয়ার্ড পরিবর্তন করার ক্ষমতা রয়েছে এবং প্রথম নির্দেশের একটি হ'ল "আপনার পাসওয়ার্ড পরিবর্তন করুন!"
হতাশিত

আপনি দয়া করে "নন-টেকনিক্যাল প্রয়োজনীয়তা" কীভাবে নবজাতকের জন্য পরিষ্কার করতে পারেন?
আবে

1
@ আবু: অ-প্রযুক্তিগত প্রয়োজনীয়তা যেমন "এই অ্যাপ্লিকেশনটি ব্যবহারকারীকে তাদের নিজস্ব অ্যাকাউন্ট পরিচালনা করতে দেওয়া উচিত" বলে কিছু বলবে এবং প্রযুক্তিগতভাবে বলতে পারে "এসওএপি-ভিত্তিক ওয়েব পরিষেবাদি এমন একটি ইন্টারফেস প্রকাশ করবে যা ক্লায়েন্ট অ্যাপ্লিকেশনটিকে ব্যবহারকারীর অ্যাকাউন্টগুলি পরিচালনা করতে দেয় "।
হতাশিত

4

হতাশাগ্রস্থ উইথফোর্ডস ডিজাইনারের সত্যিকারের উত্তরের পাশাপাশি আমি কী বলতে চাই না যে প্রযুক্তিগত নথিগুলি কী অন্তর্ভুক্ত করে (যেমনটি আমরা এটি করেছি):

  • বিশ্লেষণের ডেটা: যখন আপনি প্রথম প্রয়োজনীয়তার কথা বলেছেন তখন গ্রাহক আপনাকে কী বলেছিলেন?
  • আপনি যে অফারটি করেছেন:

    • পণ্য প্রয়োজনীয় নথি
    • এবং কার্যকরী স্পেসিফিকেশন ডকুমেন্ট

    যা একসাথে আপনাকে কী করা উচিত এবং
    গ্রাহকরা বিকাশের সময় বিতরণ করার পাশাপাশি আনুমানিক সময় এবং ব্যয় সম্পর্কে প্রত্যাশিত একধরণের চুক্তি হিসাবে কাজ করে।

  • পর্যালোচনা প্রোটোকল, ইউজারকেস এবং টেস্টপ্ল্যানস, টেস্টেরসাল্ট সহ স্পেসিফিকেশন

  • ইউএমএল এবং সমস্ত সম্পর্কিত নথি নকশা

  • উত্সকোডের ডকুমেন্টেশন (অক্সিজেন বা যাই হোক না কেন)

  • ম্যানুয়াল এবং ইনস্টলেশন নির্দেশিকা

  • প্রকল্পের জন্য ব্যবহৃত সম্পদের চূড়ান্ত প্রকৃত পরিমাণ (সময় এবং অর্থ), যাতে আপনি একটি চালান লিখতে পারেন

  • কিছু গ্রাহক মিটিং প্রোটোকলগুলিও চান, যা পরে উল্লিখিত "সিদ্ধান্ত নথিতে" বাড়ানো

আশা করি এটিই আপনি খুঁজছিলেন।


3

নিম্নলিখিত থেকে আপনার প্রকল্পের জন্য যে কোনও ডকুমেন্টেশন প্রযোজ্য তা অনুসরণ করুন You আপনার কাছে ইতিমধ্যে এর কিছু থাকতে পারে।

প্রযুক্তিগত নথিপত্রে:

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

স্ক্রিনশট সহ নথি প্রস্তুত করুন এবং নিম্নলিখিতগুলির জন্য প্রাসঙ্গিক কোডটি (যদি প্রয়োজন হয়) হাইলাইট করুন:

  • সামনের প্রান্ত অ্যাপ্লিকেশন সম্পর্কিত তথ্য যেমন বস্তু বা নিয়ন্ত্রণ, বস্তুর বৈশিষ্ট্য ইত্যাদি
  • ডাটাবেস ক্যোয়ারী সম্পর্কিত তথ্য (যদি এটি ইতিমধ্যে উপস্থিত না থাকে)
  • প্রাথমিক কী, বিদেশী কী ইত্যাদির মতো ডেটাবেস বৈশিষ্ট্য সম্পর্কিত তথ্য এবং কীভাবে তারা ডেটা ধারাবাহিকতা এবং নির্ভুলতা নিশ্চিত করে।
  • যৌক্তিক ক্রমে একই ধরণের ডেটা বা স্ক্রিনের পুনরাবৃত্তি ছাড়াই, নমুনা ডেটা দিয়ে চালানোর পরে সামনের প্রান্তটি পাশাপাশি পিছনের শেষ উভয়টি ব্যবহার করে সমস্ত সম্ভাব্য ধরণের স্ক্রিনের স্ক্রিনশট ব্যবহার করে পুরো প্রকল্পে বিস্তারিত গাইড।
  • অবৈধ ডেটা ইনপুট করুন এবং দেখান যে এটি করা অসম্ভব যেহেতু আপনি সামনে এবং শেষ প্রান্তে ডেটা বৈধকরণ করেছেন।
    /* This step is not applicable if you have not used any object for getting direct input from the user like Text Field as it is obvious that you cannot get invalid data through indirect input. */

  • প্রাসঙ্গিক কোডটি ব্যাখ্যা করে সার্ভার বা ক্লায়েন্ট সিস্টেমে হঠাৎ ব্যর্থতা হলে প্রোগ্রামে কোনও ত্রুটি বা ডেটাতে অসঙ্গতি নেই তা দেখান।

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

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

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


    অ-প্রযুক্তিগত ডকুমেন্টেশন:

  • প্রযোজ্য ক্ষেত্রে প্রকল্পের লাইসেন্স সংক্রান্ত বিশদ।
  • প্রজেক্টের বাণিজ্যিক দিকগুলি।

2

সতর্ক হতে হবে

আপনি ক্লায়েন্টকে যে সম্ভাব্য ডকুমেন্টেশন দিতে পারেন তা কার্যত অন্তহীন। আপনার কাছে ইতিমধ্যে নেই এমন ডকুমেন্টেশন তৈরি করতে অতিরিক্ত সময় প্রয়োজন বেতনের।

ক্লায়েন্ট কেন এই ডকুমেন্টেশন চান (উত্স কোডের উপরে এবং উপরে)? এটি দিয়ে কী করা হবে? কার জন্য?

এই প্রশ্নের উত্তরগুলি কী বিতরণ করবে তার সুযোগকে সঙ্কীর্ণ করতে সহায়তা করবে।

এটি গুরুত্বপূর্ণ যে আপনি এবং ক্লায়েন্ট ঠিক কোন ডকুমেন্টেশন সরবরাহ করবেন এবং কোনও অতিরিক্ত প্রচেষ্টা ক্ষতিপূরণ হবে কিনা সে বিষয়ে একমত হন।

অনুমানের গেমগুলি খেলবেন না। বেশিরভাগ প্রযুক্তিগত ডকুমেন্টেশন সাধারণত (অ প্রযুক্তিগত) ক্লায়েন্টের পক্ষে অকেজো use


1

আমি সম্ভবত এটি কয়েকটি নথির বিভাগগুলিতে বিভক্ত করতাম:

নির্দেশিকা:

  • ইনস্টলেশন গাইড, কীভাবে এটি কোনও সার্ভারে সেট আপ করে।
  • অনুকূল পারফরম্যান্সের জন্য অ্যাপ্লিকেশনটি কীভাবে কনফিগার করতে এবং চালাতে হয় তার জন্য প্রশাসকের গাইড। সুরক্ষা এছাড়াও এখানে coverাকতে এমন কিছু হবে যাতে এটি জানতে পারে যে এই অ্যাপ্লিকেশনটির কী পাসওয়ার্ড রয়েছে এবং এটি চালাতে ব্যবহার করে।

সহায়তা:

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

ইন্টিগ্রেশন পয়েন্ট:

  • এই অ্যাপ্লিকেশনটির জন্য কি তৃতীয় পক্ষের ইন্টিগ্রেশন পয়েন্ট রয়েছে যা এটি আপনার কোডের চেয়ে অন্য বিক্রেতাদের উপর নির্ভর করে?
আমাদের সাইট ব্যবহার করে, আপনি স্বীকার করেছেন যে আপনি আমাদের কুকি নীতি এবং গোপনীয়তা নীতিটি পড়েছেন এবং বুঝতে পেরেছেন ।
Licensed under cc by-sa 3.0 with attribution required.