কন্ডাক্টর প্লাগইন দিয়ে অ্যাপ পরিকল্পনা ও নির্মাণ করুন

১. ভূমিকা

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

আপনি যা করবেন

  • Antigravity CLI বা Claude Code-এ Conductor প্লাগইনটি ইনস্টল করুন।
  • কন্ডাক্টরের পরিকল্পনা এবং বাস্তবায়ন ক্ষমতা ব্যবহার করে শুরু থেকে একটি "পিকার হুইল" ওয়েব অ্যাপ তৈরি করুন।
  • Firebase ব্যবহার করে অথেনটিকেশন এবং স্টোরেজ যোগ করার মাধ্যমে অ্যাপ্লিকেশনটিতে ব্যক্তিগতকরণ যুক্ত করুন।

আপনি যা শিখবেন

  • একটি "গ্রিনফিল্ড" অ্যাপ্লিকেশনের পরিকল্পনা, বাস্তবায়ন এবং পর্যালোচনার জন্য কন্ডাক্টর প্লাগইন কীভাবে ব্যবহার করবেন
  • একটি 'ব্রাউনফিল্ড' অ্যাপ্লিকেশনে ফিচার যোগ করতে কন্ডাক্টর প্লাগইন কীভাবে ব্যবহার করবেন

আপনার যা যা লাগবে

২. শুরু করার আগে

একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন

  1. গুগল ক্লাউড কনসোলের প্রজেক্ট সিলেক্টর পেজে, একটি গুগল ক্লাউড প্রজেক্ট নির্বাচন করুন বা তৈরি করুন
  2. আপনার ক্লাউড প্রোজেক্টের জন্য বিলিং চালু আছে কিনা তা নিশ্চিত করুন। কোনো প্রোজেক্টে বিলিং চালু আছে কিনা তা কীভাবে পরীক্ষা করবেন, তা জেনে নিন।

ক্লাউড শেল শুরু করুন

ক্লাউড শেল হলো গুগল ক্লাউডে চালিত একটি কমান্ড-লাইন পরিবেশ, যা প্রয়োজনীয় টুলস সহ আগে থেকেই লোড করা থাকে।

  1. Google Cloud কনসোলের শীর্ষে থাকা Activate Cloud Shell-এ ক্লিক করুন।
  2. ক্লাউড শেলে সংযুক্ত হওয়ার পর, আপনার প্রমাণীকরণ যাচাই করুন:
    gcloud auth list
    
  3. আপনার প্রজেক্টটি কনফিগার করা হয়েছে কিনা তা নিশ্চিত করুন:
    gcloud config get project
    
  4. আপনার প্রজেক্টটি প্রত্যাশা অনুযায়ী সেট করা না থাকলে, এটি সেট করুন:
    export PROJECT_ID=<YOUR_PROJECT_ID>
    gcloud config set project $PROJECT_ID
    

এপিআই সক্ষম করুন

আপনার গুগল ক্লাউড প্রজেক্টে ফায়ারবেস ম্যানেজমেন্ট এপিআই সক্রিয় করুন।

gcloud services enable firebase.googleapis.com

আপনার প্রজেক্টে ফায়ারবেস যোগ করুন

ক্লাউড শেলে ফায়ারবেস সিএলআই আগে থেকেই ইনস্টল করা থাকে। ক্লাউড শেল থেকে, সেই একই গুগল অ্যাকাউন্ট দিয়ে সাইন ইন করুন যা আপনাকে গুগল ক্লাউড প্রজেক্টে অ্যাক্সেস দেয়। আপনি যদি স্থানীয়ভাবে কাজ করেন, তাহলে নির্দেশাবলী অনুসরণ করে ফায়ারবেস সিএলআই ইনস্টল করুন।

firebase login

আপনার গুগল ক্লাউড প্রজেক্টে ফায়ারবেস যোগ করতে নিম্নলিখিত কমান্ডটি চালান:

firebase projects:addfirebase

আপনি যদি প্রথমবারের মতো firebase CLI চালান, তাহলে আপনাকে জিজ্ঞাসা করা যেকোনো প্রশ্নের উত্তর দিন।

ক্লাউড শেল থেকে প্রস্থান করুন

আপনি ক্লাউড শেল উইন্ডোটি বন্ধ করতে পারেন। পরবর্তী অংশে আমরা আপনার স্থানীয় পরিবেশ কনফিগার করব।

৩. CLI কোডিং এজেন্ট ইনস্টল এবং প্রমাণীকরণ করুন

