প্রকল্প সম্পর্কে

## এটি কী LinkeGringo হলো একটি ওপেন সোর্স ওয়েব অ্যাপ্লিকেশন যা মার্কিন যুক্তরাষ্ট্রের টেকনিক্যাল রিক্রুটারদের স্ক্রিনিং মানদণ্ডের ওপর ভিত্তি করে লিঙ্কডইন প্রোফাইল বিশ্লেষণ এবং পুনর্লিখন করে। README-তে উল্লিখিত মূল সমস্যাটি হলো পেশাদার উপস্থাপনার অভাব: দায়িত্ব-কেন্দ্রিক নিষ্ক্রিয় বর্ণনা, পরিমাপযোগ্য প্রভাবের অভাব এবং যথাযথ টেকনিক্যাল ইংরেজিতে কথা বলার অসুবিধা। অ্যাপ্লিকেশনটি GitHub Pages-এর মাধ্যমে প্রকাশিত হয়েছে। ## ব্যবহারের যাত্রা README-তে বর্ণিত ফ্লোটি একটি কাঠামোগত পাইপলাইন অনুসরণ করে: ১. **PDF আপলোড**: ব্যবহারকারী লিঙ্কডইনের "Save as PDF" ফিচারের মাধ্যমে নিজের প্রোফাইল এক্সপোর্ট করেন এবং সেটি অ্যাপ্লিকেশনে ড্র্যাগ করেন। ২. **ইনবাউন্ড ডায়াগনস্টিক**: একটি ওয়েটেড *Inbound Readiness* মেট্রিক গণনা, রিটেনশন ফানেল (Search → Card → Profile → InMail) এবং প্রধান বাধা চিহ্নিতকরণ। ৩. **অ্যাডাপ্টিভ টেকনিক্যাল ইন্টারভিউ**: প্রকৃত মেট্রিক্স, স্কেল লিমিট এবং আর্কিটেকচারাল সিদ্ধান্তগুলো স্পষ্ট করার জন্য প্রশ্ন করা হয়। ৪. **তথ্য নিশ্চিতকরণ**: পুনর্লিখনের আগে টেকনিক্যাল তথ্যের স্পষ্ট পর্যালোচনা, যার ঘোষিত লক্ষ্য হলো হ্যালুসিনেশন (ভুল তথ্য তৈরি) এড়ানো। ৫. **Action Hub**: তিনটি ট্যাব — *My Profile* (LinkedIn Recruiter ফরম্যাটে তুলনামূলক কার্ড, আগে বনাম পরে, সরাসরি ট্রান্সফারযোগ্য সেকশন এবং ক্যারেক্টার কাউন্টারসহ), *Search* (রিক্রুটার সার্চ সিমুলেটর যেখানে MATCH, WEAK এবং MISSING মার্কিং থাকে) এবং *Launch* (লিঙ্কডইনের এক্সটার্নাল সেটিংস চেকলিস্ট, যেমন Open to Work, টার্গেট রোল, রিমোট লোকেশন এবং ইংরেজিতে সেকেন্ডারি প্রোফাইল)। ## গোপনীয়তা এবং আর্কিটেকচার README-তে একটি অডিটেবল প্রাইভেসি মডেলের ওপর জোর দেওয়া হয়েছে: - **কোনো ব্যাকএন্ড নেই**: অ্যাপ্লিকেশনটি একটি Single Page Application যা শুধুমাত্র ব্রাউজারে চলে। - **BYOK (Bring Your Own Key)**: প্রতিটি ব্যক্তি Google AI Studio থেকে বিনামূল্যে প্রাপ্ত নিজস্ব Google Gemini API কী ব্যবহার করেন। - **পরিদর্শনযোগ্য রিকোয়েস্ট**: নেটওয়ার্ক কলগুলো ব্রাউজার থেকে সরাসরি Google সার্ভারে (`generativelanguage.googleapis.com`) যায়, যা DevTools-এর *Network* ট্যাবে যাচাই করা সম্ভব। - **লোকাল স্টোরেজ**: API কী শুধুমাত্র ডিভাইসের `localStorage`-এ থাকে। ## স্ট্যাক এবং কোড সংগঠন প্রজেক্টটি একটি মনোরেপো (monorepo): - `packages/core` (`@linkegringo/core`): ডোমেইন, Zod স্কিমা, টাইপ এবং ডিটারমিনিস্টিক ফর্মুলা। - `packages/ai` (`@linkegringo/ai`): Gemini প্রোভাইডার (`@google/genai`), অফলাইন মক এবং প্রম্পট। - `apps/web` (`@linkegringo/web`): Vite এবং Tailwind CSS v4 সহ React 19-এ তৈরি SPA। রিপোজিটরির ব্যাজগুলো TypeScript 5.7+ এবং Gemini Flash ইন্টিগ্রেশন নির্দেশ করে। GitHub Pages-এ ডেপ্লয়মেন্ট এবং পুল রিকোয়েস্ট যাচাইয়ের জন্য GitHub Actions-এ CI/CD ওয়ার্কফ্লো রয়েছে। ## কীভাবে চালাবেন প্রয়োজনীয়তা: Node.js `>= 22` এবং pnpm `>= 11`। ```bash git clone https://github.com/Muriel-Gasparini/linkegringo.git cd linkegringo pnpm install pnpm dev ``` ডেভলপমেন্ট সার্ভারটি `http://localhost:5173`-এ চলে। উপলব্ধ স্ক্রিপ্টগুলোর মধ্যে রয়েছে `pnpm build` (প্যাকেজ এবং ওয়েব অ্যাপ কম্পাইল করে), `pnpm typecheck` (স্ট্যাটিক টাইপ চেকিং) এবং `pnpm test`। ## গভর্ন্যান্স রিপোজিটরিতে `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md` (Contributor Covenant) এবং `SECURITY.md` ফাইলের পাশাপাশি MIT লাইসেন্স অন্তর্ভুক্ত রয়েছে। রক্ষণাবেক্ষণের দায়িত্ব Muriel Gasparini-এর ওপর অর্পিত।