সিক্রেট ও এনভায়রনমেন্ট ভেরিয়েবল

আপনার Convex backend-এর জন্য API কী এবং environment variable পরিচালনা করুন।

Settings শিট খুলতে builder টুলবারের Settings বাটনে ক্লিক করুন। এতে তিনটি সেকশন রয়েছে:

সেকশন	কী কাজে লাগে
General	প্রজেক্টের নাম ও নলেজ বেস
SEO & sharing	সাইটের টাইটেল, বিবরণ এবং ফেভিকন সেট করা
Secrets	আপনার Convex backend-এর জন্য environment variable

সিক্রেট কীভাবে যোগ করব?

1. builder টুলবারের Settings বাটনে ক্লিক করুন
2. Secrets ট্যাবটি খুলুন
3. একটি নাম (যেমন STRIPE_SECRET_KEY) এবং মান লিখুন
4. Add বাটনে ক্লিক করুন

অ্যাপে সিক্রেট কীভাবে ব্যবহার করব?

সিক্রেটগুলো আপনার অ্যাপের Convex backend-এ sync হয়। Convex-এর action/mutation/query কোডে process.env.SECRET_NAME দিয়ে এগুলো রেফার করুন। এগুলো আপনার frontend কোডে বা pod-level environment variable হিসেবে পাওয়া যাবে না — এতে সিক্রেট ব্রাউজার bundle-এ ফাঁস হওয়া রোধ হয়।

ফিচার তৈরির সময় AI স্বয়ংক্রিয়ভাবে আপনার সিক্রেট ব্যবহার করে:

• "Accept payments with Stripe" → আপনার STRIPE_SECRET_KEY ব্যবহার করে
• "Send emails with Resend" → আপনার RESEND_API_KEY ব্যবহার করে
• "Add Google OAuth" → আপনার GOOGLE_CLIENT_ID এবং GOOGLE_CLIENT_SECRET ব্যবহার করে

সিক্রেটগুলো শুধুমাত্র আপনার Convex backend ফাংশনে (action এবং mutation) অ্যাক্সেসযোগ্য, frontend React কোডে নয়। AI এমন Convex ফাংশন তৈরি করে যেগুলো process.env এর মাধ্যমে সেগুলো পড়ে।

তৈরির পরে কি সিক্রেট দেখা বা সম্পাদনা করা যাবে?

সিক্রেটের মান ডিফল্টভাবে আড়াল করা থাকে। মান দেখতে, আপডেট করতে বা মুছে নতুন করে তৈরি করতে visibility টগল করতে পারবেন।

AI কি আমার সিক্রেট দেখতে পায়?

AI আপনার সিক্রেটের নাম দেখতে পারে, কিন্তু মান দেখতে পারে না। এতে সংবেদনশীল তথ্য প্রকাশ না করেও ফিচার তৈরির সময় সঠিক environment variable রেফার করা সম্ভব হয়।

সংবেদনশীল কী শনাক্তকরণ

Proyecta স্বয়ংক্রিয়ভাবে সাধারণ সংবেদনশীল কী প্যাটার্ন (API কী, টোকেন, পাসওয়ার্ড) শনাক্ত করে এবং UI-তে তাদের মান আড়াল করে রাখে।

সাইট মেটাডেটা

SEO & sharing সেকশন থেকে আপনি নিচেরগুলো সেট করতে পারবেন:

• Site title — ব্রাউজার ট্যাব ও সার্চ রেজাল্টে দেখায়
• Site description — SEO মেটা বিবরণের জন্য ব্যবহৃত হয়
• Favicon — ব্রাউজার ট্যাবে যে আইকনটি দেখা যায়

এই সেটিংসগুলো আপনার প্রজেক্টে সংরক্ষিত হয় এবং publish করার সময় প্রয়োগ হয়।

নলেজ বেস

Knowledge Base সেকশনে আপনি রেফারেন্স উপকরণ এবং প্রেক্ষাপট যোগ করতে পারবেন, যা AI আপনার অ্যাপ তৈরির সময় ব্যবহার করে। ব্র্যান্ড গাইডলাইন, টেকনিক্যাল স্পেসিফিকেশন, বা অন্য যেকোনো ডকুমেন্টেশন যোগ করুন যা AI-কে আরও ভালো সিদ্ধান্ত নিতে সাহায্য করে।

সচরাচর জিজ্ঞাসা

সিক্রেট কি এনক্রিপ্টেড?

সিক্রেটগুলো আপনার প্রজেক্টে সংরক্ষিত হয় এবং আপনার Convex deployment-এ sync হয়। এগুলো কখনও আপনার commit করা কোডে দেখা যায় না।

dev এবং production-এর জন্য কি আলাদা সিক্রেট রাখা যাবে?

এই মুহূর্তে, সিক্রেটগুলো আপনার development runtime এবং publish করা (production) Convex deployment উভয়েই প্রযোজ্য। প্রতিটি environment-এর জন্য আলাদা সিক্রেট ম্যানেজমেন্ট ভবিষ্যতের একটি রিলিজে আসার পরিকল্পনা রয়েছে।

যদি ভুলবশত কোনো সিক্রেট প্রকাশ পেয়ে যায়?

সঙ্গে সঙ্গে পুরানো সিক্রেটটি মুছুন, থার্ড-পার্টি প্রোভাইডারের কাছ থেকে কীটি বাতিল করুন এবং নতুন একটি তৈরি করুন।

সিক্রেট আর কানেক্টর-এর মধ্যে পার্থক্য কী?

সিক্রেট হলো raw environment variable যা আপনি নিজে পরিচালনা করেন। Connector হলো managed integration যেখানে Proyecta আপনার হয়ে credential সংরক্ষণ, authentication, token refresh এবং অডিট লগিং সামলায়। যখন পাওয়া যায় তখন connector ব্যবহার করুন (Stripe, Slack, Resend, ElevenLabs); যেসব সার্ভিসের এখনও connector নেই তাদের জন্য সিক্রেট ব্যবহার করুন।