linkegringo

## Qué es LinkeGringo es una aplicación web de código abierto que analiza y reescribe perfiles de LinkedIn centrándose en los criterios de cribado de los reclutadores técnicos de los Estados Unidos. El punto de partida declarado en el README es la brecha de presentación profesional: descripciones pasivas centradas en asignaciones, ausencia de impacto medible y dificultad para formular en inglés técnico idiomático. La aplicación está publicada a través de GitHub Pages. ## Jornada de uso El flujo descrito en el README sigue un pipeline estructurado: 1. **Carga de PDF**: el usuario exporta su propio perfil mediante la función "Guardar como PDF" de LinkedIn y lo arrastra a la aplicación. 2. **Diagnóstico inbound**: cálculo de una métrica ponderada de *Inbound Readiness*, embudo de retención (Búsqueda → Card → Perfil → InMail) e indicación del principal cuello de botella. 3. **Entrevista técnica adaptativa**: preguntas orientadas a aclarar métricas reales, límites de escala y decisiones de arquitectura. 4. **Confirmación de hechos**: revisión explícita de los hechos técnicos antes de la reescritura, con el objetivo declarado de evitar alucinaciones. 5. **Action Hub**: tres pestañas — *My Profile* (tarjeta comparativa en el formato de LinkedIn Recruiter, antes vs. después, con secciones listas para transferir y contadores de caracteres), *Search* (simulador de búsqueda de reclutadores con etiquetas MATCH, WEAK y MISSING) y *Launch* (checklist de configuraciones externas en LinkedIn, como Open to Work, cargos objetivo, ubicación remota y perfil secundario en inglés). ## Privacidad y arquitectura El README enfatiza un modelo de privacidad auditable: - **Sin backend**: la aplicación es una Single Page Application ejecutada únicamente en el navegador. - **BYOK (Bring Your Own Key)**: cada persona utiliza su propia clave de la API de Google Gemini, obtenida gratuitamente en Google AI Studio. - **Solicitudes inspeccionables**: las llamadas de red van desde el navegador directamente a los servidores de Google (`generativelanguage.googleapis.com`), verificables en la pestaña *Network* de DevTools. - **Almacenamiento local**: la clave de API permanece solo en el `localStorage` del dispositivo. ## Stack y organización del código El proyecto es un monorepo: - `packages/core` (`@linkegringo/core`): dominio, esquemas Zod, tipos y fórmulas determinísticas. - `packages/ai` (`@linkegringo/ai`): proveedor Gemini (`@google/genai`), mock offline y prompts. - `apps/web` (`@linkegringo/web`): SPA en React 19 con Vite y Tailwind CSS v4. Los badges del repositorio indican TypeScript 5.7+ e integración con Gemini Flash. Existen workflows de CI/CD en GitHub Actions para el despliegue en GitHub Pages y la verificación de pull requests. ## Cómo ejecutar Prerrequisitos: Node.js `>= 22` y pnpm `>= 11`. ```bash git clone https://github.com/Muriel-Gasparini/linkegringo.git cd linkegringo pnpm install pnpm dev ``` El servidor de desarrollo responde en `http://localhost:5173`. Los scripts disponibles incluyen `pnpm build` (compila paquetes y aplicación web), `pnpm typecheck` (verificación estática de tipos) y `pnpm test`. ## Gobernanza El repositorio incluye los archivos `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md` (Contributor Covenant) y `SECURITY.md`, además de la licencia MIT. El mantenimiento está asignado a Muriel Gasparini.