Railshot

Η οθόνη web και ο προσωπικός πράκτορας ζητούν ανάπτυξη μέσω του ίδιου API του προϊόντος.

Το προϊόν από ένα αποδεκτό αίτημα ανάπτυξης, μέσω ελέγχων CI και δημοσίευσης image, ως τη ρύθμιση Git και τη διάθεση με Argo CD σε καταχωρισμένο στόχο και την επαλήθευση του δημόσιου HTTPS. Η επιτυχία καταγράφεται μόνο με εφαρμοσμένο revision και δημόσιο έλεγχο μαζί, και ένα αποτέλεσμα που δεν μπορεί να γίνει γνωστό μένει unknown.

Ένα έργο υποβάλλεται από την οθόνη web ή από έναν προσωπικό πράκτορα AI συνδεδεμένο μέσω MCP, και η πλατφόρμα προχωρά από την προετοιμασία αρχείων ανάπτυξης και την επιδιόρθωση αποτυχιών ως τη δημοσίευση image, τη διάθεση στο περιβάλλον και την επαλήθευση του δημόσιου URL. Μετά την ανάπτυξη, η ίδια οθόνη δείχνει ιστορικό και αρχεία καταγραφής και διαχειρίζεται ενημερώσεις, διακοπές, συνεχίσεις και διαγραφή. Ομαδικό έργο.

Περίοδος υλοποίησης του διαγωνισμού September 28, 2026 to October 4, 2026

Η οθόνη web και ο διακομιστής MCP που φτιάχτηκαν στο hackathon. Το απομακρυσμένο MCP συνδέεται με OAuth για την υποβολή, ενώ οι τοπικοί φάκελοι υποβάλλονται μέσω του τοπικού MCP.

Αρχιτεκτονική προϊόντος · σχεδιασμένη από τις διαδρομές κώδικα στο δημόσιο commit 645e28a

Υποβολή → αποδοχή

Η οθόνη web, το απομακρυσμένο MCP και το τοπικό MCP καλούν το ίδιο API του προϊόντος, που καταγράφει ένα ελεγμένο αίτημα ως queued και απαντά 202.

Χρήστης προγράμματος περιήγησηςδεδομένα: φάκελος · ZIP · GitHub URLοθόνη web · ιστορικό · Insightsapps/dashboard
Η πηγή και ένα καταχωρισμένο περιβάλλον επιλέγονται στην οθόνη web.
οθόνη web · ιστορικό · Insightsapps/dashboardδεδομένα: ίδιο API προϊόντος · /api/v1επικύρωση · στόχος · αποδοχή 202apps/api
Η οθόνη web καλεί το API του προϊόντος από την ίδια προέλευση.
Πελάτης MCPδεδομένα: OAuth · deploy_repositoryOAuth MCP · deploy_repositoryagent/remote-mcp.js
Το απομακρυσμένο MCP συνδέεται μέσω OAuth και δέχεται ως είσοδο ένα δημόσιο αποθετήριο GitHub.
OAuth MCP · deploy_repositoryagent/remote-mcp.jsδεδομένα: ίδιο API προϊόντοςεπικύρωση · στόχος · αποδοχή 202apps/api
Ο απομακρυσμένος διακομιστής MCP καλεί το ίδιο API ανάπτυξης μέσω του εσωτερικού του πελάτη API.
railshot-local MCPδεδομένα: Ανέβασμα ZIP · deploy_local_projectεπικύρωση · στόχος · αποδοχή 202apps/api
Το stdio MCP στον υπολογιστή του χρήστη συμπιέζει έναν φάκελο σε ZIP και τον ανεβάζει. Η συνεδρία του δεν μοιράζεται με την απομακρυσμένη συνεδρία OAuth.
επικύρωση · στόχος · αποδοχή 202apps/apiδεδομένα: καταγραφή queued · 202κατάσταση operation · σύνδεση runapi/product-store.js
Ελέγχονται η είσοδος, ο καταχωρισμένος στόχος, η χωρητικότητα και το κλειδί idempotency. Η operation καταγράφεται ως queued και η απάντηση είναι 202. Το 202 σημαίνει αποδοχή, όχι ανάπτυξη.
κατάσταση operation · σύνδεση runapi/product-store.jsδεδομένα: σειρά ουράςουρά ανάπτυξης · 3 ταυτόχροναapps/api
Λαμβάνονται με τη σειρά αποδοχής, μέσα στο όριο ταυτόχρονων αναπτύξεων (3 από προεπιλογή).
κατάσταση operation · σύνδεση runapi/product-store.jsπαρατήρηση: κατάσταση ανάπτυξης · ιστορικόοθόνη web · ιστορικό · Insightsapps/dashboard
Η οθόνη web και τα εργαλεία MCP διαβάζουν τις ίδιες καταγραφές operation. Η πιο πρόσφατη προσπάθεια και η τρέχουσα επαληθευμένη ανάπτυξη εμφανίζονται χωριστά, και μια ολοκληρωμένη εργασία AI δεν είναι επιτυχία ανάπτυξης.

