AR
RAILSHOT.
العودة إلى القاعة

Railshot

AI deployment & operations platform

نشر تطبيق ويب مبني محليًا على بيئات سحابية ومحلية مُعدّة، ثم تشغيله.

منصة نشر وتشغيل بالذكاء الاصطناعي تنقل تطبيق ويب مبنيًا محليًا إلى بيئات سحابية أو محلية مُعدّة وتواصل تشغيله.

2026.09.28 — 2026.10.04 · مكتمل

مشروع جماعي · دوري: تخطيط CI وتطبيقه، وعناقيد CSP وواجهة Ansible، والتشغيل، ومراجعة شيفرة الفريق والتكامل

SoftBank Hackathon 2026 powered by KOREC & Progateمشارك في التصفيات · يُعلن اختيار النهائيات في 2026.10.26 (حتى 2026.10.07)

  • الويبمُطبَّق · هاكاثون
  • خادم MCPمُطبَّق · بعيد · محلي

تطلب شاشة الويب والوكيل الخاص النشرَ عبر API المنتج نفسه.

المنتج من طلب نشر مقبول، مرورًا بفحوص CI ونشر الصورة، وصولًا إلى إعداد Git وطرح Argo CD على هدف مسجّل والتحقق من HTTPS العام. ولا يُسجَّل النجاح إلا بوجود revision مطبّقة وفحص عام معًا، والنتيجة التي يتعذر معرفتها تبقى unknown.

يُقدَّم المشروع من شاشة الويب أو من وكيل ذكاء اصطناعي خاص متصل عبر MCP، فتمضي المنصة عبر تحضير ملفات النشر، وإصلاح الإخفاقات، ونشر الصورة، والطرح في البيئة، والتحقق من عنوان URL العام، وبعد النشر تعرض الشاشة نفسها تاريخ النشر والسجلات وتدير التحديثات والإيقاف والاستئناف والحذف. مشروع جماعي.

فترة التطوير في المسابقة September 28, 2026 to October 4, 2026

شاشة الويب وخادم MCP المبنيان خلال الهاكاثون. يسجّل MCP البعيد الدخول عبر OAuth للإرسال، وتُرسل المجلدات المحلية عبر MCP المحلي.

بنية المنتج · مرسومة من مسارات الشيفرة عند الإيداع العام 645e28a
بنية منتج Railshotمكونات منتج Railshot وصلاته. تطلب شاشة الويب وOAuth MCP البعيد وMCP المحلي على حاسوب المستخدم النشرَ عبر API المنتج نفسه، الذي يسجّل إيداع المصدر وتشغيل CI. ويحسم CI بفحوص ثابتة وينشر الصور المفحوصة إلى GHCR. ولا يطبّق محوّل CD عبر config Git وArgo CD إلا حين يطابق الهدف المسجّل سجل النشر، ثم يفحص عنوان HTTPS العام المسجّل ويسجّل النتيجة. والمقاييس ملاحظة منفصلة عن الحكم.مستخدم المتصفحمجلد · ZIP · GitHub URLعميل MCPChatGPT · Codex · Clauderailshot-local MCPحاسوب المستخدم · stdioGHCRصور بحسب digestAI SDK providerCodex · Claude SDKمستودع Git للإعدادworkload.json المسجّلعنوان HTTPS URL العاممسار health المسجّلPrometheusVM التحكم في التشغيل · قراءةapps/dashboardشاشة الويب · السجل · Insightsagent/remote-mcp.jsOAuth MCP · deploy_repositoryapps/apiالتحقق · الهدف · قبول 202طابور النشر · 3 في وقت واحدربط تشغيل CI · مراقبةcd.js · deployPublishedmetrics observerapi/product-store.jsحالة operation · ربط rungitops/bridge.pyconfig موثوق · هدف مسجّلcommit · push · قراءة بعيدة للتحققArgo sync · مراقبةprobe لـ HTTPS العامArgo CDفحص Application · AppProjectapps/<tenant>/<app>إيداع المصدر · trailersrailshot-deploy.ymlloop · الفحوص الأساسية L0–L3إصلاح SDK · الإخفاقات القابلة للإصلاح فقطالفحوص نفسها → bundle مُختبَرrelease · النشر إلى GHCR · الربطعنقود تطبيقات K3sworkload · Serviceمنصة Railshotعنقود التشغيل · AWSGitHubمستودع apps خاص · Actionsالهدف المسجّلمسار عام لكل مزوّد1 مجلد · ZIP · GitHub URL · مستخدم المتصفح → شاشة الويب · السجل · Insights12API المنتج نفسه · /api/v13 OAuth · deploy_repository · عميل MCP → OAuth MCP · deploy_repository34API المنتج نفسه5 رفع ZIP · deploy_local_project · railshot-local MCP → التحقق · الهدف · قبول 20256 سُجّل queued · 202 · التحقق · الهدف · قبول 202 → حالة operation · ربط run67 ترتيب الطابور · حالة operation · ربط run → طابور النشر · 3 في وقت واحد78حالة النشر · السجل1source commit2workflow_dispatch3الإيداع المُرسَل4طلب إصلاح · مشروط5نشر الصور المفحوصة6التشغيل · قراءة النشر7 failed · publication_unverified · ربط تشغيل CI · مراقبة → حالة operation · ربط run71images.json · spec · verdict · manifest2تطبيق · هدف مسجّل3workload commit · push4revision5sync · مراقبة6تطبيق7سحب الصورة · digest8HTTPS health9 المسار العام · عنوان HTTPS URL العام → workload · Service910 succeeded · revision · URL · cd.js · deployPublished → حالة operation · ربط run1011 unknown · يحتاج إلى مطابقة · cd.js · deployPublished → حالة operation · ربط run111استعلام PromQL2scrape · probe3حالة النشر · السجل4HTTPS health

