عن المشروع
DevDNA هو تطبيق ويب يحول نشاط GitHub العام إلى تقرير تحليل وشارة مطور. يعمل حصريًا عبر مصادقة GitHub OAuth، مما يعني أن بإمكانك تحليل حسابك فقط - لا يوجد بحث مجهول أو تصنيف للمطورين الآخرين.
## ما يوفره DevDNA
- **تصنيف المطور**: عشرة أنواع ملفات شخصية متميزة تعتمد على أنماط الالتزام، والمستودعات المستخدمة، وسلوك التعاون
- **شارة الدليل**: صورة SVG يتم إنشاؤها عند `devdna-production-1d53.up.railway.app/api/badge/{username}.svg`، مصممة للإدراج في مستندات GitHub README أو صفحات الملف الشخصي
- **تقرير قابل للمشاركة**: صفحة مستقلة عند `https://devdna.catchmeif404.com/dev/{username}` تحتوي على ملخص حتمي لعادات البرمجة وتفضيلات المكدس ونوع المطور
- **دعم اللغة**: الواجهة ونصوص المشاركة متاحة بالإنجليزية والكورية
- **تصميم الخصوصية**: لا يتم حفظ بيانات المستودعات والالتزامات الخام؛ فقط النتائج المحللة النهائية تُحفظ
## كيفية إضافة الشارة
الصق هذا Markdown في أي ملف README على GitHub:
```markdown
[](https://devdna.catchmeif404.com/dev/YOUR_USERNAME)
```
إذا لم يكن الخادم الخلفي قد شغل تحليلًا للحساب بعد، فسيُرجع نقطة النهاية شارة `AWAITING EVIDENCE` بديلاً عن صورة معطلة.
## مجموعة التقنية
| المجال | التقنية |
|---|---|
| الواجهة الأمامية | Next.js, TypeScript, Tailwind CSS, Cloudflare Workers |
| الخادم الخلفي | Spring Boot (Java 21), Flyway migrations, Railway deployment |
| قاعدة البيانات | PostgreSQL |
| المصادقة | GitHub OAuth |
## التشغيل محليًا
```bash
cp .env.example .env
docker compose up -d
```
- الواجهة الأمامية: http://localhost:3010
- واجهة برمجة التطبيقات الخلفية: 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.