Replit অ্যাপ প্রিভিউতে চলে, কিন্তু পাবলিশের পর ভেঙে যায়? ফাউন্ডারদের জন্য একটি চেকলিস্ট

আপনি Replit-এ অ্যাপটি টেস্ট করলেন, কাউকে লিংক পাঠালেন, আর সঙ্গে সঙ্গেই শুনলেন লগইন, সেভ বা চেকআউট কাজ করছে না। Agent-কে দিয়ে ওই ফিচারগুলো নতুন করে বানানোর আগে এই Replit প্রোডাকশন ডিপ্লয়মেন্ট চেকলিস্ট ব্যবহার করুন। দুই এনভায়রনমেন্টের মধ্যে কোনো পার্থক্যই হয়তো ব্যর্থতার কারণ, যার জন্য নতুন ইমপ্লিমেন্টেশনের দরকার নেই।

Replit প্রিভিউতে অ্যাপ চললেও লাইভে কেন ব্যর্থ হতে পারে?

Replit প্রিভিউ এবং পাবলিশ করা অ্যাপ আলাদা এনভায়রনমেন্ট। আপনি যে প্রজেক্ট এডিট করছেন, তার তুলনায় লাইভ অ্যাপের URL, কনফিগারেশন, ডেটা এবং রানটাইম আচরণ ভিন্ন হতে পারে।

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

পাঁচটা অসম্পর্কিত স্ক্রিনশট জমিয়ে Agent-কে পুরো অ্যাপ ঠিক করতে বলবেন না। একটি ব্যর্থতা বেছে নিন: যেমন, একজন নতুন গ্রাহক Save চাপার পর এরর পাচ্ছেন। প্রত্যাশিত ফলাফল, আসল ফলাফল এবং সময় লিখে রাখুন। এতে পাবলিশ করা অ্যাপ্লিকেশনের লগের সাথে তুলনা করার মতো একটি নির্দিষ্ট বিষয় পাবেন।

অ্যাপটি কি সঠিক ডিপ্লয়মেন্ট টাইপ ব্যবহার করছে?

আপনার অ্যাপ যে ধরনের প্রোগ্রাম চালায়, ডিপ্লয়মেন্টকে তা সমর্থন করতে হবে। কিছু স্ট্যাটিক ফাইল আর একটি ফুল-স্ট্যাক অ্যাপ্লিকেশনের হোস্টিং চাহিদা আলাদা।

অক্টোবর 2026 অনুযায়ী, Replit-এর ডিপ্লয়মেন্ট টাইপ ডকুমেন্টেশন Autoscale, Static, Reserved VM এবং Scheduled ডিপ্লয়মেন্টকে আলাদা করে দেখায়। Publishing settings-এ ডিপ্লয়মেন্ট টাইপ দেখুন এবং অ্যাপ্লিকেশনের আসল প্রয়োজনের সাথে মিলিয়ে নিন।

একই ডকুমেন্টেশনে বলা আছে, Replit Agent দিয়ে তৈরি অ্যাপের সাথে Static সামঞ্জস্যপূর্ণ নয়, কারণ ওই অ্যাপগুলোর ব্যাকএন্ড দরকার। অ্যাপ্লিকেশন কাস্টমাইজ করা হলে একজন ডেভেলপারকে দিয়ে বিল্ড ও রান কমান্ড নিশ্চিত করান। বড় মেশিন কিনলেও অনুপস্থিত সার্ভার রাউট বা ভুল স্টার্টআপ কমান্ড ঠিক হবে না।

প্রয়োজনীয় প্রোডাকশন সিক্রেটগুলো কি সত্যিই উপলব্ধ?

পাবলিশ করা অ্যাপ যে ক্রেডেনশিয়াল ও কনফিগারেশন ব্যবহার করে, সেগুলোর নাম ও নির্ধারিত এনভায়রনমেন্টসহ যাচাই করুন। ডেভেলপমেন্টের সময় কোনো কী পাওয়া গেলেই তা প্রমাণ করে না যে লাইভ ইন্টিগ্রেশন সঠিকভাবে কনফিগার করা আছে।

Replit-এর Secrets গাইড আপনাকে Publishing → Adjust settings → Production app secrets-এ যেতে বলে। এটি সংবেদনশীল সিক্রেট এবং অসংবেদনশীল কনফিগারেশন ভ্যালুর মধ্যেও পার্থক্য করে। সেখানে প্রয়োজনীয় এন্ট্রিগুলো পর্যালোচনা করুন, তবে সেগুলোর ভ্যালু কোনো ট্রাবলশুটিং প্রম্পটে কপি করবেন না।

1. প্রয়োজনীয় ভেরিয়েবলের নামের একটি তালিকা চান: প্রতিটি কোথায় পড়া হয় এবং সেটি বিল্ড টাইমে নাকি রানটাইমে ব্যবহৃত হয়।
2. যাচাই করুন যে প্রোডাকশন এন্ট্রিগুলো ঠিক ওই নামগুলোর সাথে মেলে এবং কাঙ্ক্ষিত প্রোভাইডার অ্যাকাউন্টেরই।
3. সার্ভারের ক্রেডেনশিয়াল সার্ভারেই রাখুন; ফ্রন্টএন্ড ভেরিয়েবল বা ব্রাউজার বান্ডল কোনো সিক্রেট স্টোর নয়।
4. প্ল্যাটফর্ম বা বিল্ড প্রসেসের প্রয়োজন হলে আবার পাবলিশ করুন, তারপর পাবলিক URL-এ মূল অ্যাকশনটি পুনরায় করুন।