الإرسال → القبول

تستدعي شاشة الويب وMCP البعيد وMCP المحلي API المنتج نفسه، الذي يسجّل الطلب المفحوص بوصفه queued ويجيب بـ 202.

  1. مستخدم المتصفحمجلد · ZIP · GitHub URLشاشة الويب · السجل · Insightsapps/dashboard

    يُختار المصدر وبيئة مسجّلة على شاشة الويب.

  2. شاشة الويب · السجل · Insightsapps/dashboardAPI المنتج نفسه · /api/v1التحقق · الهدف · قبول 202apps/api

    تستدعي شاشة الويب API المنتج من الأصل نفسه.

  3. عميل MCPOAuth · deploy_repositoryOAuth MCP · deploy_repositoryagent/remote-mcp.js

    يتصل MCP البعيد عبر OAuth ويأخذ مستودع GitHub عامًا مُدخلًا.

  4. OAuth MCP · deploy_repositoryagent/remote-mcp.jsAPI المنتج نفسهالتحقق · الهدف · قبول 202apps/api

    يستدعي خادم MCP البعيد API النشر نفسه عبر عميل API الداخلي الخاص به.

  5. railshot-local MCPرفع ZIP · deploy_local_projectالتحقق · الهدف · قبول 202apps/api

    يضغط stdio MCP على حاسوب المستخدم مجلدًا في ZIP ويرفعه. ولا تُشارك جلسته مع جلسة OAuth البعيدة.

  6. التحقق · الهدف · قبول 202apps/apiسُجّل queued · 202حالة operation · ربط runapi/product-store.js

    تُفحص المُدخلات والهدف المسجّل والسعة ومفتاح idempotency، وتُسجَّل operation بوصفها queued ويُجاب بـ 202. و202 يعني القبول، لا النشر.

  7. حالة operation · ربط runapi/product-store.jsترتيب الطابورطابور النشر · 3 في وقت واحدapps/api

    تُؤخذ بترتيب القبول، ضمن حد النشر المتزامن (3 افتراضيًا).

  8. حالة operation · ربط runapi/product-store.jsحالة النشر · السجلشاشة الويب · السجل · Insightsapps/dashboard

    تقرأ شاشة الويب وأدوات MCP سجلات operation نفسها. وتُعرض أحدث محاولة والنشر المُتحقَّق منه الحالي كلٌّ على حدة، واكتمال مهمة الذكاء الاصطناعي ليس نجاحًا للنشر.

