বিকাশকারীদের জন্য
বিকাশকারীরা - VTC এ অ্যাপ তৈরি করুন
সর্বজনীন কার্সার রুল প্যাক ডাউনলোড করুন, অ্যাডমিন হিসাবে আপনার স্পেসে একটি অ্যাপ নিবন্ধন করুন, গিট রিমোট ক্লোন করুন এবং একটি সাধারণ গিট পুশ দিয়ে apps.vtc.com এ স্থাপন করুন৷
কার্সার নিয়ম প্যাক
পাবলিক রিপোজিটরি - শুধুমাত্র অ্যাপ লেখার নিয়ম। আপনার প্রজেক্টে .cursor/rules/ হিসাবে কপি করুন (কখনও সিমলিংক করবেন না; আপনার অ্যাপ রেপোতে .cursor/ কমিট করবেন না)।
git clone https://github.com/vtcdotcom/vtc-app-rules.git ~/vtc-app-rulesgit clone [email protected]:vtcdotcom/vtc-app-rules.git ~/vtc-app-rules~/vtc-app-rules/scripts/copy-cursor-rules.sh /path/to/your-app- আপনার অ্যাপ ফোল্ডার রুটে কার্সার খুলুন — ওয়ার্কস্পেস প্রতি একটি অ্যাপ।
- স্ক্যাফোল্ডিং করার সময় কার্সারকে scaffold-checklist.mdc অনুসরণ করতে বলুন।
- শেয়ার্ড অ্যাপস প্রতি স্পেস ডেটা আইসোলেট করে; ডেডিকেটেড অ্যাপস একটি প্রকাশক ডাটাবেস ব্যবহার করে।
- পুল নিয়ম পর্যায়ক্রমে আপডেট করে এবং কপি-কারসর-রুলস.শ পুনরায় চালান।
এটা কিভাবে কাজ করে
আপনি কার্সার দিয়ে স্থানীয়ভাবে অ্যাপ তৈরি করেন। VTC এটি হোস্ট করে, ডিপ্লোয় করার সময় auth এবং প্ল্যাটফর্ম env ইনজেক্ট করে এবং আপনার স্পেস ক্যাটালগ থেকে এটি পরিবেশন করে।
- 1
কার্সার নিয়ম ক্লোন করুন
পাবলিক vtc-app-রুলস সংগ্রহস্থল ক্লোন করুন (উপরে)। এগুলি হল আমাদের AI এবং বিল্ড পাইপলাইনের প্রত্যাশিত মান — auth, env ফাইল, অ্যাপ শেল, i18n এবং ডিপ্লয় লেআউট।
- 2
VTC এ সাইন ইন করুন
অ্যাপটি যেখানে থাকবে সেখানে অ্যাডমিন অ্যাক্সেস সহ একটি অ্যাকাউন্ট ব্যবহার করুন।
https://app.vtc.com - 3
আপনার স্পেসে অ্যাপটি তৈরি করুন
অ্যাপ ড্যাশবোর্ডে, আপনার Space → Apps → Create খুলুন। অ্যাপের নাম, সংক্ষিপ্ত নাম, শেয়ার করা বনাম ডেডিকেটেড স্থাপনা এবং ক্যাটালগ দৃশ্যমানতা (স্পেস, নেটওয়ার্ক বা প্ল্যাটফর্ম) সেট করুন।
- 4
গিট রিমোট কপি করুন
অ্যাপটি তৈরি হওয়ার পরে, এর বিকাশকারী সেটিংস খুলুন এবং গিট URL (SSH বা HTTPS) অনুলিপি করুন। সেই রিমোট যেখানে আপনি কোড পুশ করেন — প্ল্যাটফর্মটি প্রতিটি ধাক্কায় তৈরি করে এবং স্থাপন করে।
- 5
কার্সারে স্থানীয়ভাবে ভারা
আপনার প্রোজেক্ট ফোল্ডারে নিয়ম অনুলিপি করুন, সেই ফোল্ডারটি কার্সারে খুলুন (অনেক রেপো সহ একটি মূল ডিরেক্টরি নয়), এবং scaffold-checklist.mdc ব্যবহার করে স্ক্যাফোল্ড করুন। ধাপ 4 থেকে গিট রিমোটে আপনার স্থানীয় রেপো নির্দেশ করুন।
- 6
প্রকাশ করতে চাপ দিন
প্রতিশ্রুতিবদ্ধ করুন এবং অ্যাপ রিমোটে পুশ করুন। বিল্ড পরিষেবা আপনার ছবি বা স্ট্যাটিক বান্ডেল তৈরি করে এবং এটি প্রকাশকের হোস্টনামে পরিবেশন করে — কোনও ম্যানুয়াল ডিপ্লোয় স্টেপ নেই।
লাইভ URL প্যাটার্ন:
https://myapp.apps.vtc.com
স্ট্যাটিক Vite অ্যাপ সঙ্গে সঙ্গে পুশ ও প্রকাশ করা যায়। Next.js অ্যাপ সার্ভার কোড চালায়, তাই আপনার Space বিশ্বস্ত ডেভেলপার হিসেবে অনুমোদিত হলে তবেই সেগুলো ডিপ্লয় হয়। অনুমোদনের জন্য ইমেইল করুন: [email protected].
কার্সরে স্পেস MCP
কার্সর (বা Claude / VS Code) কে এমন একটি স্পেসের সাথে সংযুক্ত করুন যার আপনি ইতিমধ্যে সদস্য। MCP স্পেস-স্কোপড — VTC-এ বাইরের প্রোডাক্ট ডেটাবেস যোগ করার উপায় নয়।
- 1
সংযুক্ত করুন
কার্সর সেটিংস → MCP-এ https://mcp.vtc.com/mcp যোগ করুন (কনফিগ নিচে)। Connect ক্লিক করুন — VTC লগইনের জন্য ব্রাউজার খুলবে।
- 2
সাইন ইন করুন এবং একটি স্পেস বেছে নিন
পপআপে OTP সম্পন্ন করুন, আপনার স্পেস বেছে নিন, তারপর কার্সরে ফিরুন। ক্লায়েন্ট টোকেন নিজেই সংরক্ষণ ও রিফ্রেশ করে।
- 3
সেই স্পেসের বিপরীতে জিজ্ঞাসা করুন
শেয়ার্ড অ্যাপ ডেটা দেখুন (list_collections → sample/find), ক্যাটালগ ও ম্যানিফেস্ট, গাইড অ্যাকশন (list_available_actions → execute_action), অথবা ওয়ার্কফ্লো প্রস্তাব/চালান। মিউটেশন ও আসল ওয়ার্কফ্লো রানের জন্য আগে আপনাকে দেখানো confirmation_token লাগে।
{
"mcpServers": {
"vtc-space-db": {
"type": "http",
"url": "https://mcp.vtc.com/mcp"
}
}
}ইন্টারঅ্যাকটিভ ক্লায়েন্ট OAuth Connect ব্যবহার করে (ব্রাউজার লগইন + স্পেস পিকার)। হেডলেস এজেন্ট এর বদলে ডেভেলপার হেল্প অ্যাডমিন JWT Bearer হিসেবে পাঠাতে পারে।
- প্রযোজ্য ক্ষেত্রে ইন-প্রোডাক্ট গাইডের মতোই রোল গেট ও বিলিং পথ।
- CI / হেডলেস: ডেভেলপার হেল্পে একটি অ্যাডমিন JWT তৈরি করুন এবং MCP হেডারে Authorization: Bearer <jwt> সেট করুন।
- DB টুলের জন্য অন্য group_id তৈরি করবেন না — সাইলো শুধু JWT স্পেস।
নিয়ম কভার কি
প্রমাণ ও স্থান
JWT এর মাধ্যমে ?token= শেল থেকে, স্থানীয় স্টোরেজ বুটস্ট্র্যাপ এবং শেয়ার্ড অ্যাপের জন্য group_id স্কোপিং।
UI এবং i18n
স্ট্যান্ডার্ড অ্যাপ শেল, Tailwind v4, রানটাইম অ্যাকসেন্ট রং, এবং প্রথম দিন থেকে লোকেল ফাইল।
API এবং ডেটা
ভাড়াটে প্রোডাকশন ডিবি অ্যাক্সেসের জন্য CRUD রুট, সফট ডিলিট, env-চালিত URL এবং @posif/sdk।
স্থাপন করুন
শুধুমাত্র অ্যাপ-মালিকানাধীন কীগুলির জন্য প্রতিশ্রুতিবদ্ধ .env.production; প্ল্যাটফর্ম এপিআই ইউআরএল, মঙ্গোডিবি, এবং বিল্ড এ আইডেন্টিটি ইনজেক্ট করে।
ভিটিসি লেজার
অপরিবর্তনীয় রেকর্ড, অন-চেইন প্রুফ এবং ওয়ালেট সাইনিং-এর জন্য অনুমোদিত, গ্যাসবিহীন ইভিএম - যখন আপনার টেম্পার-প্রুফ ইস্যু করার প্রয়োজন হয় তখন অ্যাপগুলি থেকে একত্রিত করুন।
নির্মাণের জন্য প্রস্তুত?
নিয়মগুলি ক্লোন করুন, আপনার স্পেসে অ্যাপ তৈরি করুন এবং আপনি প্রস্তুত হলে চাপ দিন।