キャリア関連ドキュメント（職務経歴書）の作成・管理。 GitHub活動分析による技術力の可視化と キャリアインテリジェンスを提供するWebアプリケーションです。
| ドキュメント | 内容 |
|---|---|
| docs/development.md | Nix devshell・初回セットアップ・ローカル開発・テスト/リント |
| docs/deployment.md | 本番デプロイ（GCP）・OpenTofu インフラ構成・CI/CD・ブランチ保護 |
| docs/api.md | REST API 一覧・環境変数リファレンス |
| docs/data-model.md | Turso (libSQL) 運用・Alembic マイグレーション・データ設計 |
| docs/design-principles.md | 設計原則（ADR から帰納抽出した 7 原則・原則×ADR マトリクス） |
| docs/adr/ | アーキテクチャ判断記録（ADR）。索引にテーマ別の決定系統図あり |
| docs/runbooks/ | 運用 Runbook |
| docs/metrics/ai-friendliness.md | AI フレンドリーさ指標の月次ダッシュボード（make metrics-ai-friendliness で再生成） |
- 基本情報: 氏名・記載日・資格の管理
- 職務経歴書: 職務要約、自己PR、職務経歴、技術スタックの入力とPDF/Markdown出力
- フォーム入力状態を Redux でページ遷移間に保持（入力途中で別ページに移動しても失われない）
- 職務要約・自己PR・職務経歴・プロジェクトのスコープを選び、AIに文章改善を依頼（DevForge Agent / ADR-0010）
- マルチプロバイダ対応: Claude（Anthropic）/ GPT（OpenAI）/ Gemini（Google）からモデルを選択（ADR-0013）。プロバイダはモデル選択に紐づいて切り替わる
- 提案はフォームの入力状態にのみ反映し、保存はユーザーが明示的に実行（Agent 自体は DB を更新しない）
- 有料モデルはプリペイド式クレジットで従量課金（Stripe Checkout / ADR-0012）。無料モデルも提供
- ローカル開発では Ollama でオフライン実行可能（
LLM_LOCAL_OLLAMA）
- GitHub OAuthログインしたユーザーのリポジトリを取得し、使用技術を可視化
- 言語構成・フレームワーク・DevTools・インフラツールを依存関係から検出
- バックグラウンド非同期処理（202 Accepted → ステータスポーリング方式）
- GitHub連携などのバックグラウンドタスクの成功/失敗をサイドバーの通知ベルで通知
- 未読バッジ表示（30秒ポーリング）・ドロップダウンパネルで一覧表示
- 「全て既読」ボタン・パネル外クリックで閉じる
| レイヤー | 技術 |
|---|---|
| フロントエンド | React 18, TypeScript, Vite, Redux Toolkit, Recharts, marked |
| バックエンドAPI | Python 3.13, FastAPI, SQLAlchemy, Pydantic |
| AI / LLM | Anthropic Claude / OpenAI GPT / Google Gemini（ユーザー選択式・ADR-0013）、ローカルは Ollama |
| 決済 | Stripe Checkout（クレジット購入・従量課金 / ADR-0012） |
| データベース | Turso (libSQL / SQLite 互換、sqlalchemy-libsql) |
| 認証 | JWT Cookie (PyJWT), bcrypt, GitHub OAuth |
| 暗号化 | Fernet（フィールド暗号化） |
| PDF出力 | WeasyPrint（職務経歴書）, ReportLab（分析レポート補助） |
| インフラ | GCP (Cloud Run, Artifact Registry, Secret Manager), Turso, Cloudflare Pages |
| IaC | OpenTofu（モジュール構成、マルチ環境） |
| CI/CD | GitHub Actions |
初回セットアップ（nix develop / make setup / make generate-keys / make dev）と
CI 相当の一括実行（make ci）の手順は docs/development.md を正本として参照してください。
README にコマンドを再掲すると docs と二重管理になり同期漏れの原因になるため、リンクのみとしています。
graph TB
subgraph "ユーザー"
Browser["ブラウザ"]
end
subgraph "GitHub"
GitHubActions["GitHub Actions<br/>CI/CD"]
GitHubOAuth["GitHub OAuth"]
GitHubAPI["GitHub API"]
end
subgraph "外部サービス"
Stripe["Stripe<br/>Checkout / Webhook"]
end
subgraph "LLM プロバイダ（ユーザー選択式）"
Anthropic["Anthropic<br/>Claude"]
OpenAI["OpenAI<br/>GPT"]
Google["Google<br/>Gemini"]
end
subgraph "Cloudflare"
CFPages["Cloudflare Pages<br/>静的サイトホスティング<br/>（React SPA）"]
end
subgraph "Turso"
TursoDB["Turso DB: devforge-{env}<br/>libSQL（nrt リージョン）"]
end
subgraph "GCP Project: <PROJECT_ID>"
subgraph "Cloud Storage"
TfstateBucket["GCS: devforge-tfstate-{env}<br/>OpenTofu State"]
end
subgraph "Cloud Run"
CloudRun["Cloud Run: devforge-{env}<br/>FastAPI + libSQL クライアント<br/>max_instances=1 / min_instances=0<br/>CPU: 1000m / Memory: 512Mi"]
end
subgraph "Artifact Registry"
AR["devforge-{env}<br/>Docker イメージ"]
end
subgraph "Secret Manager"
Secrets["FIELD_ENCRYPTION_KEY<br/>ADMIN_TOKEN<br/>JWT_PRIVATE_KEY / JWT_PUBLIC_KEY<br/>INTERNAL_SECRET<br/>TURSO_AUTH_TOKEN<br/>GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET<br/>ANTHROPIC_API_KEY / GOOGLE_API_KEY / OPENAI_API_KEY<br/>STRIPE_SECRET_KEY / STRIPE_WEBHOOK_SECRET"]
end
subgraph "IAM"
SA["サービスアカウント<br/>devforge-{env}"]
end
end
Browser -->|"HTTPS"| CFPages
Browser -->|"API リクエスト"| CloudRun
Browser -->|"OAuth 認証"| GitHubOAuth
GitHubActions -->|"npm build → deploy"| CFPages
GitHubActions -->|"docker push"| AR
GitHubActions -->|"gcloud run deploy"| CloudRun
CloudRun -->|"libsql HTTPS"| TursoDB
CloudRun -->|"シークレット取得"| Secrets
CloudRun -->|"リポジトリ分析"| GitHubAPI
CloudRun -->|"AI 改善提案"| Anthropic
CloudRun -->|"AI 改善提案"| OpenAI
CloudRun -->|"AI 改善提案"| Google
CloudRun -->|"Checkout / Webhook"| Stripe
AR -->|"イメージ pull"| CloudRun
SA -->|"実行権限"| CloudRun
SA -->|"secretAccessor"| Secrets
DevForge は多くのオープンソースソフトウェアに支えられています。直接依存している OSS の一覧と各ライセンス・配布元へのリンクは THIRD_PARTY_LICENSES.md にまとめています（各 OSS の権利はそれぞれの著作権者に帰属します）。
依存を追加・更新した際は make licenses で再生成してください。