linkegringo

## 概要 LinkeGringoは、米国のテクニカルリクルーターによる選考基準に焦点を当て、LinkedInプロフィールを分析・書き換えするオープンソースのWebアプリケーションです。READMEでは、職務内容を中心とした受動的な記述、測定可能なインパクトの欠如、慣用的なテクニカル英語での表現の困難さといった、プロフェッショナルなプレゼンテーションにおけるギャップを解決することを目的としています。本アプリケーションはGitHub Pagesを通じて公開されています。 ## 利用フロー READMEに記載されているフローは、以下の構造化されたパイプラインに従います： 1. **PDFのアップロード**: ユーザーがLinkedInの「PDFとして保存」機能で自身のプロフィールをエクスポートし、アプリケーションにドラッグ＆ドロップします。 2. **インバウンド診断**: 重み付けされた「Inbound Readiness」メトリクスの算出、リテンションファネル（検索 → カード → プロフィール → InMail）の分析、および主要なボトルネックの特定を行います。 3. **適応型テクニカルインタビュー**: 実際のメトリクス、スケールの限界、アーキテクチャ上の決定事項を明確にするための質問が行われます。 4. **事実確認**: ハルシネーション（AIによる虚偽の生成）を防ぐため、書き換え前にテクニカルな事実関係を明示的にレビューします。 5. **Action Hub**: 3つのタブで構成されています。*My Profile*（LinkedIn Recruiter形式の比較カード、Before/After、コピー可能なセクションと文字数カウンター）、*Search*（リクルーターの検索シミュレーターで、MATCH、WEAK、MISSINGのタグ付けを表示）、*Launch*（Open to Workの設定、ターゲット職種、リモート勤務地の指定、英語のサブプロフィール作成など、LinkedIn外部設定のチェックリスト）。 ## プライバシーとアーキテクチャ READMEでは、監査可能なプライバシーモデルを強調しています： - **バックエンドなし**: 本アプリケーションはブラウザのみで実行されるシングルページアプリケーション（SPA）です。 - **BYOK (Bring Your Own Key)**: ユーザーはGoogle AI Studioで無料で取得した自身のGoogle Gemini APIキーを使用します。 - **検証可能なリクエスト**: ネットワークリクエストはブラウザからGoogleのサーバー（`generativelanguage.googleapis.com`）へ直接送信され、DevToolsのNetworkタブで確認可能です。 - **ローカルストレージ**: APIキーはデバイスの`localStorage`にのみ保存されます。 ## スタックとコード構成 プロジェクトはモノレポ構成となっています： - `packages/core` (`@linkegringo/core`): ドメイン、Zodスキーマ、型定義、決定論的な計算式。 - `packages/ai` (`@linkegringo/ai`): Geminiプロバイダー (`@google/genai`)、オフラインモック、プロンプト。 - `apps/web` (`@linkegringo/web`): ViteとTailwind CSS v4を使用したReact 19ベースのSPA。 リポジトリのバッジには、TypeScript 5.7+およびGemini Flashとの統合が示されています。また、GitHub Pagesへのデプロイとプルリクエストの検証のためにGitHub ActionsによるCI/CDワークフローが導入されています。 ## 実行方法 前提条件: 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`（パッケージとWebアプリのコンパイル）、`pnpm typecheck`（静的型チェック）、`pnpm test` が含まれます。 ## ガバナンス リポジトリには `CONTRIBUTING.md`、`CODE_OF_CONDUCT.md` (Contributor Covenant)、`SECURITY.md` およびMITライセンスが含まれています。メンテナンスはMuriel Gasparini氏が担当しています。