HelixGitpx (پروکسی گیت فدراتیو توسعه‌یافته Helix) یک پروکسی گیت فدراتیو است که یک منبع حقیقت واحد را در چندین میزبان گیت بالادستی منعکس کرده و تضادهای اجتناب‌ناپذیر را با گردش‌های کاری مبتنی بر سیاست و AI حل می‌کند. این پروژه به نسخه ۱٫۰٫۰ GA رسیده است.

HelixGitpx یک پروکسی گیت فدراتیو است که یک منبع حقیقت واحد را در بیش از ده میزبان گیت — از جمله GitHub، GitLab، گیتیا، بیت‌باکت، Azure DevOps، AWS CodeCommit و غیره — منعکس کرده و تضادهای همگام‌سازی را با گردش‌های کاری مبتنی بر سیاست و AI حل می‌کند. این پروژه به صورت نسخه ۱٫۰٫۰ GA عرضه شده است.

HelixGitpx — یا «پروکسی گیت توسعه‌یافته Helix» — یک پروکسی گیت فدراتیو است که یک منبع حقیقت واحد را در چندین میزبان گیت بالادستی منعکس کرده و تضادهایی را که ناگزیر در لحظه‌ای که یک مخزن در بیش از یک مکان وجود داشته باشد، پدید می‌آیند، حل می‌کند. فهرست میزبان‌های بالادستی پشتیبانی‌شده توسط آن همچون نقشه‌ای از کل اکوسیستم گیت است: GitHub، GitLab، GitFlic، GitVerse، گیتیا، گیتی، بیت‌باکت، Azure DevOps، AWS CodeCommit، فورجه‌جو، سورس‌هات و گیت عمومی از طریق HTTPS. در حالی که یک git push ساده به ده‌ها مخزن از راه دور یا به کلی شکست می‌خورد یا بدتر، اجازه می‌دهد که نسخه‌های منعکس‌شده به آرامی از هم دور شوند، HelixGitpx با گردش‌های کاری حل تضاد مبتنی بر سیاست و AI وارد عمل شده و واگرایی‌ها را به یک حقیقت معتبر واحد بازمی‌گرداند.

این پروژه در نسخه ۱٫۰٫۰ GA قرار دارد و نقاط عطف آن از m1-foundation تا m8-ga برچسب‌گذاری شده‌اند — مسیری کاملاً برنامه‌ریزی‌شده از پایه تا دسترسی عمومی. این پروژه به صورت سه لایه از یک محصول طراحی شده است: یک مونورپوی Go (شامل یک پلتفرم به همراه هجده سرویس، ابزارهای تولید کد و داربست‌سازی) که موتور فدراسیون را در خود جای داده است؛ یک برنامه وب Angular 19 + Nx؛ و پوسته‌های کلاینت Kotlin-Multiplatform + Compose که تجربه‌های بومی را برای اندروید، آی‌اواس و دسکتاپ از طریق کد مشترک ارائه می‌دهند. تحویل پلتفرم کاملاً بومی Kubernetes است — شامل نمودارهای Helm، برنامه‌های Argo CD، لایه‌های Kustomize، SQL و سیاست‌های OPA — و خطوط لوله CI پشت دروازه‌های صریح دیسپچ قرار دارند تا هیچ چیزی به طور تصادفی منتشر نشود. مستندات عمومی به صورت یک سایت داکوسوروس (docs.helixgitpx.io) در کنار یک سایت بازاریابی استرو (helixgitpx.io) عرضه می‌شوند.

