عن المشروع

## ما هو LinkeGringo هو تطبيق ويب مفتوح المصدر يقوم بتحليل وإعادة كتابة ملفات LinkedIn الشخصية مع التركيز على معايير الفرز التي يستخدمها مسؤولو التوظيف التقنيون في الولايات المتحدة. نقطة البداية المذكورة في README هي الفجوة في العرض المهني: الأوصاف السلبية التي تركز على المهام، غياب التأثير القابل للقياس، والصعوبة في الصياغة باللغة الإنجليزية التقنية الاصطلاحية. التطبيق منشور عبر GitHub Pages. ## رحلة الاستخدام يتبع التدفق الموصوف في README مساراً هيكلياً: 1. **رفع ملف PDF**: يقوم المستخدم بتصدير ملفه الشخصي عبر ميزة "Save to PDF" في LinkedIn وسحبه إلى التطبيق. 2. **التشخيص الوارد (Inbound Diagnosis)**: حساب مقياس مرجح لـ *Inbound Readiness*، وقمع الاحتفاظ (البحث ← البطاقة ← الملف الشخصي ← InMail) وتحديد العائق الرئيسي. 3. **مقابلة تقنية تكيفية**: أسئلة تهدف إلى توضيح المقاييس الحقيقية، حدود القياس (scale)، وقرارات الهندسة المعمارية. 4. **تأكيد الحقائق**: مراجعة صريحة للحقائق التقنية قبل إعادة الكتابة، بهدف معلن وهو تجنب الهلوسة (hallucinations). 5. **مركز الإجراءات (Action Hub)**: ثلاث علامات تبويب — *My Profile* (بطاقة مقارنة بتنسيق LinkedIn Recruiter، قبل مقابل بعد، مع أقسام جاهزة للنقل وعدادات أحرف)، *Search* (محاكي بحث مسؤولي التوظيف مع علامات MATCH و WEAK و MISSING) و *Launch* (قائمة مراجعة للإعدادات الخارجية في LinkedIn، مثل Open to Work، المسميات الوظيفية المستهدفة، الموقع عن بعد، وملف شخصي ثانوي باللغة الإنجليزية). ## الخصوصية والبنية التحتية يؤكد README على نموذج خصوصية قابل للتدقيق: - **بدون خلفية برمجية (No backend)**: التطبيق عبارة عن Single Page Application يعمل فقط في المتصفح. - **BYOK (Bring Your Own Key)**: يستخدم كل شخص مفتاح API الخاص به من Google Gemini، والذي يمكن الحصول عليه مجاناً من Google AI Studio. - **طلبات قابلة للفحص**: تذهب طلبات الشبكة من المتصفح مباشرة إلى خوادم Google (`generativelanguage.googleapis.com`)، ويمكن التحقق من ذلك في علامة تبويب *Network* في DevTools. - **التخزين المحلي**: يتم تخزين مفتاح API فقط في `localStorage` الخاص بالجهاز. ## التقنيات وتنظيم الكود المشروع عبارة عن monorepo: - `packages/core` (`@linkegringo/core`): النطاق، schemas Zod، الأنواع، والمعادلات الحتمية. - `packages/ai` (`@linkegringo/ai`): مزود Gemini (`@google/genai`)، mock offline، والمطالبات (prompts). - `apps/web` (`@linkegringo/web`): SPA مبني بـ React 19 مع Vite و Tailwind CSS v4. تشير شارات المستودع إلى استخدام TypeScript 5.7+ والتكامل مع Gemini Flash. توجد تدفقات عمل CI/CD في GitHub Actions للنشر على GitHub Pages والتحقق من طلبات السحب (pull requests). ## كيفية التشغيل المتطلبات المسبقة: 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.