Об этом проекте

## Что это такое LinkeGringo — это веб-приложение с открытым исходным кодом, которое анализирует и переписывает профили LinkedIn с упором на критерии отбора технических рекрутеров в США. В README в качестве отправной точки указан разрыв в профессиональной презентации: пассивные описания, сосредоточенные на обязанностях, отсутствие измеримого влияния и трудности с формулировками на идиоматическом техническом английском. Приложение опубликовано через GitHub Pages. ## Процесс использования Поток, описанный в README, следует структурированному конвейеру: 1. **Загрузка PDF**: пользователь экспортирует свой профиль с помощью функции «Сохранить как PDF» в LinkedIn и перетаскивает его в приложение. 2. **Входящая диагностика**: расчет взвешенной метрики Inbound Readiness, воронка удержания (Поиск → Карточка → Профиль → InMail) и определение основного узкого места. 3. **Адаптивное техническое интервью**: вопросы, направленные на уточнение реальных метрик, пределов масштабирования и архитектурных решений. 4. **Подтверждение фактов**: явный пересмотр технических фактов перед переписыванием с заявленной целью избежать галлюцинаций. 5. **Action Hub**: три вкладки — My Profile (сравнительная карточка в формате LinkedIn Recruiter, «до» и «после», с разделами, готовыми к переносу, и счетчиками символов), Search (симулятор поиска рекрутеров с метками MATCH, WEAK и MISSING) и Launch (чек-лист внешних настроек в LinkedIn, таких как Open to Work, целевые должности, удаленное местоположение и вторичный профиль на английском языке). ## Конфиденциальность и архитектура В README подчеркивается проверяемая модель конфиденциальности: - **Без бэкенда**: приложение представляет собой Single Page Application, которое выполняется только в браузере. - **BYOK (Bring Your Own Key)**: каждый пользователь использует собственный ключ API Google Gemini, полученный бесплатно в Google AI Studio. - **Проверяемые запросы**: сетевые вызовы идут из браузера напрямую на серверы Google (`generativelanguage.googleapis.com`), что можно проверить во вкладке Network в DevTools. - **Локальное хранилище**: API-ключ хранится только в `localStorage` устройства. ## Стек и организация кода Проект представляет собой монорепозиторий: - `packages/core` (`@linkegringo/core`): домен, схемы Zod, типы и детерминированные формулы. - `packages/ai` (`@linkegringo/ai`): провайдер Gemini (`@google/genai`), офлайн-мок и промпты. - `apps/web` (`@linkegringo/web`): SPA на React 19 с Vite и Tailwind CSS v4. Бейджи репозитория указывают на TypeScript 5.7+ и интеграцию с Gemini Flash. В GitHub Actions настроены рабочие процессы CI/CD для деплоя на GitHub Pages и проверки pull-запросов. ## Как запустить Предварительные требования: 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.