Έλεγχοι CI → δημοσίευση image

Ο σταθεροποιημένος κώδικας πλατφόρμας ελέγχει το υποβληθέν commit, αναθέτει στην AI μόνο αποτυχίες που διορθώνονται και δημοσιεύει μόνο images που πέρασαν ξανά τους ίδιους ελέγχους.

ουρά ανάπτυξης · 3 ταυτόχροναapps/apiδεδομένα: source commitcommit πηγής · trailersapps/<tenant>/<app>
Η υποβληθείσα πηγή γίνεται commit στο ιδιωτικό αποθετήριο apps (με τα trailers Railshot-Request και Railshot-Target), και ο κλάδος ενημερώνεται χωρίς force.
ουρά ανάπτυξης · 3 ταυτόχροναapps/apiεκτέλεση · εφαρμογή: workflow_dispatchloop · βασικοί έλεγχοι L0–L3railshot-deploy.yml
Ζητά εκτέλεση με tenant, app, source_commit και target_id. Αν χαθεί η απάντηση, δεν στέλνεται ξανά, αλλά αναζητούνται οι εκτελέσεις για το ίδιο commit.
commit πηγής · trailersapps/<tenant>/<app>δεδομένα: υποβληθέν commitloop · βασικοί έλεγχοι L0–L3railshot-deploy.yml
Γίνεται checkout μόνο του υποβληθέντος commit και του σταθεροποιημένου κώδικα πλατφόρμας (PLATFORM_REF).
Επιδιόρθωση SDK · μόνο διορθώσιμες αποτυχίεςrailshot-deploy.ymlδεδομένα: αίτημα επιδιόρθωσης · υπό όρουςAI SDK provider
Καλείται μόνο για κατηγορίες αποτυχιών που διορθώνονται, και σταματά όταν η ίδια αποτυχία επαναλαμβάνεται ή όταν εξαντλείται το όριο προσπαθειών. Επιτυχία ή αποτυχία αποφασίζουν οι έλεγχοι, όχι το LLM.
release · δημοσίευση GHCR · σύνδεσηrailshot-deploy.ymlδεδομένα: δημοσίευση ελεγμένων imagesGHCR
Αφού επαληθευτεί το bundle που πέρασε τους ελέγχους, τα ίδια images δημοσιεύονται στο GHCR. Τίποτα δεν ξαναχτίζεται.
σύνδεση εκτέλεσης CI · παρατήρησηapps/apiπαρατήρηση: εκτέλεση · ανάγνωση δημοσίευσηςrailshot-deploy.yml
Μια δημοσίευση μετρά μόνο όταν τα run id, source commit, target και app ταιριάζουν με την αποδεκτή καταγραφή.
σύνδεση εκτέλεσης CI · παρατήρησηapps/apiαποτυχία · άγνωστο αποτέλεσμα: failed · publication_unverifiedκατάσταση operation · σύνδεση runapi/product-store.js
Μια αποτυχία CI ή μια μη επαληθευμένη δημοσίευση καταγράφεται με διαγνωστικά και δεν περνά στο CD.