পাবলিশ করা অ্যাপ কি কাঙ্ক্ষিত ডেটাবেস থেকেই পড়ছে?

অনুপস্থিত প্রোডাকশন রেকর্ডকে ভাঙা ইন্টারফেস ধরে নেওয়ার আগে লাইভ ডেটাবেস শনাক্ত করুন। ডেভেলপমেন্টে দেখা স্যাম্পল ডেটা হয়তো আপনার গ্রাহকদের অ্যাপ যে ডেটা পড়ে, তা নয়।

Replit-এর ডেভেলপমেন্ট ও প্রোডাকশন ডেটাবেস গাইড আলাদা এনভায়রনমেন্ট এবং বর্তমান ও লিগ্যাসি ইনফ্রাস্ট্রাকচারের জন্য ভিন্ন সেটআপ পদ্ধতি বর্ণনা করে। Database টুলে প্রোডাকশন সিলেকশন এবং আপনার অ্যাপের জন্য প্রযোজ্য পাবলিশিং সেটিংস পরীক্ষা করুন। ভিন্ন প্রজন্মের প্রজেক্টের কোনো টিউটোরিয়াল আপনারটার সাথে মিলবে বলে ধরে নেবেন না।

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

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

পাবলিক ডোমেইনে ফাইল ও এক্সটার্নাল কলব্যাক কি কাজ করে?

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

আপলোডের জন্য Replit App Storage পারসিস্টেন্ট অবজেক্ট স্টোরেজ দেয়। রানটাইম ফোল্ডারে লেখা ফাইলে আপনার প্রোডাক্টের প্রয়োজনীয় পারসিস্টেন্স ও অ্যাক্সেস কন্ট্রোল আছে বলে ধরে না নিয়ে বর্তমান ইমপ্লিমেন্টেশন পরীক্ষা করুন। একটি নিয়ন্ত্রিত রিলিজের পর ফাইল আপলোড, পুনরুদ্ধার এবং অ্যাক্সেস সীমিত করা টেস্ট করুন।

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

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

লাইভ সমাধান কীভাবে যাচাই করবেন?

পাবলিক URL-এ মূল অ্যাকশনটি আবার করুন, তারপর মিলে যাওয়া প্রোডাকশন প্রমাণ পরীক্ষা করুন। সফল পাবলিশ মানে রিলিজ সম্পন্ন হয়েছে; এটি প্রমাণ করে না যে গ্রাহকের প্রতিটি ওয়ার্কফ্লো সফল হয়েছে।

Replit-এর Monitoring গাইড রিকোয়েস্ট স্ট্যাটাস, রেসপন্স সময়, রিসোর্স ব্যবহার এবং অ্যাপ্লিকেশন লগ ব্যাখ্যা করে। তদন্ত সংকুচিত করতে ব্যর্থ অ্যাকশনের টাইমস্ট্যাম্প ব্যবহার করুন। উচ্চ রিসোর্স ব্যবহার আর অ্যাপ্লিকেশন এরর ভিন্ন ফলাফল, তাই ক্যাপাসিটি বদলানোর আগে কারণ নির্ণয় করুন।

1. পাবলিশ করা ডোমেইনে একটি নতুন অ্যাকাউন্ট দিয়ে ঠিক সেই ব্যর্থ যাত্রাটি আবার করুন।
2. পেজ রিফ্রেশ করার পর কাঙ্ক্ষিত রেকর্ড বা ইন্টিগ্রেশনের ফলাফল আছে কি না নিশ্চিত করুন।
3. মিলে যাওয়া সার্ভার রিকোয়েস্ট বা লগ দেখুন, তারপর নিরাপদে কাছাকাছি একটি ব্যর্থতার কেস টেস্ট করুন।
4. ফোনে মূল যাত্রাটি আবার করুন এবং আগের কার্যকর আচরণ এখনো কাজ করছে কি না যাচাই করুন।

ডিপ্লয়মেন্টে যদি এখনো ডেভেলপমেন্টের কাজ লাগে?

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

অডিয়েন্স বাড়ানোর আগে বিস্তৃত AI MVP প্রোডাকশন চেকলিস্ট ব্যবহার করুন, অথবা বারবার প্রম্পট দেওয়ায় রিগ্রেশন তৈরি হলে ফিক্স-লুপ গাইড দেখুন। পরবর্তী ভার্সন পর্যালোচনা ও শিপ করতে সাহায্যের জন্য আপনার Replit অ্যাপ নিয়ে একটি কল বুক করুন। আপনার কি কনফিগারেশন মেরামত, নির্দিষ্ট কোড পরিবর্তন নাকি বড় রিলিজ পরিকল্পনা দরকার, তা আমরা একসাথে ঠিক করতে পারি।