এই ধাপে, আপনি আপনার গুগল ক্লাউড ক্রেডেনশিয়াল ব্যবহার করে আপনার স্থানীয় কোড এডিটরে অ্যান্টিগ্র্যাভিটি সিএলআই (Antigravity CLI) অথবা ক্লড কোড (Claude Code) ইনস্টল ও অথেন্টিকেট করার মাধ্যমে আপনার স্থানীয় ডেভেলপমেন্ট এনভায়রনমেন্ট প্রস্তুত করবেন।

Antigravity CLI ইনস্টল এবং প্রমাণীকরণ করুন

  1. Antigravity CLI-এর সর্বশেষ সংস্করণটি ইনস্টল করুন
    # MacOS and Linux
    curl -fsSL https://antigravity.google/cli/install.sh | bash
    
    # Windows Powershell
    irm https://antigravity.google/cli/install.ps1 | iex
    
    # Windows CMD
    curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
    
  2. আপনার টার্মিনালটি পুনরায় চালু করুন , যাতে agy আপনার PATH-এ যুক্ত হয়।
  3. যাচাই করুন যে ইনস্টলেশনটি সর্বশেষ সংস্করণটি ইনস্টল করেছে।
    agy --version
    
  4. আপনার গুগল ক্লাউড ক্রেডেনশিয়াল ব্যবহার করে প্রমাণীকরণ করুন
    • অ্যান্টিগ্র্যাভিটি সিএলআই চালু করুন।
      agy
      
    • যখন লগইন পদ্ধতি নির্বাচন করতে বলা হবে, তখন ‘Use a Google Cloud project’ নির্বাচন করুন। একটি ওয়েব ব্রাউজারে সুরক্ষিত অথরাইজেশন ইউআরএলটি খুলুন। আপনার অনুমোদিত ক্রেডেনশিয়াল দিয়ে সাইন ইন করুন এবং অথেন্টিকেশন সম্পন্ন করুন। ব্রাউজারটি একটি অনন্য আলফানিউমেরিক অথরাইজেশন কোড প্রদর্শন করবে। এই কোডটি কপি করুন, আপনার টার্মিনালে ফিরে যান এবং প্রম্পটে পেস্ট করুন।
  5. অ্যান্টিগ্র্যাভিটি সিএলআই থেকে প্রস্থান করুন। চালিয়ে যাওয়ার আগে আপনার লাইভ অ্যান্টিগ্র্যাভিটি সিএলআই সেশনটি শেষ করতে সিএলআই টার্মিনাল থেকে /exit টাইপ করুন।

ক্লড কোড ইনস্টল এবং প্রমাণীকরণ করুন

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

  1. Claude Code-এর সর্বশেষ সংস্করণটি ইনস্টল করুন
  2. আপনার গুগল ক্লাউড ক্রেডেনশিয়াল ব্যবহার করে প্রমাণীকরণ করুন
    • ক্লড কোড শুরু করুন।
      claude
      
    • আপনার লগইন পদ্ধতি নির্বাচন করতে /login টাইপ করুন। থার্ড-পার্টি প্ল্যাটফর্ম বিকল্পটি বেছে নিন – অ্যামাজন বেডরক, মাইক্রোসফট ফাউন্ড্রি, অথবা ভার্টেক্স এআই এবং গুগল ভার্টেক্স এআই । গুগল ভার্টেক্স এআই সেট আপ করতে, অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়ালস (গুগল অথ) বেছে নিন এবং নির্দেশ অনুযায়ী সেটআপটি সম্পূর্ণ করুন।
  3. ক্লড কোড পুনরায় চালু করুন

৪. কন্ডাক্টর প্লাগইনটি ইনস্টল করুন

কন্ডাক্টর হলো গুগল নির্মিত একটি ওপেন-সোর্স প্লাগইন, যা পরিকল্পনা এবং বাস্তবায়ন ট্র্যাকিংয়ের মতো স্পেক-চালিত ডেভেলপমেন্ট ফিচারগুলো সক্ষম করে।

অ্যান্টিগ্র্যাভিটি সিএলআই-তে ইনস্টল করুন

  1. প্লাগইনটি ইনস্টল করুন :
    • অ্যান্টিগ্র্যাভিটি সিএলআই
      agy plugins install https://github.com/gemini-cli-extensions/conductor
      
  2. ইনস্টলেশন যাচাই করুন :
    • অ্যান্টিগ্র্যাভিটি সিএলআই চালু করুন।
      agy
      
    • /conductor টাইপ করলে আপনি /conductor:conductor-setup , /conductor:conductor-new-track , conductor:conductor-implement , ইত্যাদির মতো কমান্ডের একটি তালিকা দেখতে পাবেন।
  3. CLI থেকে প্রস্থান করুন। চালিয়ে যাওয়ার আগে আপনার লাইভ CLI সেশনটি শেষ করতে টার্মিনাল থেকে /exit টাইপ করুন।

