منصوبے کے بارے میں

# PARTHA نجی اور ترقی پذیر کوڈ بیسز کے لیے ریپوزٹری انٹیلیجنس۔ ## یہ کیا ہے PARTHA ایک ریپوزٹری ریویژن (ZIP/TAR آرکائیو یا عوامی GitHub ریپو کے طور پر درآمد شدہ) لیتا ہے اور اس کی ساخت کا ایک مستقل، ناقابل تغیر سنیپ شاٹ بناتا ہے۔ اسی ایک سنیپ شاٹ سے یہ فراہم کرتا ہے: - **آرکیٹیکچر** — ماڈیولز اور حل شدہ تعلقات کا انٹرایکٹو گراف؛ معاون Python/FastAPI پیٹرنز کے لیے ثبوت کے ساتھ حوالہ شدہ وضاحتیں - **ڈیپنڈنسی گراف** — `package.json`، `pyproject.toml`، اور `requirements.txt` سے اعلانات، دو لاک فائل فارمیٹس سے حل شدہ پنز علیحدہ طور پر ریکارڈ کیے گئے - **انجینئرنگ ریویو** — ہر نتیجہ ذخیرہ شدہ ثبوت کے حصوں پر مبنی؛ غیر جانچے گئے زمرے دکھائی دیتے رہتے ہیں؛ کوئی مجموعی اسکور یا صحت کا فیصد نہیں - **ریپوزٹری بصیرتیں** — صرف سنیپ شاٹ سے شمار، تناسب، تشخیص، اور کوریج - **ریپوزٹری لینیج** — ایک ہی ریپوزٹری اور برانچ کی بار بار درآمدات پائیدار تاریخ میں گروہ بند - **دستاویزات اور برآمد** — ساختی دستاویزات کے علاوہ ریویو/دستاویزات/آرکیٹیکچر/ڈیپنڈنسیز JSON، Markdown، HTML، یا PDF میں برآمد - **اختیاری AI سیاق و سباق** — فی صارف فراہم کنندہ ترتیب خفیہ کردہ کلیدوں اور ڈیپلائمنٹ کی ملکیت والی ایگریس اللسٹ کے ساتھ؛ فراہم کنندگان کو صرف ساختی حقائق اور مشاہدہ شدہ راستے ملتے ہیں، کبھی سورس بائٹس یا لائن اسپین نہیں معاہدہ [capability matrix](docs/CAPABILITIES.md) میں رسمی شکل دیا گیا ہے، جو کوڈ سے تیار ہوتا ہے اور CI میں ڈرفٹ چیک کیا جاتا ہے۔ معاون حقائق تجزیہ شدہ ریویژن کے اندر عین ماخذ مقام سے منسلک ثبوت اور ماخذ کو برقرار رکھتے ہیں۔ ## یہ کیسے کام کرتا ہے ``` Import → Analyse → Explore → Export ``` 1. **درآمد** — ایک آرکائیو اپ لوڈ کریں یا HTTPS پر عوامی GitHub ریپوزٹری درآمد کریں۔ 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-encrypted کلیدوں اور DNS-pinned ایگریس اللسٹ کے ساتھ ترتیب پذیر ## فوری آغاز ```bash git clone https://github.com/Second-Origin/PARTHA.git cd PARTHA # Backend — http://localhost:8000 (OpenAPI at /docs) cd apps/backend python3.13 -m venv .venv && source .venv/bin/activate pip install -e . cd ../.. && npm run dev:backend # Frontend — http://localhost:5173 cd apps/frontend npm ci npm run dev ``` مقامی ترقی کے لیے کوئی کنٹینر رن ٹائم یا بیرونی ڈیٹا بیس درکار نہیں۔ کوئی `.env` فائل درکار نہیں۔ ## موجودہ حدود - صرف قابل اعتماد ماحول میں استعمال — وسیع مشترکہ یا ملٹی ٹیننٹ ہوسٹنگ کے لیے سخت نہیں۔ - گہری معنوی نکالنے کا دائرہ Python اور TypeScript/JavaScript تک محدود ہے؛ دیگر زبانیں صرف فائل انوینٹری میں حصہ ڈالتی ہیں۔ - ڈیپنڈنسی کوریج: تین مینی فیسٹ فارمیٹس اور دو لاک فائل فارمیٹس؛ کوئی عبوری حل، کوئی کمزوری یا پرانے ورژن اسکیننگ نہیں۔ - ہر رن میں پوری ریپوزٹری کا تجزیہ — کوئی اضافی دوبارہ تجزیہ نہیں۔ - لینیج ریویژن تاریخ محفوظ رکھتا ہے لیکن سنیپ شاٹس کا فرق نہیں دکھاتا، نام تبدیل/منتقل ہونے کا پتہ نہیں لگاتا، یا تاریخی اثر و رسوخ کا حساب نہیں لگاتا۔ - اختیاری AI بیرونی فراہم کنندہ کو کال کر سکتا ہے؛ صرف مقامی فراہم کنندگان سب کچھ میزبان پر رکھتے ہیں۔ [egress policy](docs/security/AI_PROVIDER_EGRESS.md) دیکھیں۔ ## دستاویزات - [System Overview](docs/architecture/SYSTEM_OVERVIEW.md) - [Repository Intelligence](docs/architecture/REPOSITORY_INTELLIGENCE.md) - [RFC-0001 — ri.v1 contract](docs/architecture/REPOSITORY_INTELLIGENCE_V1_RFC.md) - [RFC-0002 — Repository Lineage](docs/architecture/REPOSITORY_LINEAGE_RFC.md) - [Capability matrix](docs/CAPABILITIES.md) - [Development guide](docs/DEVELOPMENT.md) - [AI provider setup](docs/operations/AI_PROVIDER_SETUP.md) - [Security policy](SECURITY.md) ## لائسنس Apache License 2.0 ## کمیونٹی - [Discord](https://discord.gg/qvk9DcxDA) - [Issues](https://github.com/Second-Origin/PARTHA/issues)