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

QimenJS ایک ماڈیولر TypeScript انفراسٹرکچر لائبریری ہے، جس کا نام "Qimen Dunjia" سے لیا گیا ہے — قدیم فوجی تشکیل کا نظام۔ یہ صلاحیتوں کے امتزاج (Ability) اور ڈیٹا پائپ لائن (Pipeline) کے ذریعے لچکدار فرنٹ اینڈ آرکیٹیکچر بناتی ہے، اور ایونٹ سسٹم، ڈیٹا پائپ لائن، انٹٹی مینجمنٹ، انٹرنیشنلائزیشن، HTTP کلائنٹ سمیت 38 آزاد ذیلی پیکجز فراہم کرتی ہے، جو فرنٹ اینڈ ایپلی کیشنز کی بنیادی پرت سے UI پرت تک محیط ہے۔ موجودہ ورژن 0.2.0 ہے، جو ابتدائی ترقی کے مرحلے میں ہے۔ بنیادی API اور UI اجزاء کی پرت دستیاب ہے، فریم ورک کا بہاؤ مکمل ہے، لیکن API بعد کے ورژنز میں تبدیل ہو سکتی ہے۔ پیکج کی فہرست تہوں کے مطابق ترتیب دی گئی ہے: - **بنیادی پرت (Layer 0)**: متحد ایرر سسٹم، لاگ سسٹم، عام یوٹیلیٹی فنکشنز، ایسینکرونس یوٹیلیٹیز، رن ٹائم ماحول کی شناخت، ہیش اور انکوڈنگ/ڈی کوڈنگ، انٹرنیشنلائزیشن، درخواست/ایونٹ سیاق و سباق، کراس پیکج مشترکہ بنیادی اقسام۔ - **بنیادی پرت (Layer 1)**: رجسٹری، ایونٹ بس، کیش مینجمنٹ، ڈیٹا پائپ لائن، صلاحیتوں کا امتزاج، ٹاسک شیڈولنگ۔ - **ڈیٹا پرت (Layer 2)**: ڈیٹا پروسیسر فریم ورک، توثیقی انجن، DOM ایونٹ اڈاپٹر (8 قسم کے اشاروں کی شناخت)، MIME قسم کی تجزیہ کاری، نام شدہ ریجیکس پیٹرن رجسٹرار، Schema تعریف، اجازت نامہ سسٹم۔ - **سروس پرت (Layer 3)**: HTTP کلائنٹ (4 مرحلہ پائپ لائن + انٹرسیپٹر + SSE اسٹریمنگ)، OAuth2 تصدیق (پاس ورڈ/آتھرائزیشن کوڈ/کلائنٹ کریڈینشل موڈز + 401 خودکار ریفریش)، ABP فریم ورک ڈیٹا پروسیسر، Spring Data ڈیٹا پروسیسر، سسٹم صلاحیتوں کا مجموعہ۔ - **ایپلی کیشن پرت (Layer 4)**: انٹٹی مینجمنٹ فریم ورک (5 قسم کے Manager + Ability امتزاج آرکیٹیکچر)، روٹنگ سسٹم (خالص ایونٹ موڈ + RouteAbility اجزاء کی صلاحیت)۔ - **UI پرت**: اجزاء کی بنیادی انفراسٹرکچر، UI اجزاء کی صلاحیت کی تعریفیں، UI اجزاء کا نفاذ (Icon/Button/Toggle/Tabs/Card/Menu/Nav/Panel وغیرہ)، اعلیٰ درجے کے UI اجزاء (Step/Timeline/Rating/PropertyGrid/OneTimePassword وغیرہ)، JSON سے چلنے والا لے آؤٹ تعریفی نظام، تھیم وسائل (روشن/گہرا + 10 چینی طرز کے پیش سیٹ + صارف کی تخصیص)، چینی طرز کا آئیکن لائبریری (102 SVG + فونٹ آئیکنز)، امپریٹو API (toast/msgbox)۔ آرکیٹیکچر کی خصوصیات میں تہہ دار ڈیزائن (انحصار کی سمت یک طرفہ، کراس لیئر حوالہ جات نہیں)، صلاحیتوں کا امتزاج (انٹٹی مینیجرز AbilityDefinition کے ذریعے صلاحیتوں کو متحرک طور پر یکجا کرتے ہیں)، پائپ لائن پراسیسنگ (ڈیٹا کی درخواست/جواب پلگ ایبل پروسیسر پائپ لائن سے گزرتی ہے، ABP/Spring فوری طور پر دستیاب)، ماحول کی موافقت (بنیادی پیکجز ماحول سے آزاد، براؤزر/Node.js دونوں کے لیے عام)، قسم کی حفاظت (مکمل TypeScript قسم کی تعریفیں)۔ مثالوں کی ڈائریکٹری `examples/full-stack/` میں مکمل فل اسٹیک ڈیمو شامل ہے، جس میں OAuth2 تصدیق، ABP API صارف مینجمنٹ، Spring Data آرڈر مینجمنٹ، 36 QimenJS ذیلی پیکجز کے فنکشن ڈیمو صفحات، انٹرنیشنلائزیشن (i18n پری کمپائلڈ + متحرک زبان کی تبدیلی) شامل ہیں۔ دستاویزات میں آرکیٹیکچر کی وضاحت، پیکج کی وضاحت، بہترین طریقے، API حوالہ جات شامل ہیں۔ ترقیاتی کمانڈز میں انحصار کی تنصیب، بلڈنگ، ٹیسٹ چلانا، کوڈ چیکنگ، API دستاویزات کی تخلیق شامل ہیں۔ ورژن نمبر SemVer معیار کی پیروی کرتا ہے، 0.x.x ابتدائی ترقی کے مرحلے کی نشاندہی کرتا ہے۔ یہ منصوبہ AI کی مدد سے تیار کردہ ہے، زیادہ تر کوڈ AI کے ذریعے تیار کیا گیا ہے۔ Huawei CodeArts، Trae CN، ChatGPT، DeepSeek، Gemini، Tongyi Qianwen، FitEncode وغیرہ ٹولز کے تعاون کا شکریہ۔ لائسنس MIT ہے۔