فحوص CI → نشر الصورة

تفحص شيفرة المنصة المثبّتة الإيداعَ المُرسَل، ولا تُسلّم إلى الذكاء الاصطناعي إلا الإخفاقات القابلة للإصلاح، ولا تنشر إلا الصور التي اجتازت الفحوص نفسها مجددًا.

  1. طابور النشر · 3 في وقت واحدapps/apisource commitإيداع المصدر · trailersapps/<tenant>/<app>

    يصبح المصدر المُرسَل إيداعًا في مستودع apps الخاص (مع Railshot-Request وRailshot-Target بوصفهما trailers)، ويُحدَّث الفرع دون force.

  2. طابور النشر · 3 في وقت واحدapps/apiworkflow_dispatchloop · الفحوص الأساسية L0–L3railshot-deploy.yml

    يطلب تشغيلًا بـ tenant وapp وsource_commit وtarget_id. وإن فُقدت الاستجابة لا يُعاد الإرسال، بل يُبحث عن تشغيلات الإيداع نفسه.

  3. إيداع المصدر · trailersapps/<tenant>/<app>الإيداع المُرسَلloop · الفحوص الأساسية L0–L3railshot-deploy.yml

    لا يُجلب في checkout إلا الإيداع المُرسَل وشيفرة المنصة المثبّتة (PLATFORM_REF).

  4. إصلاح SDK · الإخفاقات القابلة للإصلاح فقطrailshot-deploy.ymlطلب إصلاح · مشروطAI SDK provider

    لا يُستدعى إلا لفئات الإخفاق القابلة للإصلاح، ويتوقف حين يتكرر الإخفاق نفسه أو يُبلغ حد المحاولات. والفحوص هي التي تحسم النجاح أو الإخفاق، لا LLM.

  5. release · النشر إلى GHCR · الربطrailshot-deploy.ymlنشر الصور المفحوصةGHCR

    بعد التحقق من bundle الذي اجتاز الفحوص، تُنشر الصور نفسها إلى GHCR. ولا يُعاد بناء أي شيء.

  6. ربط تشغيل CI · مراقبةapps/apiالتشغيل · قراءة النشرrailshot-deploy.yml

    لا يُحتسب النشر إلا حين يطابق run id وsource commit وtarget وapp السجلَّ المقبول.

  7. ربط تشغيل CI · مراقبةapps/apifailed · publication_unverifiedحالة operation · ربط runapi/product-store.js

    يُسجَّل إخفاق CI أو النشر غير المُتحقَّق منه مع تشخيصات، ولا يُمرَّر إلى CD.

التطبيق → الفحص العام

