このプロジェクトについて
DevDNAは、公開されたGitHubのアクティビティを開析レポートと開発者プロフィールバッジに変換するWebアプリケーションです。GitHub OAuth経由でのみ動作し、自分自身のアカウントしか分析できません——匿名での検索や他の開発者のランキングはありません。
## DevDNAが提供するもの
- **開発者分類**: コミットパターン、使用リポジトリ、コラボレーション行動に基づいた10種類の明確なプロフィールタイプ
- **証拠バッジ**: `devdna-production-1d53.up.railway.app/api/badge/{username}.svg` で生成されるSVG画像。GitHub READMEやプロフィールページに埋め込むことを想定
- **共有可能なレポートカード**: `https://devdna.catchmeif404.com/dev/{username}` にある独立したページで、コーディング習慣、スタックの好み、開発者タイプを含む決定論的な要約を表示
- **言語対応**: インターフェースおよび共有テキストは英語・韓国語で利用可能
- **プライバシー設計**: 生のリポジトリおよびコミットデータは永続化されず、分析結果のみが保存されます
## バッジの追加方法
以下のMarkdownを任意のGitHub READMEに貼り付けます:
```markdown
[](https://devdna.catchmeif404.com/dev/YOUR_USERNAME)
```
バックエンドがまだそのアカウントの分析を実行していない場合、エンドポイントは壊れた画像の代わりにプレースホルダーの `AWAITING EVIDENCE` バッジを返します。
## テクノロジー構成
| 領域 | 技術 |
|---|---|
| フロントエンド | Next.js、TypeScript、Tailwind CSS、Cloudflare Workers |
| バックエンド | Spring Boot (Java 21)、Flywayマイグレーション、Railwayデプロイ |
| データベース | PostgreSQL |
| 認証 | GitHub OAuth |
## ローカルでの実行
```bash
cp .env.example .env
docker compose up -d
```
- フロントエンド: http://localhost:3010
- バックエンドAPI: http://localhost:8090
GitHub OAuthアプリを作成し、`GITHUB_CLIENT_ID` と `GITHUB_CLIENT_SECRET` を設定します。ローカルのコールバックURLは `http://localhost:8090/api/auth/github/callback` として構成する必要があります。
## 既知の制限
- 要約は確率的モデルではなくルールベースのテンプレートによって生成されます。コミットタイプの分類は設定に応じてClaude APIを呼び出す場合があります
- 最終的な分析結果のみが永続化され、生のGitHubデータはストリームとして処理され破棄されます
- 実行中の分析はバックエンドが再起動しても自動的に再開されません
- GitHubユーザー名変更後の結果所有権は完全に正規化されない場合があります
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.