Skip to content

Dev portal 1/4: mirror open GitHub issues/PRs into a /dev backlog console#231

Open
dmccoystephenson wants to merge 1 commit into
mainfrom
feature/dev-backlog-sync
Open

Dev portal 1/4: mirror open GitHub issues/PRs into a /dev backlog console#231
dmccoystephenson wants to merge 1 commit into
mainfrom
feature/dev-backlog-sync

Conversation

@dmccoystephenson

Copy link
Copy Markdown
Member

Summary

First phase of the developer-portal plan (see the backlog-console pitch): a read-only mirror of every open GitHub issue/PR across the Dans-Plugins org, so the state of the ecosystem is a glance instead of a dozen tabs.

  • GitHubClient — calls the GitHub Search API for open issues/PRs in the org (works unauthenticated at a lower rate limit; set DPC_BACKLOG_GITHUB_TOKEN to raise it — no scopes needed, it's public data).
  • BacklogSyncService — scheduled sync (dpc.backlog.sync-interval-ms, default 15 min) upserts into a new backlog_items table. GitHub stays the system of record: an item not seen in a sync flips to CLOSED rather than being deleted.
  • GET /api/v1/backlog / /api/v1/backlog/summary — public read endpoints (the data's already public on GitHub).
  • /dev — new page: a per-repo rollup (issues, PRs/drafts, oldest open item, a signal chip) plus a filterable flat list of open items.

Why

Right now checking the backlog across ~17 active repos means opening that many tabs. This makes it one page, and is the foundation the next three PRs in this stack build on (splash chooser + "interested" voting, self-claim, feature-request intake).

Test plan

  • ./mvnw test — 129 tests, 0 failures (FlywayMigrationTest skips without Docker, as it does today on main)
  • npm run lint — clean
  • npm test — 81 tests, 0 failures
  • npm run build — compiles, /dev renders at 4.88 kB
  • Not verified: the scheduled sync's behavior against a real GitHub API response in a running instance (sandbox has no outbound network for a live check) — the parsing logic is covered by BacklogSyncServiceTest against realistic fixture payloads instead.

🤖 Generated with Claude Code

…onsole

Adds a scheduled sync (GitHubClient + BacklogSyncService) that mirrors open
issues and PRs across the Dans-Plugins org into a backlog_items table, plus a
public read API (GET /api/v1/backlog, /api/v1/backlog/summary) and a new /dev
page rendering it as a per-repo rollup and a filterable item list.

GitHub stays the system of record: a row flips to CLOSED (never deleted) once
a sync no longer sees it in the open set, so the console can't drift out of
sync with reality.

First phase of the dev-portal plan — read-only foundation that later phases
(splash chooser, "interested" voting, self-claim, feature intake) build on.
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