À propos du projet

## Qu'est-ce que c'est LinkeGringo est une application web open source qui analyse et réécrit les profils LinkedIn en se concentrant sur les critères de tri des recruteurs techniques des États-Unis. Le point de départ déclaré dans le README est la lacune de présentation professionnelle : descriptions passives centrées sur les attributions, absence d'impact mesurable et difficulté à formuler en anglais technique idiomatique. L'application est publiée via GitHub Pages. ## Parcours d'utilisation Le flux décrit dans le README suit un pipeline structuré : 1. **Upload du PDF** : l'utilisateur exporte son propre profil via la fonction "Enregistrer au format PDF" de LinkedIn et le glisse dans l'application. 2. **Diagnostic inbound** : calcul d'une métrique pondérée de *Inbound Readiness*, entonnoir de rétention (Recherche → Carte → Profil → InMail) et indication du principal goulot d'étranglement. 3. **Entretien technique adaptatif** : questions visant à clarifier les métriques réelles, les limites d'échelle et les décisions d'architecture. 4. **Confirmation des faits** : révision explicite des faits techniques avant la réécriture, avec l'objectif déclaré d'éviter les hallucinations. 5. **Action Hub** : trois onglets — *My Profile* (carte comparative au format LinkedIn Recruiter, avant vs après, avec des sections prêtes pour le transfert et des compteurs de caractères), *Search* (simulateur de recherche de recruteurs avec des marquages MATCH, WEAK et MISSING) et *Launch* (checklist de configurations externes sur LinkedIn, telles que Open to Work, postes cibles, localisation distante et profil secondaire en anglais). ## Confidentialité et architecture Le README met l'accent sur un modèle de confidentialité auditable : - **Sans backend** : l'application est une Single Page Application exécutée uniquement dans le navigateur. - **BYOK (Bring Your Own Key)** : chaque personne utilise sa propre clé d'API Google Gemini, obtenue gratuitement sur Google AI Studio. - **Requêtes inspectables** : les appels réseau vont du navigateur directement aux serveurs de Google (`generativelanguage.googleapis.com`), vérifiables dans l'onglet *Network* des DevTools. - **Stockage local** : la clé d'API reste uniquement dans le `localStorage` de l'appareil. ## Stack et organisation du code Le projet est un monorepo : - `packages/core` (`@linkegringo/core`) : domaine, schémas Zod, types et formules déterministes. - `packages/ai` (`@linkegringo/ai`) : fournisseur Gemini (`@google/genai`), mock offline et prompts. - `apps/web` (`@linkegringo/web`) : SPA en React 19 avec Vite et Tailwind CSS v4. Les badges du dépôt indiquent TypeScript 5.7+ et l'intégration avec Gemini Flash. Il existe des workflows CI/CD sur GitHub Actions pour le déploiement sur GitHub Pages et la vérification des pull requests. ## Comment exécuter Prérequis : Node.js `>= 22` et pnpm `>= 11`. ```bash git clone https://github.com/Muriel-Gasparini/linkegringo.git cd linkegringo pnpm install pnpm dev ``` Le serveur de développement répond sur `http://localhost:5173`. Les scripts disponibles incluent `pnpm build` (compile les packages et l'application web), `pnpm typecheck` (vérification statique des types) et `pnpm test`. ## Gouvernance Le dépôt inclut les fichiers `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md` (Contributor Covenant) et `SECURITY.md`, ainsi qu'une licence MIT. La maintenance est attribuée à Muriel Gasparini.