Εφαρμογή → δημόσιος έλεγχος

Εφαρμόζει μέσω config Git και Argo CD μόνο όταν η δημοσίευση ταιριάζει με τον καταχωρισμένο στόχο, και καταγράφει επιτυχία μόνο αφού περάσει τον έλεγχο η καταχωρισμένη δημόσια διεύθυνση HTTPS.

release · δημοσίευση GHCR · σύνδεσηrailshot-deploy.ymlδεδομένα: images.json · spec · verdict · manifestcd.js · deployPublishedapps/api
Το CD διαβάζει τα αρχεία της καταγραφής δημοσίευσης μέσω έμπιστου loader. Το ίδιο το CI δεν δημιουργεί πόρο συστοιχίας, URL ή επιτυχία ανάπτυξης.
cd.js · deployPublishedapps/apiεκτέλεση · εφαρμογή: apply · καταχωρισμένος στόχοςέμπιστο config · καταχωρισμένος στόχοςgitops/bridge.py
Εκτελεί το gitops/bridge.py με το έμπιστο config μόνο όταν το καταχωρισμένο app και ο tenant ταιριάζουν με την καταγραφή δημοσίευσης.
commit · push · απομακρυσμένη επανανάγνωσηgitops/bridge.pyδεδομένα: workload commit · pushΑποθετήριο config Git
Κάνει commit μόνο το workload.json στην καταχωρισμένη διαδρομή ενός αποκλειστικού κλάδου, καταγράφει πρώτα την πρόθεση push, κάνει push και ξαναδιαβάζει το απομακρυσμένο revision. Ένα αβέβαιο push δεν επαναλαμβάνεται.
Αποθετήριο config Gitδεδομένα: revisionΈλεγχος Application · AppProjectArgo CD
Το revision του αποθετηρίου config στο οποίο δείχνει το Argo CD Application.
Argo sync · παρατήρησηgitops/bridge.pyεκτέλεση · εφαρμογή: sync · παρατήρησηΈλεγχος Application · AppProjectArgo CD
Ζητά sync αφού ελέγξει το AppProject. Η παρατήρηση μόνο διαβάζει, χωρίς sync.
Έλεγχος Application · AppProjectArgo CDεκτέλεση · εφαρμογή: εφαρμογήworkload · ServiceΣυστοιχία εφαρμογών K3s
Εφαρμόζει το workload στη συστοιχία του καταχωρισμένου στόχου.
workload · ServiceΣυστοιχία εφαρμογών K3sδεδομένα: image pull · digestGHCR
Τραβά το δημοσιευμένο digest. Ένα ιδιωτικό GHCR χρειάζεται αποκλειστικό διαπιστευτήριο pull.
probe δημόσιου HTTPSgitops/bridge.pyπαρατήρηση: HTTPS healthΔημόσιο HTTPS URL
Ελέγχει μόνο τη διεύθυνση HTTPS health που καταχώρισε ο χειριστής, χωρίς ανακατευθύνσεις, για 200 (και το αναμενόμενο JSON αν έχει οριστεί).
Δημόσιο HTTPS URLδεδομένα: δημόσια διαδρομήworkload · ServiceΣυστοιχία εφαρμογών K3s
Η δημόσια διαδρομή (LB, NodePort, πιστοποιητικό) διαφέρει ανά πάροχο και καταχωρισμένο στόχο.
cd.js · deployPublishedapps/apiδεδομένα: succeeded · revision · URLκατάσταση operation · σύνδεση runapi/product-store.js
Καταγράφεται ως succeeded μόνο με cd.deployed, revision, επιτυχή δημόσιο έλεγχο HTTPS, τον χρόνο του και έγκυρο URL.
cd.js · deployPublishedapps/apiαποτυχία · άγνωστο αποτέλεσμα: unknown · απαιτείται εναρμόνισηκατάσταση operation · σύνδεση runapi/product-store.js
Ένα αποτέλεσμα που δεν μπορεί να γίνει γνωστό μένει unknown, και η ίδια εφαρμογή ούτε ξαναστέλνεται ούτε αναιρείται.