ক্লড কোডে ইনস্টল করুন

  1. মার্কেটপ্লেস রিপোজিটরিটি রেজিস্টার করুন এবং সরাসরি আপনার ক্লড কোড সেশনে কন্ডাক্টর প্লাগইনটি ইনস্টল করুন।
    /plugin marketplace add gemini-cli-extensions/conductor
    /plugin install conductor
    /reload-plugin
    
  2. ইনস্টলেশনটি যাচাই করুন
    • /conductor টাইপ করলে আপনি /conductor-setup , conductor-new-track , conductor-implement ইত্যাদির মতো কমান্ডের একটি তালিকা দেখতে পাবেন।
  3. CLI থেকে প্রস্থান করুন। চালিয়ে যাওয়ার আগে আপনার লাইভ CLI সেশনটি শেষ করতে Claude Code টার্মিনাল থেকে /exit টাইপ করুন।

৫. গ্রিনফিল্ড ডেভেলপমেন্ট: দ্য পিকার হুইল

এখন যেহেতু আপনার পরিবেশ প্রস্তুত, আপনি একেবারে শুরু থেকে একটি নতুন অ্যাপ্লিকেশন তৈরি করবেন। আপনি একটি "পিকার হুইল" তৈরি করবেন — এটি একটি হালকা ওয়েব অ্যাপ যা ঘুরে একটি র‍্যান্ডম অপশন বেছে নেয়।

পণ্যের প্রেক্ষাপট সেটআপ করুন

  1. একটি নতুন প্রজেক্ট ডিরেক্টরি তৈরি করুন এবং তাতে প্রবেশ করুন । আমরা এখন একটি picker-wheel ডিরেক্টরিতে একটি প্রজেক্টে কাজ করছি। এই ডিরেক্টরিটি তৈরি করুন এবং এতে প্রবেশ করুন।
    mkdir picker-wheel
    cd picker-wheel
    
  2. Antigravity CLI চালু করুন । আপনার প্রজেক্ট ডিরেক্টরি থেকে Antigravity CLI অথবা Claude Code ব্যবহার করে একটি নতুন CLI সেশন শুরু করুন।
    # Antigravity CLI
    agy
    
    # Claude Code
    claude
    
    • যখন জিজ্ঞাসা করা হবে "আপনি কি এই ফোল্ডারের ফাইলগুলিকে বিশ্বাস করেন?", তখন ট্রাস্ট ফোল্ডার (পিকার-হুইল) নির্বাচন করুন।
  3. Conductor চালু করুন । প্রজেক্টটি স্ক্যাফোল্ড করতে এবং Conductor এনভায়রনমেন্ট সেট আপ করতে সেটআপ কমান্ডটি চালান।
    # Antigravity CLI
    /conductor:conductor-setup
    
    # Claude Code
    /conductor-setup
    
  4. ইন্টারেক্টিভ নির্দেশাবলী অনুসরণ করুন । আপনি যে ইন্টারেক্টিভ নির্দেশাবলী দেখবেন তা এই উদাহরণগুলোর সাথে হুবহু মিলবে না। কন্ডাক্টর ওয়ার্কফ্লোর সাথে পরিচিত হওয়ার জন্য একটি সরল ডিজাইনের উপর মনোযোগ দিন।
    • পণ্যের লক্ষ্য : এমন একটি ওয়েব অ্যাপ্লিকেশন তৈরি করা, যা একটি তালিকা থেকে দৈবচয়নের মাধ্যমে কোনো একটি আইটেম বেছে নেওয়ার জন্য একটি কনফিগারযোগ্য ঘূর্ণায়মান চাকা প্রদর্শন করবে।
      • লক্ষ্য দর্শক → সাধারণ জনগণ
      • মিথস্ক্রিয়া → ঘোরানোর জন্য ট্যাপ/ক্লিক করুন
      • কাস্টমাইজেশন → বেসিক
      • প্ল্যাটফর্ম → ডেস্কটপ-প্রথম
    • পণ্য নির্দেশিকা : স্বয়ংক্রিয়ভাবে তৈরি করুন।
    • টেক স্ট্যাক :
      • ভাষা → টাইপস্ক্রিপ্ট/জাভাস্ক্রিপ্ট - ফুল-স্ট্যাক ওয়েবের জন্য আদর্শ
      • ফ্রন্টএন্ড → Vue.js - স্বজ্ঞামূলক ওয়েব ইন্টারফেস
      • ব্যাকএন্ড → এক্সপ্রেস.জেএস - দ্রুত নোড ব্যাকএন্ড
      • ডাটাবেস → নেই - কোনো ডাটাবেসের প্রয়োজন নেই
    • কার্যপ্রবাহ : প্রমিত।
    • পণ্যের প্রয়োজনীয়তা :
      • ব্যবহারকারীর গল্প → কাস্টমাইজযোগ্য বিকল্প, সুস্পষ্ট বিজয়ী প্রদর্শন
      • মূল বৈশিষ্ট্য → সম্পাদনাযোগ্য বিকল্প তালিকা, এলোমেলো রং
      • সীমাবদ্ধতা → শুধুমাত্র ক্লায়েন্ট-সাইড, উচ্চ কর্মক্ষমতা
      • নন-ফাংশনাল → উচ্চ টেস্ট কভারেজ, টাইপস্ক্রিপ্ট ও ভিউ.জেএস, রেসপন্সিভ ডিজাইন
    কন্ডাক্টর conductor/ ডিরেক্টরিতে কনটেক্সট ফাইল তৈরি করবে।