حکمرانی این پروژه سخت‌گیرانه و مبتنی بر قانون اساسی است و این یک ویژگی است، نه تشریفات: سند باربر پروژه، Constitution، است که ماده دوم آن یک ماتریس تست هفت‌گانه با پوشش ۱۰۰٪ *به ازای هر نوع، به ازای هر ماژول تغییر‌یافته* را الزامی می‌کند، به طوری که استفاده از ماک‌ها تنها در تست‌های واحد مجاز بوده و حتی یک تست نادیده‌گرفته‌شده نیز تحمل نمی‌شود. یک تأییدکننده یک‌باره تمام بررسی‌های مصنوع را به همراه go vet و go test در کل فضای کاری اجرا می‌کند و هر پوش به تمام میزبان‌های بالادستی پیکربندی‌شده ارسال می‌شود — بنابراین «نسخه‌های منعکس‌شده همگام هستند» چیزی است که سیستم در هر کامیت آن را اعمال می‌کند، نه چیزی که یک انسان باید به یاد داشته باشد آن را بررسی کند.

حفظ اصالت یک مخزن در چندین میزبان گیت — به دلایلی همچون افزونگی، حاکمیت یا دسترسی به پلتفرم‌های منطقه‌ای — شکننده و دستی است و نسخه‌های واگرا سخت آشتی داده می‌شوند. HelixGitpx برای تبدیل همگام‌سازی چندبالادستی به یک قابلیت درجه‌یک و آگاه از تضاد ساخته شد.

محتوا

این سیستم وضعیت شکنندهٔ دستیِ «پوش به چندین ریموت و امیدوار باش» را به یک فدراسیون حکمرانی‌شده تبدیل می‌کند که یک منبع معتبر حقیقت واحد و مکانیزم خودکار حل تعارض مبتنی بر سیاست و AI دارد. و این کار را در گسترهٔ وسیعی از هاست‌ها انجام می‌دهد، به‌طوری‌که عمداً پلتفرم‌های منطقه‌ای (GitFlic، گیت‌ورس، گیتی) را که اکثر ابزارها بی‌صدا نادیده می‌گیرند، شامل می‌شود. بدین ترتیب، افزونگی، حاکمیت داده‌ها و دسترسی به این اکوسیستم‌ها دیگر بار نگهداری نیستند، بلکه به قابلیتی واحد تبدیل می‌شوند که تنها یک بار پیکربندی می‌شود.

گسترهٔ بالادست‌ها — بیش از یک دوجین هاست گیت، از GitHub و GitLab گرفته تا پلتفرم‌های منطقه‌ای مانند GitFlic، گیت‌ورس و گیتی، همگی پشت یک پروکسی یکپارچه شده‌اند.
حل تعارض مبتنی بر سیاست و AI — انحرافات توسط موتور سیاست و حل‌کنندهٔ AI آشتی داده می‌شوند، نه با مقایسهٔ دستی میرورها توسط انسان.
فدراسیون منبع حقیقت واحد — مدلی از پوش به همهٔ بالادست‌ها که در آن یک مخزن معتبر به‌عنوان حقیقت واحد عمل می‌کند و هر هاست به‌عنوان یک میرور همگام نگه داشته می‌شود.
آزمایش دقیق با اجرای قانون اساسی — هفت نوع آزمایش با پوشش ۱۰۰٪ برای هر نوع، که با یک اسکریپت یک‌باره و سبزرنگ تأیید می‌شود، نه بر اساس اعتماد کورکورانه.

انحراف و تعارض در میان چندین بالادست. وقتی یک مخزن در ده‌ها مکان مختلف وجود دارد، به محض اینکه دو هاست تغییرات متفاوتی را بپذیرند، دچار انحراف می‌شود. این مشکل با جریان‌های حل تعارض مبتنی بر سیاست و AI که به یک منبع حقیقت واحد متصل هستند، به‌علاوهٔ پوش همگام‌شده به همهٔ بالادست‌ها که همهٔ میرورها را به سمت آن حقیقت واحد همگرا نگه می‌دارد، حل شده است.
پشتیبانی یکپارچه از هاست‌های گیت ناهمگن. هر هاست احراز هویت، ویژگی‌ها و API خاص خود را دارد. این مشکل با اسکریپت‌های پیکربندی برای هر بالادست در پوشهٔ Upstreams/ و یک لایهٔ پلتفرم که این تفاوت‌ها را پنهان می‌کند، حل شده است، به‌طوری‌که افزودن یک هاست جدید تنها نیازمند پیکربندی است، نه بازنویسی کد.
اثبات درستی پیش از هر ادغام. این چالش با ماتریس آزمایشی هفت‌نوعه و یک دروازهٔ یک‌باره به نام verify-everything.sh که مجموعهٔ کامل آزمایش‌ها را اجرا می‌کند و در صورت عدم دسترسی به کلاستر، به‌صورت تمیز کوتاه‌مدار می‌شود، حل شده است. بدین ترتیب، درستی هم به‌صورت محلی و هم در CI قابل اثبات است.