Παρατήρηση · όχι ετυμηγορία

Οι μετρικές και τα probes δεν αποφασίζουν την επιτυχία της ανάπτυξης. Τιμές που λείπουν, παλιές και αποτυχημένες εμφανίζονται όπως είναι.

metrics observerapps/apiπαρατήρηση: Ερώτημα PromQLPrometheus
Διαβάζει τις σειρές up, probe_success και Pod. Τιμές που λείπουν, είναι παλιές ή απέτυχαν εμφανίζονται σε αυτή την κατάσταση και ποτέ δεν μετατρέπονται σε 0.
Prometheusπαρατήρηση: scrape · probeworkload · ServiceΣυστοιχία εφαρμογών K3s
Scrape exporter και HTTP probe. Αυτές οι μετρικές δεν χρησιμοποιούνται για να κριθεί η επιτυχία της ανάπτυξης.
κατάσταση operation · σύνδεση runapi/product-store.jsπαρατήρηση: κατάσταση ανάπτυξης · ιστορικόοθόνη web · ιστορικό · Insightsapps/dashboard
Η οθόνη web και τα εργαλεία MCP διαβάζουν τις ίδιες καταγραφές operation. Η πιο πρόσφατη προσπάθεια και η τρέχουσα επαληθευμένη ανάπτυξη εμφανίζονται χωριστά, και μια ολοκληρωμένη εργασία AI δεν είναι επιτυχία ανάπτυξης.
probe δημόσιου HTTPSgitops/bridge.pyπαρατήρηση: HTTPS healthΔημόσιο HTTPS URL
Ελέγχει μόνο τη διεύθυνση HTTPS health που καταχώρισε ο χειριστής, χωρίς ανακατευθύνσεις, για 200 (και το αναμενόμενο JSON αν έχει οριστεί).

Κάθε σύνδεση με το ίδιο πάχος. Επιλέξτε μια ροή για να επισημανθεί μόνο η διαδρομή της, με αριθμημένα βήματα.

Συνεχής · η κατεύθυνση ροής πηγής, images και αιτημάτων
Διακεκομμένη · αίτημα εκτέλεσης, εφαρμογή ή sync
Μακριά παύλα-τελεία · αναγνώσεις κατάστασης, probes και μετρικές, χωριστά από την ετυμηγορία
Κοντή παύλα · καταγεγραμμένη αποτυχία ή unknown αποτέλεσμα
Παχιά μαύρη γραμμή · η επιλεγμένη ροή, οι αριθμοί δίνουν τη σειρά
Κουτί · όριο ιδιοκτησίας, με τη διαδρομή πηγής στην κεφαλίδα
Εσωτερικό τσιπ · στοιχείο μέσα σε αυτό το όριο
Διακεκομμένο κουτί · εκτός της πλατφόρμας
Πορτοκαλί περίγραμμα · σημείο όπου αποφασίζει ένα μοντέλο

API προϊόντος
Καταγραφές ανάπτυξης
Όριο εκτέλεσης CD
Είσοδος · CI · στόχος

Η εικόνα της October 2 (bc61a5a) στο docs/architecture/README.md είναι ιστορικό υλοποίησης, ενώ αυτή η αρχιτεκτονική ακολουθεί τον κώδικα του 645e28a. Οι πάροχοι και οι διαδρομές δικτύου διαφέρουν ανά καταχωρισμένο στόχο, και αυτό δεν σημαίνει ότι κάθε πάροχος είναι πάντα ενεργός.

Railshot vocabulary

Υποβολή → αποδοχή

Έλεγχοι CI → δημοσίευση image

Εφαρμογή → δημόσιος έλεγχος

Παρατήρηση · όχι ετυμηγορία