Skip to content

docs: correct backend/ claims — ci.forkhorizon.com is the real production backend#80

Merged
Daliys merged 1 commit into
developfrom
docs/readme-backend-reality
Jul 25, 2026
Merged

docs: correct backend/ claims — ci.forkhorizon.com is the real production backend#80
Daliys merged 1 commit into
developfrom
docs/readme-backend-reality

Conversation

@Daliys

@Daliys Daliys commented Jul 25, 2026

Copy link
Copy Markdown
Member

Why

README called backend/ (a standalone Python/FastAPI GitHub-App-webhook receiver in this repo) "the production path." I verified that's not true:

  • ci.forkhorizon.com resolves to the production VPS; nginx proxies it (with the other 3 private dashboards) to a single Node process — that's ForkHorizon/WebSite's src/products/ci-scope/backend.ts, not anything in this repo.
  • That backend already has real production features per WebSite's own project memory: infra-vs-test failure classification and auto-rerun of infra failures.
  • The broker's actual Server-mode wire calls (CIQueueSettingsStore.swift, LocalBrokerLaunchAgent.swift) hit /api/ci/local/heartbeat — a WebSite ci-scope route, not this repo's backend/ (which exposes /github/webhook instead, a different, incompatible shape).
  • backend/'s own internal README still has the placeholder domain your-backend.example.com everywhere, and there's no nginx route to it anywhere on the production VPS.

What changed

  • Job Notifications now correctly points Server-mode config (CI_SCOPE_BACKEND_URL) at https://ci.forkhorizon.com.
  • Added an explicit callout that backend/ is a separate, earlier, undeployed prototype — not a second production path — until it's either wired up for real or removed.

This doesn't touch backend/ itself, just the docs claiming it's live. Whether to delete/revive backend/ is a separate decision.

Left as a draft — not merging myself, surfacing for review.

…tion backend

Verified conclusively: ci.forkhorizon.com resolves to the production VPS
and nginx proxies it (with the 3 other private dashboards) to the single
Node process from ForkHorizon/WebSite's src/products/ci-scope/backend.ts.
That backend already implements infra-vs-test failure classification and
auto-rerun (per WebSite's own project memory). It also matches the
broker's actual wire protocol: CIQueueSettingsStore.swift and
LocalBrokerLaunchAgent.swift call /api/ci/local/heartbeat, which is a
WebSite ci-scope route, not anything in this repo's backend/.

The Python backend/ folder here implements a different, incompatible
protocol (/github/webhook, its own SQLite store) and was never deployed
— its own README still has the your-backend.example.com placeholder
everywhere, and there is no nginx route to it on the production VPS.
README previously called this folder 'the production path', which was
wrong. Reframed as a parked prototype and pointed Server mode config at
the real production backend.
@Daliys
Daliys marked this pull request as ready for review July 25, 2026 18:58
@Daliys
Daliys merged commit c2ce519 into develop Jul 25, 2026
4 checks passed
@Daliys
Daliys deleted the docs/readme-backend-reality branch July 25, 2026 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant