Sobre o projeto

## O que é LinkeGringo é uma aplicação web de código aberto que analisa e reescreve perfis do LinkedIn com foco nos critérios de triagem de recrutadores técnicos dos Estados Unidos. O ponto de partida declarado no README é a lacuna de apresentação profissional: descrições passivas centradas em atribuições, ausência de impacto mensurável e dificuldade de formular em inglês técnico idiomático. A aplicação está publicada via GitHub Pages. ## Jornada de uso O fluxo descrito no README segue um pipeline estruturado: 1. **Upload do PDF**: o usuário exporta o próprio perfil pelo recurso "Salvar como PDF" do LinkedIn e o arrasta para a aplicação. 2. **Diagnóstico inbound**: cálculo de uma métrica ponderada de *Inbound Readiness*, funil de retenção (Busca → Card → Perfil → InMail) e indicação do principal gargalo. 3. **Entrevista técnica adaptativa**: perguntas voltadas a esclarecer métricas reais, limites de escala e decisões de arquitetura. 4. **Confirmação de fatos**: revisão explícita dos fatos técnicos antes da reescrita, com o objetivo declarado de evitar alucinações. 5. **Action Hub**: três abas — *My Profile* (card comparativo no formato do LinkedIn Recruiter, antes vs. depois, com seções prontas para transferência e contadores de caracteres), *Search* (simulador de busca de recrutadores com marcações MATCH, WEAK e MISSING) e *Launch* (checklist de configurações externas no LinkedIn, como Open to Work, cargos-alvo, localização remota e perfil secundário em inglês). ## Privacidade e arquitetura O README enfatiza um modelo de privacidade auditável: - **Sem backend**: a aplicação é uma Single Page Application executada apenas no navegador. - **BYOK (Bring Your Own Key)**: cada pessoa usa sua própria chave da API do Google Gemini, obtida gratuitamente no Google AI Studio. - **Requisições inspecionáveis**: as chamadas de rede vão do navegador direto para os servidores da Google (`generativelanguage.googleapis.com`), verificáveis na aba *Network* do DevTools. - **Armazenamento local**: a chave de API fica apenas no `localStorage` do dispositivo. ## Stack e organização do código O projeto é um monorepo: - `packages/core` (`@linkegringo/core`): domínio, schemas Zod, tipos e fórmulas determinísticas. - `packages/ai` (`@linkegringo/ai`): provedor Gemini (`@google/genai`), mock offline e prompts. - `apps/web` (`@linkegringo/web`): SPA em React 19 com Vite e Tailwind CSS v4. Os badges do repositório indicam TypeScript 5.7+ e integração com Gemini Flash. Há workflows de CI/CD no GitHub Actions para deploy no GitHub Pages e verificação de pull requests. ## Como executar Pré-requisitos: Node.js `>= 22` e pnpm `>= 11`. ```bash git clone https://github.com/Muriel-Gasparini/linkegringo.git cd linkegringo pnpm install pnpm dev ``` O servidor de desenvolvimento atende em `http://localhost:5173`. Os scripts disponíveis incluem `pnpm build` (compila pacotes e aplicação web), `pnpm typecheck` (checagem estática de tipos) e `pnpm test`. ## Governança O repositório inclui arquivos `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md` (Contributor Covenant) e `SECURITY.md`, além de licença MIT. A manutenção é atribuída a Muriel Gasparini.