একটি নতুন ট্র্যাক তৈরি করুন

কন্ডাক্টর-এ একটি "ট্র্যাক" কোনো একটি বৈশিষ্ট্য বা কাজের একককে বোঝায়।

  1. /conductor-new-rack ব্যবহার করে একটি নতুন ট্র্যাক শুরু করুন । কন্ডাক্টর প্রোডাক্ট কনটেক্সটের উপর ভিত্তি করে একটি প্রাথমিক ট্র্যাক প্রস্তাব করতে পারে। বিকল্পভাবে, আপনি নিজের ট্র্যাক প্রস্তাব করতে পারেন অথবা কন্ডাক্টরকে একটি ট্র্যাক সাজেস্ট করতে বলতে পারেন।
  2. তৈরি হওয়া প্ল্যানটি পর্যালোচনা করুনconductor/tracks/{track-id}/ ভিতরে একটি index.md , একটি spec.md এবং একটি plan.md তৈরি করবে। ফাইলগুলো পড়ার জন্য একটু সময় নিন। সবকিছু ঠিকঠাক মনে হলে, Conductor আপনাকে প্রাথমিক সেটআপ ফাইলগুলো সেভ এবং কমিট করার জন্য বলবে।

ট্র্যাকটি বাস্তবায়ন করুন

  1. বাস্তবায়ন শুরু করুন
    # Antigravity CLI
    /conductor:conductor-implement
    
    # Claude Code
    /conductor-implement
    
    কন্ডাক্টর এখন পরিকল্পনাটি নিয়ে কাজ করবে এবং প্রকল্পটির জন্য কোড লিখবে।
  2. অ্যাপ্লিকেশনটি যাচাই করুন । বাস্তবায়ন পর্ব জুড়ে, কন্ডাক্টর আপনাকে অ্যাপ্লিকেশনটি ম্যানুয়ালি পরীক্ষা করার জন্য অনুরোধ করবে। উদাহরণস্বরূপ, এটি আপনাকে স্থানীয় ওয়েব সার্ভার খুলতে, আপনার ব্রাউজারে অ্যাপ্লিকেশনটির প্রিভিউ দেখতে এবং পরিবর্তনগুলি যাচাই করতে বলবে। বাস্তবায়ন সম্পূর্ণ হলে, আপনি একটি কার্যকরী পিকার হুইল দেখতে পাবেন। পিকার হুইল অ্যাপ্লিকেশন
  3. বাস্তবায়নটি পর্যালোচনা করুন । শেষ ধাপ হিসেবে, আপনি কন্ডাক্টরকে (Conductor) বাস্তবায়নটি পর্যালোচনা করতে বলতে পারেন। এটির কাজ হলো সোর্স কোড পর্যালোচনা করা, প্রোজেক্টের ডকুমেন্টেশন সিঙ্ক্রোনাইজ করা এবং ট্র্যাকটি আর্কাইভ করা।
    # Antigravity CLI
    /conductor:conductor-review
    
    # Claude Code
    /conductor-review
    

৬. ব্রাউনফিল্ড ইটারেশন: ব্যক্তিগতকরণ যোগ করুন

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