لا يطبّق عبر config Git وArgo CD إلا حين يطابق النشرُ الهدفَ المسجّل، ولا يسجّل النجاح إلا بعد اجتياز عنوان HTTPS العام المسجّل للفحص.

  1. release · النشر إلى GHCR · الربطrailshot-deploy.ymlimages.json · spec · verdict · manifestcd.js · deployPublishedapps/api

    يقرأ CD ملفات سجل النشر عبر loader موثوق. ولا ينشئ CI بنفسه أي مورد عنقود أو URL أو نجاح نشر.

  2. cd.js · deployPublishedapps/apiتطبيق · هدف مسجّلconfig موثوق · هدف مسجّلgitops/bridge.py

    لا يشغّل gitops/bridge.py بالـ config الموثوق إلا حين يطابق app وtenant المسجّلان سجل النشر.

  3. commit · push · قراءة بعيدة للتحققgitops/bridge.pyworkload commit · pushمستودع Git للإعداد

    لا يودِع إلا workload.json في المسار المسجّل لفرع مخصص، ويسجّل نية push أولًا، ثم ينفّذ push ويعيد قراءة revision البعيدة للتحقق. ولا يُكرَّر push غير المؤكد.

  4. مستودع Git للإعدادrevisionفحص Application · AppProjectArgo CD

    revision مستودع config التي يشير إليها Argo CD Application.

  5. Argo sync · مراقبةgitops/bridge.pysync · مراقبةفحص Application · AppProjectArgo CD

    يطلب sync بعد فحص AppProject، أما المراقبة فقراءة فقط، دون sync.

  6. فحص Application · AppProjectArgo CDتطبيقworkload · Serviceعنقود تطبيقات K3s

    يطبّق workload على عنقود الهدف المسجّل.

  7. workload · Serviceعنقود تطبيقات K3sسحب الصورة · digestGHCR

    يسحب الـ digest المنشور. ويحتاج GHCR الخاص إلى بيانات اعتماد pull مخصصة.

  8. probe لـ HTTPS العامgitops/bridge.pyHTTPS healthعنوان HTTPS URL العام

    لا يفحص إلا عنوان HTTPS health الذي سجّله المشغّل، دون إعادة توجيه، بحثًا عن 200 (وعن JSON المتوقع إن حُدّد).

  9. عنوان HTTPS URL العامالمسار العامworkload · Serviceعنقود تطبيقات K3s

    يختلف المسار العام (LB وNodePort والشهادة) حسب المزوّد والهدف المسجّل.

  10. cd.js · deployPublishedapps/apisucceeded · revision · URLحالة operation · ربط runapi/product-store.js

    لا يُسجَّل بوصفه succeeded إلا مع cd.deployed، وrevision، وفحص HTTPS عام ناجح، ووقته، وURL صالح.

  11. cd.js · deployPublishedapps/apiunknown · يحتاج إلى مطابقةحالة operation · ربط runapi/product-store.js

    النتيجة التي يتعذر معرفتها تبقى unknown، ولا يُعاد إرسال التطبيق نفسه ولا يُتراجع عنه.

ملاحظة · ليست الحكم

لا تحسم المقاييس وprobes نجاح النشر. وتُعرض القيم المفقودة والقديمة والفاشلة كما هي.

  1. metrics observerapps/apiاستعلام PromQLPrometheus

    يقرأ سلاسل up وprobe_success وPod. وتُعرض القيم المفقودة أو القديمة أو الفاشلة على حالها، ولا تُحوَّل إلى 0 أبدًا.

  2. Prometheusscrape · probeworkload · Serviceعنقود تطبيقات K3s

    scrape من exporter وHTTP probe. ولا تُستخدم هذه المقاييس لحسم نجاح النشر.

  3. حالة operation · ربط runapi/product-store.jsحالة النشر · السجلشاشة الويب · السجل · Insightsapps/dashboard

    تقرأ شاشة الويب وأدوات MCP سجلات operation نفسها. وتُعرض أحدث محاولة والنشر المُتحقَّق منه الحالي كلٌّ على حدة، واكتمال مهمة الذكاء الاصطناعي ليس نجاحًا للنشر.

  4. probe لـ HTTPS العامgitops/bridge.pyHTTPS healthعنوان HTTPS URL العام

    لا يفحص إلا عنوان HTTPS health الذي سجّله المشغّل، دون إعادة توجيه، بحثًا عن 200 (وعن JSON المتوقع إن حُدّد).

كل الروابط بالسماكة نفسها. اختر مسارًا لإبراز طريقه وحده، مع خطوات مرقّمة.

  • خط متصل · اتجاه تدفق المصدر والصور والطلبات
  • خط متقطع · طلب تشغيل أو تطبيق أو sync
  • شرطة طويلة ونقطة · قراءات الحالة وprobes والمقاييس، بمعزل عن الحكم
  • شرطة قصيرة · إخفاق مسجّل أو نتيجة unknown
  • خط أسود سميك · المسار المختار، والأرقام تبيّن الترتيب
  • مربع · حدّ مالك، ومسار مصدره في الترويسة
  • شريحة داخلية · مكوّن داخل ذلك الحد
  • مربع متقطع · خارج المنصة
  • إطار برتقالي · حيث يقرر نموذج
  • API المنتج
  • سجلات النشر
  • حدود تنفيذ CD
  • الدخول · CI · الهدف

صورة October 2 (bc61a5a) في docs/architecture/README.md تاريخ تطبيق، وهذه البنية تتبع شيفرة 645e28a. وتختلف المزوّدات ومسارات الشبكة حسب الهدف المسجّل، ولا يعني هذا أن كل مزوّد يعمل دائمًا.