عن المشروع

# PARTHA ذكاء المستودعات للكودات الخاصة والمتطورة. ## ما هو PARTHA يأخذ مراجعة مستودع (يُستورد كأرشيف ZIP/TAR أو مستودع GitHub عام) ويبني لقطة دائمة وغير قابلة للتعديل لهيكله. من تلك اللقطة الواحدة يقدّم: - **الهيكل المعماري** — رسم بياني تفاعلي للوحدات والعلاقات المفكّكة؛ تفسيرات مستشهدة بالأدلة لأنماط Python/FastAPI المدعومة - **رسم اعتمادات** — إعلانات من `package.json` و`pyproject.toml` و`requirements.txt`، مع قيم مثبتة مفكّكة من تنسيقين للأقفال مسجلة بشكل منفصل - **مراجعة هندسية** — نتائج كل منها مدعوم بنطاقات أدلة محفوظة؛ فئات غير مُقيّمة تبقى مرئية؛ لا درجة إجمالية ولا نسبة صحة - **رؤى المستودع** — تعدادات ونسب وتشخيصات وتغطية من اللقطة وحدها - **سلالة المستودع** — استيرادات متكررة لنفس المستودع والفرع مجمعة في تاريخ دائم - **التوثيق والتصدير** — توثيق هيكلي بالإضافة إلى مراجعة/توثيق/هندسة/اعتمادات تُصدّر كـ JSON أو Markdown أو HTML أو PDF - **سياق AI اختياري** — إعداد مقدم من قِبَل المستخدم بمفاتيح مشفرة Fernet وقائمة سماح مهربة تملكها النشر؛ يتلقى الموفّرون حقائق هيكلية ومسارات ملحوظة فقط، لا بايتات المصدر ولا نطاقات الأسطر العقد مُجسّد في [مصفوفة القدرات](docs/CAPABILITIES.md)، مولّدة من الكود ومتحقق من انحرافها في CI. الحقائق المدعومة تحافظ على الأدلة والأصل المرتبطة بموقع مصدر دقيق داخل المراجعة المُحلَّلة. ## كيف يعمل ``` استيراد → تحليل → استكشاف → تصدير ``` 1. **استيراد** — ارفع أرشيفًا أو صدّر مستودع GitHub عام عبر HTTPS. يخزن PARTHA جرد ملفات وهوية المراجعة. 2. **تحليل** — مهمة خلفية دائمة وقابلة للإلغاء تشغّل خط أنابيب استخراج محدود لبنى Python وTypeScript/JavaScript المدعومة والمخططات وأقراص القفل وتفاعلات الخدمات وDocker Compose. 3. **استكشاف** — تفحّص الهيكل والاعتمادات والمراجعة الهندسية والرؤى والأدلة والسلالة. لقطة مفقودة أو بالية تُظهر "غير متوفر" بدلًا من العودة لتفسير مُفتَرَض. 4. **تصدير** — ولّد توثيقًا هيكليًا أو صدّر النتائج عبر خط أنابيب JSON/Markdown/HTML/PDF. المنتج الوسيط هو `ri.v1` — لقطة مُغلَفة ذات إصدار تحتوي على حقائق وأدلة وتشخيصات وهاش قياسي. كل سطح منتج يقرأ من هذا النموذج المشترك؛ لا مستهلك يعيد تحليل الكود بشكل مستقل. الـAI مستهلك لاحق لذكاء المستودع، وليس مفسّرًا مستقلًا. ## التكنولوجيا المستخدمة - **الواجهة الخلفية**: Python 3.12–3.13, FastAPI - **الواجهة الأمامية**: Node.js 22, React - **قاعدة البيانات**: SQLite (للتطوير) - **عامل**: خيط عمليات نائبة محلي (مهمة واحدة في كل مرة) - **موفّرو AI**: اختياريون،قابلين للتكوين بمفاتيح مشفرة Fernet وقائمة سماح مهربة مربوطة DNS ## بدء سريع ```bash git clone https://github.com/Second-Origin/PARTHA.git cd PARTHA # الواجهة الخلفية — http://localhost:8000 (OpenAPI عند /docs) cd apps/backend python3.13 -m venv .venv && source .venv/bin/activate pip install -e . cd ../.. && npm run dev:backend # الواجهة الأمامية — http://localhost:5173 cd apps/frontend npm ci npm run dev ``` لا يحتاج runtime حاويات أو قاعدة بيانات خارجية للتطوير المحلي. لا يحتاج ملف `.env`. ## القيود الحالية - للاستخدام البيئתי الموثوق فقط — غير مصقول للاستضافة المشتركة واسعة النطاق أو متعددة المالكين. - الاستخراج الدلالي العميق محدود بـPython وTypeScript/JavaScript؛ اللغات الأخرى تساهم بجرد الملفات فقط. - تغطية الاعتمادات: ثلاثة أشكال مخططات وشكلان أقفال؛ لا حل انتقالي، لا فحص عيوب أمنية أو إصدارات بالية. - تحليل المستودع بأكمله لكل تشغيل — لا إعادة تحليل تدريجية. - السلالة تحافظ على تاريخ المراجعات لكنها لا تقارن اللقطات، لا تكشف إعادة تسمية/نقل، ولا تحسب نطاق انفجار تاريخي. - الـAI الاختياري يمكنه استدعاء موفّر خارجي؛ الموفّرون المحليون فقط يحتفظون بالكل على المضيف. يُرجى الاطلاع على [سياسة التهريب](docs/security/AI_PROVIDER_EGRESS.md). ## التوثيق - [نظرة عامة على النظام](docs/architecture/SYSTEM_OVERVIEW.md) - [ذكاء المستودع](docs/architecture/REPOSITORY_INTELLIGENCE.md) - [RFC-0001 — عقد ri.v1](docs/architecture/REPOSITORY_INTELLIGENCE_V1_RFC.md) - [RFC-0002 — سلالة المستودع](docs/architecture/REPOSITORY_LINEAGE_RFC.md) - [مصفوفة القدرات](docs/CAPABILITIES.md) - [دليل التطوير](docs/DEVELOPMENT.md) - [إعداد موفّر AI](docs/operations/AI_PROVIDER_SETUP.md) - [سياسة الأمان](SECURITY.md) ## الترخيص رخصة Apache 2.0 ## المجتمع - [Discord](https://discord.gg/qvk9DcxDA) - [مشكلات](https://github.com/Second-Origin/PARTHA/issues)