مونو ریپوی Go — هستهٔ پروکسی و موتور فدراسیون: یک پلتفرم به‌همراه ۱۸ سرویس، تولید کد و داربست، که همگی در یک ریپو نگهداری می‌شوند تا کل موتور به‌عنوان یک واحد ساخته و آزمایش شود.
Angular 19 + Nx — برنامه تحت وب، که Nx ساختار ساخت/کش مونو ریپو را برای یک فرانت‌اند بزرگ فراهم می‌کند.
Kotlin Multiplatform + Compose — شل‌های کلاینت بومی اندروید، iOS و دسکتاپ که از یک کدبیس مشترک تولید می‌شوند، به‌طوری‌که سه پلتفرم به معنای سه پیاده‌سازی متفاوت نیستند.
Kubernetes + Helm + Argo CD + Kustomize — تحویل ابری بومی: Helm نسخهٔ انتشار را بسته‌بندی می‌کند، Kustomize با لایه‌های مختلف آن را برای هر محیط تطبیق می‌دهد و Argo CD از طریق GitOps آن را آشتی می‌دهد تا وضعیت کلاستر با گیت همخوانی داشته باشد.
OPA (Rego) — سیاست به‌عنوان کد برای حل تعارض و کنترل دسترسی، که تصمیمات مجوزدهی را اعلانی و قابل ممیزی نگه می‌دارد.
Docusaurus — سایت مستندات عمومی (docs.helixgitpx.io)؛ Astro — سایت بازاریابی (helixgitpx.io)، که هر ابزار متناسب با نوع محتوای خود انتخاب شده است.
mise — زنجیرهٔ ابزار ثابت و قابل تکرار، به‌طوری‌که هر مشارکت‌کننده و رانر CI دقیقاً با نسخه‌های یکسان می‌سازد.

محتوا

وضعیت: ارسال شده. فایل README پروژه نسخه v1.0.0 GA را با نقاط عطف m1-foundation تا m8-ga برچسب‌گذاری‌شده اعلام کرده است. («v1.0.0 GA» ادعای خود فایل README پروژه است.)
مجوز: نامشخص. گزارش‌های GitHub و API مجوز را MIT اعلام کرده‌اند، در حالی که بخش License فایل README بیان می‌دارد که کد تحت مجوز Apache-2.0 و مستندات تحت مجوز CC-BY-SA-4.0 قرار دارند — پیش از انتشار، باید با فایل LICENSE واقعی تطبیق داده شود.
پیوندهای مستندات (docs.helixgitpx.io) و بازاریابی (helixgitpx.io) مطابق با فایل README هستند و به‌طور مستقل دریافت نشده‌اند — وضعیت زنده تأییدنشده است.

اولویت: Helix-اصلی.

HelixGitpx shippedاجازه‌نامه: TBD

منبع

خلاصه

توضیح کوتاه

توضیح بلند

چرا آن را ساختیم

چرا یک تغییردهندهٔ بازی است

نوآوری‌ها

بزرگ‌ترین چالش‌های فنی و راه‌حل‌های ما

پشتهٔ فناوری

یادداشت‌های وضعیت و صداقت