একটি ব্যক্তিগতকরণ ট্র্যাক তৈরি করুন

  1. নিম্নলিখিত 'ব্রাউনফিল্ড' উদাহরণে, আমরা প্রমাণীকরণ এবং সংরক্ষণের জন্য ফায়ারবেস ব্যবহার করব। ফায়ারবেস স্কিলগুলো ইনস্টল করুন যাতে কন্ডাক্টর এটি ব্যবহার করতে পারে।
  2. আপনার CLI এজেন্ট চালু করুন । একটি নতুন CLI সেশন শুরু করুন।
    # Antigravity CLI
    /new
    
    # Claude Code
    /new
    
  3. নতুন একটি ট্র্যাক শুরু করুন । নতুন একটি ট্র্যাক শুরু করুন।
    # Antigravity CLI
    /conductor:conductor-new-track "I want users to be able to log in to their
    accounts and save their picker wheel configurations."
    
    # Claude Code
    /conductor-new-track "I want users to be able to log in to their accounts
    and save their picker wheel configurations."
    
  4. ইন্টারেক্টিভ নির্দেশাবলী অনুসরণ করুন । আপনি যে ইন্টারেক্টিভ নির্দেশাবলী দেখবেন তা এই উদাহরণগুলোর সাথে হুবহু মিলবে না। কন্ডাক্টর ওয়ার্কফ্লোর সাথে পরিচিত হওয়ার জন্য একটি সরল ডিজাইনের উপর মনোযোগ দিন।
    • ট্র্যাকের লক্ষ্য :
      • প্রমাণীকরণ প্রদানকারী → ফায়ারবেস প্রমাণীকরণ
      • সংরক্ষিত কনফিগারেশন → চাকার বিকল্প
      • ডেটা স্টোরেজ → ফায়ারস্টোর
      • ফায়ারস্টোর লগইন UI → মোডাল ওভারলে
    কন্ডাক্টর conductor/tracks/{track-id} এর ভিতরে একটি নতুন ট্র্যাকের জন্য কনটেক্সট ফাইল তৈরি করবে।
  5. তৈরি হওয়া প্ল্যানটি পর্যালোচনা করুনconductor/tracks/{track-id}/ এর ভেতরে থাকা index.md , spec.md এবং plan.md ফাইলগুলো পড়ার জন্য একটু সময় নিন।
  6. বাস্তবায়ন করুন । সবকিছু ঠিকঠাক মনে হলে, আপনি বাস্তবায়ন শুরু করতে পারেন।
    # Antigravity CLI
    /conductor:conductor-implement
    
    # Claude Code
    /conductor-implement
    
  7. যাচাই করুন । আপনার অ্যাপ্লিকেশনটি রিলোড করুন। আপনি একটি আপডেট হওয়া অ্যাপ্লিকেশন দেখতে পাবেন।সাইন ইন সহ পিকার হুইল

এখানে একটি রেফারেন্স ইমপ্লিমেন্টেশনের জন্য মূল কোডটি দেওয়া হলো। আপনার অ্যাপ্লিকেশনটি সঠিকভাবে চালু করার জন্য আপনাকে অবশ্যই .firebaserc ফাইলে আপনার Firebase প্রজেক্ট এবং firebase.ts ফাইলে আপনার Firebase কনফিগারেশনগুলো প্রদান করতে হবে।

৭. পরিষ্কার করুন

আপনার গুগল ক্লাউড অ্যাকাউন্টে চলমান চার্জ এড়াতে, এই কোডল্যাব চলাকালীন তৈরি করা রিসোর্সগুলো মুছে ফেলুন।

ফায়ারবেস প্রজেক্ট এবং গুগল ক্লাউড প্রজেক্ট মুছে ফেলুন

পরিষ্কার করার সবচেয়ে সহজ উপায় হলো প্রজেক্টটি পুরোপুরি মুছে ফেলা।

  1. গুগল ক্লাউড কনসোলে , আপনার তৈরি করা প্রজেক্টটি নির্বাচন করুন।
  2. ডিলিট-এ ক্লিক করুন।

বিকল্পভাবে, যদি আপনি প্রজেক্টটি রাখতে চান কিন্তু রিসোর্সগুলো মুছে ফেলতে চান:

  1. ফায়ারস্টোর ডেটাবেস মুছুন : ফায়ারবেস কনসোল > ফায়ারস্টোর- এ যান এবং ডেটাবেসটি মুছে ফেলুন।
  2. প্রমাণীকরণ মুছুন : Firebase কনসোল > প্রমাণীকরণ সাইন-ইন পদ্ধতিতে যান, Google নিষ্ক্রিয় করুন।

৮. অভিনন্দন

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

পরবর্তী পদক্ষেপ